Tutorials
Send High-Priority Voice Alerts
Send High-Priority Voice Alerts

Send High-Priority Voice Alerts

Reach out to your end users in an instant using Voice messaging. You can automate tasks like login alters, appointment reminders, payment confirmations, or basic customer service inquiries.

Convert text-to-speech using some of the available languages and voices or pre-record an audio file containing the message that you want to play to your customers.

This tutorial teaches you how to integrate Voice and notify your customers about an alert you have previously flagged as a call trigger. The tutorial showcases the text-to-speech feature.

Process Workflow

Voice use case - Inform Customers About High-Priority Alerts - process workflow

Prerequisites

  1. Infobip account (opens in a new tab). If you do not have one, you can create a free trial account (opens in a new tab).
  2. Infobip API key with the voice:message:message:send scope. Find out more about API keys and scopes.
  3. Sender. Request a number or an alphanumeric sender through the Infobip account (opens in a new tab) or using Infobip Numbers API (opens in a new tab).
  4. Destination - a phone number to which the message will be sent.

Implementation steps

Note

The implementation steps assume that your system is already set up for alert notification that will trigger the Voice API.

  1. Arrange alerting notifications thresholds or events that will trigger the call. These can be an unauthorized account access, money withdrawal, or other type of alert.
  2. Implement the send Voice message API call (opens in a new tab) towards Infobip once the agreed threshold has been reached or a specific event has happened.
cURL
curl -L 'https://{baseUrl}/tts/3/advanced' \
-H 'Authorization: {authorization}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "bulkId": "My-alerts",
  "messages": [
    {
      "from": "41793026700",
      "destinations": [
        {
          "to": "41793026727",
          "messageId": "My-bank-alerts"
        },
        {
          "to": "41793026731"
        }
      ],
      "text": "Hello, this is Your Bank notification. Your account has been accessed. If it wasn't you, contact our support or press 1 to be connected with our agent.",
      "language": "en",
      "voice": {
        "name": "Joanna",
        "gender": "female"
      },
      "maxDtmf": 1,
      "dtmfTimeout": 10,
      "callTimeout": 130,
      "callTransfers": [
        {
          "equals": "1",
          "transferTo": "41793026700",
          "callTransferMaxDuration": 45,
          "if": "dtmf"
        }
      ]
    }
  ]
}'

Key points:

  • Use callTransfers to set up transferring options for the ongoing call to another recipient(s).
  • Use maxDtmf to set up a number of tries a user can enter the DTMf code before the call is dropped.
  • For the list of voices available for a specific language, use the Get Voices (opens in a new tab) call.

For more features, check out the Voice API reference (opens in a new tab).

IMPORTANT

Please keep in mind that Voice can only use numeric senders, and delivery of the entered sender depends on the CLI route being supported. What this means is that we are not sure that the voice connection we are using is able to deliver the caller ID as defined. Sometimes operators will manipulate the CallerID in some other value.

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary
Service status

Copyright @ 2006-2025 Infobip ltd.

Service Terms & ConditionsPrivacy policyTerms of use