Templates
Templates are used to set a specific configuration of feature keys or client settings that will be applied to a selected number of users. Templates can be company wide, or they may be specific to a department.
First you must create the template, and then assign or unassign users to the template. Below, see the two levels of templates. At the Customer level, the Template can be applied to every user. At the department level, the template will be limited to users within the department. Companies with only one department can use the templates at either level.
Feature Key Template
Click on a templates tab, and then select Feature Keys and click Add.
In the resulting pop up window, enter a name into the template name space. Then select the feature keys for this template. Please note that feature key template defaults differ from the individual user feature key defaults. Contact Support for any assistance.
The Feature Key Template opens with template default settings.
Management Features
| Management Feature Key | Description | Default |
| Allow Contact Management | Allows user to add or remove contacts on their device. | On |
| Allow Group Management | Allows user to create or remove groups on their device. | On |
| Allow Refresh Presence | Allows the user to have the ability to force an immediate refresh on the device rather than waiting for the automatic presence refresh that occurs every 10-12 minutes. Recommended: leave this selection checked. | On |
| Allow Deactivation | Allows the user to sign out of ESChat. In order to sign back in, the user must have an activation code. | Off |
| Show Contacts Tab | Displays the contacts tab on the device. | On |
| Show Groups Tab | Displays the groups tab on the device. Note: may not be used with the Channels Tab. | Off |
| Show Map on Client | Displays the map tab on the device. | On |
| Show Settings Menu | Displays setting menu on the device and permits the user to view and change app settings. | On |
| Default Tab View | Selects the default tab that displays once the map is opened. | Channels |
| Show Channels | Displays the channels tab on the device. Note: may not be used with the Groups Tab. | On |
PTT Features
| PTT Feature Key | Description | Default |
| Allow DnD | Allows the user to set a global Do Not Disturb. | On |
| Show Recents Tab | Displays the Tab that allows the user to view recently placed or missed calls. | On |
| Allow Call Block | Allows the user to block individual contacts or groups. | On |
| Single Channel Isolation | Blocks all channels on the channels list when one is selected. | Off |
| Default Callee Auto Select | If set, the client re-selects the channel after focus is lost. Only able to be selected when Single Channel Isolation is also selected. | Off |
Location Features
| Location Feature Key | Description | Default |
| Send Client Location | Sends periodic idle client location and real time in-call location | On |
| Allow Location Disable | Displays "Disable Location" menu option on the device. | Off |
| Force Duty Mode | Displays Duty Mode menu option on the device. | Off |
| Enable Location Tracking | Enables client to send periodic location measurements, which are stored on the server. | Off |
| Tracking Report Period | Location tracking report period in minutes. Used in combination with Enable Location Tracking. | 10 |
| Tracking Sample Period | In seconds, how often location data is recorded per tracking period. | Server Side Only |
Messaging Features
| Messaging Feature Key | Description | Default |
| Enable Messaging | Enables messaging app to work. | On |
| Message Delivery | Receives messaging in the app. | On |
Technical Support Features
| Technical Support Feature | Description | Default |
| Client Debug Filter | The level of information displayed in client debug logs. For best results, leave at default levels unless specifically instructed to adjust per ESChat Support. |
ERROR WARN STATE DEBUG EXCEPTION |
Assign Users
After creating the template, add users. First select the Assigned Users tab, and then choose Assign Users.
Add Users
From the resulting popup window, select the users to add to the template. Then select Submit.
It will take a full registration cycle to take effect and propagate the template to all users assigned from the template. To unassign users from the template, select Assigned Users, click on the users, and click Unassign Users.
Settings Template
Below, see a Client Settings template. Enter a name into the template. Select the different tabs to configure the call settings for the template. Please note that client settings template defaults differ from the individual user client setting defaults. Contact Support for assistance.
Call
| Call Setting | Description | Default |
| Whole Screen as PTT | Permits the entire screen to be used as the PTT button. | Off |
| Start Call with Speaker | Disable this setting to have call audio sent to an earpiece rather than the phone speaker. | On |
| Use Surveillance Call Mode | Dims the screen brightness for surveillance calls. | Off |
| Surveillance Call Brightness | Adjustable screen brightness setting for surveillance call mode. | 100 |
| Default Callee | Selects a default user or group to call without an initial need to select in the Contacts or Groups tab. Devices in Channel Mode cannot use Default Callee. | None |
| Get Satellite Ready for PTT | Not applicable for most customers. Primes the satellite channel when applicable. | Off |
| 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 |
| Satellite Priming Timeout | Not applicable for most customers. The interval for satellite priming channel attempts. | 10 |
Integration
| Call Setting | Description | Default |
| Allow Bluetooth | Allows the application to use Bluetooth headsets. | Off |
| Bluetooth Always On | Keeps the Bluetooth connection continuous. | Off |
| Activate DnD in Silent Mode | Automatically activates DnD when phone enters Silent Mode. | Off |
| Activate DnD in Vibrate Mode | Automatically activates DnD when phone enters Vibrate Mode. | Off |
| Disable Onscreen PTT | Disables Onscreen PTT Screen. | Off |
| Call Priority | Selects the priority of voice calls versus PTT calls. | Current |
| Display Name | Select how contacts are displayed. | Username |
| Configure App Switcher (Disabled) | Click to configure an application of your choice to launch from the ESChat tab bar (Android only). | Off |
| Allowed Screen Orientations | Configure possible screen orientations applied from device rotation (Android only). | Off |
| Lock Screen Split Slider | Prevent resizing of the left and right views in landscape orientation | On |
| Block PTT Start When in Background | Prevents the device from initiating a PTT call while the app is in the background or the screen is locked. | Off |
Speaker
| Call Setting | Description | Default |
| Minimum Call Start Volume | The minimum volume to use when starting a call. Decreasing the volume below this threshold shall not carry over to the start of the next call. | 25 |
| Ring on Incoming Call | The application will ring on incoming PTT calls. | On |
| Vibrate on Incoming Call | The application will vibrate on incoming PTT calls. | Off |
| Tone Gain | The gain of the tones with respect to the audio volume. | 100 |
| Play Grant Tone | Plays a tone when talk privileges are granted. | On |
| Vibrate on Grant | Vibrates when talk privileges are granted. | On |
| Play Floor Taken Tone | The application will play a tone when another user has talk privileges. | Off |
| Play Floor Idle Tone | The application will play a tone when another user has released talk privileges and the floor is idle. | Off |
| Play Floor Denied Tone | The application will play a tone when talk privileges have been denied. | On |
| Play Floor Revoked Tone | The application will play a tone when talk privileges have been revoked. | On |
| Play Call Lost Tone | The application will play a tone when a call has been dropped due to network conditions. | On |
| Ring Gain | The gain of the ring tone with respect to the audio volume. | 100 |
| Play Busy Bonk | The application will play a tone when a call fails to connect. | On |
| Play Channel Sounds | The application will play channel announcements. | On |
| Volume Boost | In tenths of a dB, boosts the volume of the audio. | 0 |
| Play Satellite Ready Tone | Not applicable for most customers. The application will play a not-ready tone if the satellite channel is not ready and needs to be primed. | Off |
Notification
| Call Setting | Definition | Default |
| Alert Call Ring Duration | Duration, in seconds, during which the phone rings on an incoming Alert Call. | 30 seconds |
| Endless Alert on Missed Call | The phone will continuously play a tone when an incoming Alert Call call is missed, until manually canceled. | Off |
| Foreground App on Incoming Call | The application will come to the foreground on an incoming PTT call. | On |
| Notify All Missed Calls | The application will allow one missed call notification. | On |
| Notify All New Messages | The application will only allow unacknowledged received message notification. | On |
| New Message Alert | Choose the alert tone to play when a new message is received. | Default System Notification |
| New Message Alert Time | Tied to New Message Alert, if the tone is the PTT Ringtone; Time, in seconds, to keep alert tone going. | 1 second |
Headset
| Call Setting | Description | Default |
| Minimum Call Start Volume | The minimum volume to use when starting a call. Decreasing the volume below this threshold shall not carry over to the start of the next call. | 25 |
| Ring on Incoming Call | The application will ring on incoming PTT calls. | On |
| Vibrate on Incoming Call | The application will vibrate on incoming PTT calls. | Off |
| Tone Gain | The gain of the tones with respect to the audio volume. | 50 |
| Play Grant Tone | Plays a tone when talk privileges are granted. | On |
| Vibrate on Grant | Vibrates when talk privileges are granted. | On |
| Play Floor Taken Tone | The application will play a tone when another user has talk privileges. | Off |
| Play Floor Idle Tone | The application will play a tone when another user has released talk privileges and the floor is idle. | Off |
| Play Floor Denied Tone | The application will play a tone when talk privileges have been denied. | On |
| Play Floor Revoked Tone | The application will play a tone when talk privileges have been revoked. | On |
| Play Call Lost Tone | The application will play a tone when a call has been dropped due to network conditions. | On |
| Ring Gain | The gain of the ring tone with respect to the audio volume. | 100 |
| Play Busy Bonk | The application will play a tone when a call fails to connect. | On |
| Play Channel Sounds | The application will play channel announcements. | On |
| Volume Boost | In tenths of a dB, boosts the volume of the audio. | 0 |
| Play Satellite Ready Tone | Not applicable for most customers. The application will play a not-ready tone if the satellite channel is not ready and needs to be primed. | Off |
Emergency
The Emergency Call Settings template has settings for the call group behavior as well as settings specific to call initiators and receivers within the group. These settings offer the same selections as the Speaker and Headset settings options but remain within the scope of the specifically designated
| Call Setting | Description | Default |
| Emergency Group | The group to initiate a call with or request to talk in with an insistent sound and visual flashing signal. | None |
| Start Hold Time | The duration in milliseconds the emergency key (the PTT key or screen toolbar) must be held to initiate the emergency call. | 3000 |
| Cancel Hold Time | The duration in milliseconds the cancel button (dialog or hard key) must be held to cancel the emergency call. | 3000 |
| Initiate Call | When enabled, a call will be initiated with the target emergency group. When disabled, the user must wait for the request to talk to be accepted before speaking. | On |
Assign Users
Once you have created your template, you will have to add users. First select the Assigned Users tab, and then choose Assign Users.
Add Users
From the resulting popup window, select the users you wish to add to the template. Then select Submit.
It will take a full registration cycle to take effect and propagate the template to all users assigned from the template. To unassign users from the template, select Assigned Users, click on the users, and click Unassign Users.