Send Text and Audio Notifications
Call Telemetry Notify can send display text, uploaded audio, text-to-speech, or paired text and audio to Cisco IP phones.
Recipient groups can also route supported notifications to Webex, Microsoft Teams, and email. This guide focuses on Cisco IP phone delivery.
Requirements
- Complete the Notify requirements.
- Create a Paging Group and a Notify Scenario.
- Confirm that the CUCM services required by your delivery method are available.
- Test content and volume with a controlled phone group.
Choose an Action Type
Set action_type on the Scenario:
| Value | Delivery |
|---|---|
text_page | Display text_message on target Cisco IP phones. |
audio_page | Play uploaded audio or generated text-to-speech. |
both | Deliver display text and audio in the same Scenario. |
Configure Display Text
Set text_message to the message recipients should see. Keep it short enough to scan quickly, state the required action first, and identify the location or incident when it helps recipients respond.
For example:
EVACUATE BUILDING A. Use the east stairwell and report to the north assembly area.
Avoid relying on color, formatting, or a single device model to convey urgency. Verify the message on each phone family used by the target group.
Configure Audio
You can attach a stored audio file or generate speech from text.
Use an Uploaded Audio File
- Upload the file with
POST /api/org/{org_id}/paging/audio. - Save the returned audio file ID.
- Set
audio_file_idon the Scenario.
See List Paging Audio and Upload Paging Audio.
Use Text-to-Speech
Enable use_tts, then set the Scenario's tts_template and tts_voice. Confirm that text-to-speech is configured in your deployment before launch.
See Generate Paging Audio from Text and List Text-to-Speech Voices.
Choose a Delivery Method
| Method | Use It When |
|---|---|
multicast | Many phones can receive the same RTP stream through a configured multicast path. |
unicast | Call Telemetry should originate audio to each phone individually through JTAPI. |
sequential | Recipients should be processed in order rather than as one simultaneous broadcast. |
Network, multicast, CTI, and phone configuration determine whether a delivery method can reach a device. Test the selected method on the same network segments and phone models used in production.
Set Volume, Priority, and Active-Call Behavior
volumeaccepts values from 0 through 100 and defaults to 80.priorityaccepts values from 1 through 10 and defaults to 5.override_active_callscontrols whether Notify may interrupt active calls.
Interrupting active calls can disrupt emergency calls or other critical conversations. Validate your operating policy and test the exact phone behavior before enabling override_active_calls.
Inspect Delivery Results
A launch creates a paging job. Use its result operations to review each recipient and channel:
A queued or completed job does not prove that every recipient received every channel. Review the individual results, investigate failures, and rerun only when doing so is safe.