Voice notification content

The Voice Interaction editor employs an intuitive drag-and-drop interface that makes it easy to add and remove form properties and voice actions (the basic building blocks of your voice interaction). It's also simple to rearrange content by dragging script elements to another location within the editor.

When you open the Voice Interaction editor or click on the Record icon, you may be prompted to share the computer's microphone with xMatters. Sharing your microphone with xMatters allows you to record new phrases using your computer's microphone. For more information, see Record a new voice interaction phrase.

The following screenshot shows the editor's key features, along with a sample voice interaction:

The Voice Interaction editor gives you the ability to add properties to the script by dragging them from the panel to the desired insertion point in the message. The value of the property is inserted into the message based on the information specified when sending the message. You can add form, person, sender, and alert properties to a voice message. See Personalize notifications for more information on using these properties to customize notifications.

Only properties included in the form layout are available in the Form Properties panel. To use person properties, you must have the ability.act.actREBMessagePersonProperties permission.

Add a Speak Phrase element to your script by dragging it from the Voice Action panel to the editor. You can have the system:

• Play a recording that already exists in the system.
• Play a new recording you create from within the Voice Interaction editor.
• Use a text-to-speech (TTS) engine to read the phrase or spell it out one letter at a time.

If no recording exists for a phrase, the system automatically uses TTS to speak the phrase to the message recipient.

After you add a Speak Phrase element to the editor, you can associate an existing recording with it.

1. Start typing in the search field. Any existing phrases that match the search criteria appear in a list.
2. Select the phrase you want to use to add it to the script.

You can create a new recording and associate it with the Speak Phrase element. See Record a new voice interaction phraseRecord a new voice interaction phrase for detailed instructions.

Click the play icon to listen to the recording associated with a Speak Phrase element.

You can also preview the entire voice interaction to make sure it flows the way you expect.

If no recording exists for a phrase and you don't want to create one, you can tell the system to use a TTS engine to read the phrase or spell out the phrase one letter at a time: after you add the Speak Phrase element to the editor and typed your phrase, select Force Text-to-Speech or Spell Out from the list of options.

If your xMatters company has more than one language defined, you can click the related language tab to create interactions for each language.

1. Ensure that the computer's microphone is working and that you are using a supported browser.
2. Your browser may prompt you to allow your xMatters instance to access your microphone. Here's an example from Chrome (your browser may be different):

   

   1. If you previously denied microphone access to xMatters, you may need to reset this setting in your web browser before continuing.

3. Click the Add Recording button (the microphone icon) next to the speech item you want to record.
   1. The microphone recording dialog appears.

If the browser does not have permission to access the microphone, this dialog is not displayed and you are prompted to select a voice device.

4. Click the microphone to begin recording, and then speak your message into the microphone.
   1. The countdown timer displays how much time is remaining for your message. If you need more time, record another message.

5. To stop the recording, click the stop button (the red square).
6. To review your message, press the play button (the green triangle).

7. If you like your recording, click Keep. Otherwise, click Discard and re-record your message.
8. Verify your recording has been saved by checking that the TTS icon to the right of the phrase has changed to the play icon.

1. Click the Add Recording button (the microphone icon).
2. If you have given xMatters permission to use the microphone, you may be prompted to begin recording into the microphone. Click Record over the phone to record using a voice device.
3. Select a voice device that you will use to record the phrase.

4. To initiate a phone call to the selected device, click Next.
5. When xMatters calls the selected device, follow the prompts to record, review, and save your message.
6. To verify that your recording has been saved, ensure that the icon to the left of the phrase has changed from the TTS icon to the play icon.

To preview the voice interaction, you need a voice device set up in xMatters.

1. Click Save and Preview to open the Preview Voice Interaction dialog box.
2. Specify the settings for any properties you added to the script (these are properties a message sender would configure before initiating the form). You're given the opportunity to add a recording for text properties without a recording; if you don't add a recording, TTS will be used.

3. Click Start Preview and listen to the message when the system calls you, taking note of any changes you want to make to the script.