Audio Messaging allows a consumer to record, preview, and send audio messages to agents.

1. Contact your Account Team to activate the feature on the LivePerson server side.

2. Add the required Android permissions to access the microphone:

   <uses-permission android:name="android.permission.RECORD_AUDIO" /> //to record audio
   

   For SDKs previous to 5.20.1:

   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> //to save voice files to internal storage
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> // to read voice files stored in internal storage
   

3. Enable the feature:

   <bool name="enable_voice_sharing"/>
   

   By default, the value is false (disabled).

4. Define the max length of an audio message:

   <integer name="lp_record_max_time_seconds"/>
   

   The values are in seconds.

   The minimum value is 15 seconds; the maximum and the default value is 120 seconds.

5. Define the max number of audio messages saved on the device:

   <integer name="max_number_stored_voice_files"/>
   

   The default value is 20.

6. Modify and localize the following strings:

   • Short tap tooltip

     Presented when the consumer used a short tap instead of a long tap.

     Key: lp_mic_tooltip_long_press - default value: Long tap to record

   • Release microphone tooltip

     Presented when the consumer doesn't release the microphone icon.

     Key: lp_mic_tooltip_release - default value: Release for recording

   • Maximum length reached tooltip

     Presented when the message length reached to the maximum length.

     Key: lp_mic_tooltip_max_recording - default value: Recording limit has been reached, click to send

   • Accessibility Strings

     Spoken aloud by the device when the user has TalkBack or similar accessibility tools enabled, when the user touches one of the four recording control buttons.

     Record Button Key: lp_accessibility_mic_button - default value Record voice clip

     Play Back Recording Key: lp_accessibility_voice_replay_button - default value Replay voice clip

     Stop Recording Key: lp_accessibility_voice_stop_button - default value Stop recording

     Delete Recording Key: lp_accessibility_voice_trash_button - default value Delete voice clip