Client Settings
Default client settings are preselected based on ESChat customers' most common needs. There are many options for customization that affect call behavior. If "Display on Phone" is not selected, then the setting chosen in the portal will be accurate as the user cannot see the feature to adjust manually. Otherwise, some settings that are available on the device's settings menu will override settings that are set in the portal.
Not all settings shown apply equally to Android, iOS, D-pad devices, and the PC Client. To edit client settings for a user, view that user and choose Settings. Select the Edit Client Settings feature key.
The resulting pop up window displays as a series of tabs representing different categories of call settings. The images below reflect the default settings for reference. On the left side, you see the settings. On the right, where appropriate, the choice to display or not in the settings within the app.
Call Settings
| Call Setting | Description | Default | Compatibility |
| Whole Screen as PTT | Permits the entire screen to be used as the PTT button | Off | Android/iOS |
| Start Call with Speaker | Disable this setting to have call audio sent to an earpiece rather than the phone speaker. | On | All devices |
| Use Surveillance Call Mode | Dims the screen brightness during a surveillance call. | Off | Android/iOS |
| Default Callee | Selects a default user or group to call without an initial need to select before initiating a call. | None | All devices |
| Get Satellite Ready for PTT | When this is selected, if the user presses the PTT button and the satellite channel is not currently ready, it shall perform the steps to make the satellite channel ready. Not appropriate for most customers. | Off | Not appropriate for most customers |
| Dwell Timer | The time a user remains available to respond to a talk burst from a channel other than the selected TX channel. This only applies when the device is in Channel Mode. | 0 seconds | Android/iOS |
| Satellite Priming Timeout | If the satellite priming timeout timer expires, cease sending the UDP sending packets and issue the ready indication. Not appropriate for most customers. | 15 seconds | Not appropriate for most customers |
| Send Idle Pings Timeout | Not applicable for most customers. | 60 seconds | Not applicable for most customers. |
Integration Settings
| Integration Setting | Description | Default |
Compatibility |
| Allow Bluetooth | Permits the use of Bluetooth audio within ESChat. | Off | All devices |
| Bluetooth Always On | Keeps the audio connection to a paired device active. Has an impact on battery life of the bluetooth device and the phone. Becomes available when Allow Bluetooth is switched on, | Off | All devices |
| Activate DnD in Silent Mode | When device is placed on silent mode, the app turns on DnD. | Off | All devices |
| Activate DnD in Vibrate Mode | When device is placed on Vibrate mode, the app turns on DnD. Android only. | Off | All devices |
| Disable Onscreen PTT | Removes the onscreen PTT button. | Off | Android/iOS |
| Call Priority | How ESChat handles simultaneous PTT and cell phone calls. See box below. | Current | Android/iOS |
| Display Name | Chooses the manner of display of names in the contact list. Android only. | Username | Android |
| Configure App Switcher | Configures another app to launch from the ESChat tab bar. Android only. | Off | Android |
| Allowed Screen Orientations | Chooses portrait or landscape orientation of portrait or landscape. Android only. | Portrait | Android |
| Lock Screen Split Slider | Prevents resizing of the left and right views in Landscape mode. Android only. | On | Android |
| Block PTT Start in Background | Prevents inadvertent PTT calls when app is in background. | Off | All devices |
Call Priority
| Call Priority Setting | Description | Compatibility |
| None | Does not prioritize. | All devices |
| PTT | Sends a cellular (voice) call straight to voice mail if it comes in when a PTT call is in progress. | Android/iOS |
| Voice | Ends a PTT call if a cellular (voice) call comes in. | Android/iOS |
| Current | First come, first served basis. | Android/iOS |
Speaker
| Speaker Setting | Description | Default | Compatibility |
| Min Call Start Volume | Starts a PTT call with at least this minimum volume level. Represented as a percentage of the main audio stream. | 25 | All devices |
| Mic Source | Choose between Default Mic (a user may speak from further away from the microphone, and all background noise may be picked up) and Voice Communication (a user must speak 1-2 inches from the microphone). | Default mic | Sonim devices only |
| Ring on Incoming Call | Plays a ringtone upon an incoming PTT call. | Off | All devices |
| Vibrate on Incoming Call | Device vibrates upon an incoming PTT call. | Off | All devices |
| Tone Gain | The gain of the tone with respect to the audio volume. | 100 | All devices |
| Play Grant Tone | Plays a notification when user is granted the floor. | On | All devices |
| Vibrate on Grant | Vibrates when user is granted the floor | On | All devices |
| Play Floor Taken Tone | Plays a notification when another user takes the floor. | Off | All devices |
| Play Floor Idle Tone | Plays a notification when floor goes idle. | Off | All devices |
| Play Floor Denied Tone | Plays a notification when attempt to take floor fails | On | All devices |
| Play Floor Revoked Tone | Plays a notification when another user takes over the floor. | On | All devices |
| Play Call Lost Tone | Plays a notification when a call is dropped. | On | All devices |
| Ring Gain | The percentage of the main volume of the audio stream that increases. | 100 | All devices |
| Play Busy Bonk | Plays a notification when a call fails to connect. | On | All devices |
| Play Channel Sounds | Plays a notification for channels. | On | All devices |
| Volume Boost | In tenths of a dB, boosts the volume of all audio | 0 | All devices |
| Play Satellite Ready Tone | Not applicable for most customers. Plays a a not ready tone if the satellite channel is not ready after performing the procedure. | On | Not applicable for most customers |
| Play Interrupt Tone | Plays a tone when the PTT call is interrupted. | On | All devices |
Notifications
| Notifications Setting | Description | Default | Compatibility |
| Alert Call Ring Duration | The duration, in seconds, for ring attempts for incoming PTT and Alert calls. | 30 | All devices |
| Endless Alert on Missed Call | Plays a periodic audible alert until user dismisses it. | Off | All devices |
| Foreground App on Missed Call | Missed PTT call brings application to foreground. Android, PC Client only. | On | Android/PC Client |
| Notify All Missed Calls | This option needs to be adjusted in the device notification setting. The default setting is to show all notifications. | On | Android/iOS |
Headset
| Headset Call Settings | Description | Default | Compatibility |
| Headset Type | Selects the type of headset connection. | None | All devices |
| Wake Display at Call Start | Unlocks and wakes the display at the start of a PTT call. Android only. | On | Android/iOS |
| Minimum Call Start Volume | Starts PTT calls with this volume. | 25 | All devices |
| Ring on Incoming Call | Plays a ringtone on an incoming PTT call. | Off | All devices |
| Vibrate on Incoming Call | Vibrates on an incoming PTT call. | Off | All devices |
| Tone Gain | The gain of the tones with respect to the audio volume. | 50 | All devices |
| Play Grant Tone | Plays a notification tone when a user is granted the floor. | On | All devices |
| Vibrate on Grant | Vibrates when a user is granted the floor. Android Only. | On | Android |
| Play Floor Taken Tone | Plays a notification tone when the user is granted the floor. | Off | All devices |
| Play Floor Idle Tone | Plays a notification tone when the floor goes idle. | Off | All devices |
| Play Floor Denied Tone | Plays a notification tone when attempts to take the floor fail. | On | All devices |
| Play Floor Revoked Tone | Plays a notification tone when the user loses the floor to someone else. | On | All devices |
| Play Call Lost Tone | Plays a notification tone when a PTT call is dropped. | On | All devices |
| Ring Gain | The gain of the ringtone relative to the main audio stream. | 100 | All devices |
| Play Busy Bonk | Plays a notification tone when a PTT call fails to connect. | On | All devices |
| Play Channel Sounds | Plays channel sounds. | On | All devices |
| Volume Boost | Boosts the volume of all audio. | Off | All devices |
| Play Satellite Ready Tone | Not applicable for most customers. Plays a a not ready tone if the satellite channel is not ready after performing the procedure. | On | Not applicable for most customers |
| Play Interrupt Tone | Plays a tone when a PTT call is interrupted. | On | All devices |
Emergency
Configure an Emergency group and further customize the call behaviors for the call, initiators and receivers.
| Emergency Call Setting | Description | Default | Compatibility |
| Emergency Group | Assigns a configured group to be the designated Emergency Call. | None | All devices |
| Start Hold Time | The time, in ms, that a user must press and hold the Emergency Call button to initiate an Emergency Call state. | 3000 | All devices |
| Cancel Hold Time | The time, in ms, that a user must press and hold the Emergency Call button to deescalate an Emergency Call. | 3000 | All devices |
| Initiate Call | Permits a user to initiate an Emergency Call. Leave as default. | On | All devices |
Emergency Call Setting: Initiator
These settings customize the settings for users who initiate any Emergency PTT calls once a group or channel has been designated an Emergency Group under the Call tab shown above.
| Emergency Call Initiator Settings | Description | Default | Compatibility |
| Minimum Call Start Volume | Starts the Emergency PTT call with this volume. | 25 | All devices |
| Ring on Incoming Call | Plays a ringtone for the incoming Emergency PTT call. | On | All devices |
| Vibrate on Incoming Call | Vibrates on the incoming Emergency PTT call. | Off | All devices |
| Tone Gain | The gain of the tones with respect to the audio volume. | 50 | All devices |
| Play Grant Tone | Plays a notification tone when a user is granted the floor during the Emergency PTT call. | On | All devices |
| Vibrate On Grant | Vibrates when a user is granted the floor during an Emergency PTT call. Android only. | On | Android |
| Play Floor Taken Tone | Plays a notification when the user is granted the floor during the Emergency PTT call. | Off | All devices |
| Play Floor Idle Tone | Plays a notification when the floor goes idle. | Off | All devices |
| Play Floor Denied Tone | Plays a notification tone when attempts to take the floor during the Emergency PTT call fail. | On | All devices |
| Play Floor Revoked Tone | Plays a notification tone when the user loses the floor to someone else during the Emergency PTT call. | On | All Devices |
| Play Call Lost Tone | Plays a notification tone when an Emergency PTT call is dropped. | On | All devices |
| Ring Gain | The gain of the ringtone relative to the main audio stream during the Emergency PTT call. | 100 | All devices |
| Play Busy Bonk | Plays a notification tone when the Emergency PTT call fails to connect. | On | All devices |
| Visual Indicator | The UI element that will decorate Emergency PTT calls (choose between none, status bar, and screen). | Status Bar | Android/iOS |
| Flash Indicator | Whether or not the indicator should flash during Emergency PTT calls. | On | Android/iOS |
| Blink LED | Whether or not the device's status LED should blink during Emergency PTT calls. | On | All devices |
| Blank Screen | Whether or not the device screen should be blank during Emergency PTT calls. | Off | |
| Play Channel Sounds | Plays channel sounds. | On | All devices |
| Volume Boost | Boosts the volume of all audio during the Emergency PTT call. | 0 | All devices |
| Play Satellite Ready Tone | Not applicable for most customers. Plays a not ready tone if the satellite channel is not ready after initiating the call. | On | Not applicable for most customers |
| Play Interrupt Tone | Plays a tone when an Emergency PTT call is interrupted | On | All devices |
Emergency Call: Receiver
These settings customize the call behavior for any users who receive Emergency PTT calls.
| Emergency Call Receiver Settings | Description | Default | Compatibility |
| Minimum Call Start Volume | Starts the Emergency PTT call with this volume. | 25 | All devices |
| Ring on Incoming Call | Plays a ringtone for the incoming Emergency PTT call. | On | All devices |
| Vibrate on Incoming Call | Vibrates on the incoming Emergency PTT call. | Off | All devices |
| Tone Gain | The gain of the tones with respect to the audio volume. | 50 | All devices |
| Play Grant Tone | Plays a notification tone when a user is granted the floor during the Emergency PTT call. | On | All devices |
| Vibrate On Grant | Vibrates when a user is granted the floor during an Emergency PTT call. Android only. | On | Android |
| Play Floor Taken Tone | Plays a notification when the user is granted the floor during the Emergency PTT call. | Off | All devices |
| Play Floor Idle Tone | Plays a notification when the floor goes idle. | Off | All devices |
| Play Floor Denied Tone | Plays a notification tone when attempts to take the floor during the Emergency PTT call fail. | On | All devices |
| Play Floor Revoked Tone | Plays a notification tone when the user loses the floor to someone else during the Emergency PTT call. | On | All Devices |
| Play Call Lost Tone | Plays a notification tone when an Emergency PTT call is dropped. | On | All devices |
| Ring Gain | The gain of the ringtone relative to the main audio stream during the Emergency PTT call. | 100 | All devices |
| Play Busy Bonk | Plays a notification tone when the Emergency PTT call fails to connect. | On | All devices |
| Visual Indicator | The UI element that will decorate Emergency PTT calls (choose between none, status bar, and screen). | Status Bar | Android/iOS |
| Flash Indicator | Whether or not the indicator should flash during Emergency PTT calls. | On | Android/iOS |
| Blink LED | Whether or not the device's status LED should blink during Emergency PTT calls. | On | All devices |
| Blank Screen | Whether or not the device screen should be blank during Emergency PTT calls. | Off | |
| Play Channel Sounds | Plays channel sounds. | On | All devices |
| Volume Boost | Boosts the volume of all audio during the Emergency PTT call. | 0 | All devices |
| Play Satellite Ready Tone | Not applicable for most customers. Plays a not ready tone if the satellite channel is not ready after initiating the call. | On | Not applicable for most customers |
| Play Interrupt Tone | Plays a tone when an Emergency PTT call is interrupted | On | All devices |
Any of these Client Settings can be applied to a template at the customer or department level. For iinformation on templates, click here.