Sounds for Vocera Vina

Sounds for alarms for Vocera Vina are defined in the XMPP rule for each alarm. Sounds for other ringtones and notifications can be defined in a configuration file.

In the XMPP adapter, the sound for a Vocera Vina alarm is specified in the Alert Sound dropdown list in the XMPP rule definition for the alarm.

For ringtones and notifications other than alarm tones, you can configure their sounds in a file in JSON format. This file must be located in /opt/EXTENSION/conf/XMPP/ringtones.json. When you configure sounds, you must restart the XMPP adapter for your changes to take effect.

Sounds for the following events can be specified:

Event	Key
Incoming call ring	incoming_call
Urgent incoming call ring	incoming_urgent_call
New text message sound	new_message
Missed call	missed_call
New acknowledgement required message sound	acknowledgement_required_message
New Vocera Voice Server page	page
Failed call log	failed_call
Alarm response timeout (no one responded to the alarm before the timeout period configured in the rule/template)	response_timeout
Alarm delivery timeout (alarm could not be delivered within the timeout period configured in the rule/template)	delivery_timeout

Note that a single set of sounds cannot be specified for all facilities and units. You must specify an entry in the ringtones.json file for each facility and unit in your organization. Here is an example of some ringtone entries:

{
 
    'St Mary's Memorial':
    {
        Ortho:
        {
             incoming_call:vocera_tone_1,
             incoming_urgent_call:voice_urgent,
             new_message:vocera_tone_1,
             acknowledgement_required_message:vocera_tone_1,
             missed_call:vocera_tone1,
             page:pager1,
             failed_call:party_left,
             response_timeout:default_tone,
             delivery_timeout:default_tone
         },
         Nicu:
         {
             incoming_call:vocera_tone_1,
             incoming_urgent_call:voice_urgent,
             new_message:vocera_tone_1,
             acknowledgement_required_message:vocera_tone_1,
             missed_call:vocera_tone1,
             page:pager1,
             failed_call:party_left,
             response_timeout:default_tone,
             delivery_timeout:default_tone
          }
    },
    'Regional':
    {
          Pediatric:
         {
             incoming_call:vocera_tone_1,
             incoming_urgent_call:voice_urgent,
             new_message:vocera_tone_1,
             acknowledgement_required_message:vocera_tone_1,
             missed_call:vocera_tone1,
             page:pager1,
             failed_call:party_left,
             response_timeout:default_tone,
             delivery_timeout:default_tone
          }
     }
}

If you do not specify a tone for an event, the default ringtone for that sound type is used.