Voice - Receive an inbound call

This page explains how to use Telesign Voice to receive an inbound call. This is often used for setting up an inbound IVR system.

📘

NOTE

If you are interested in trying Telesign Voice, sign up by [contacting our experts](https://www.telesign.com/contact-sales?utm_campaign=contact%20sales%20form&utm_source=customer_documentation&utm_medium=document&utm_content=voice_api.

📘

NOTE

Telesign calls have a maximum call duration of four hours. You can also set a shorter maximum for an individual call.

Requirements

You must have the following:

  • Telesign authentication credentials: Your Customer ID and API key.
  • Telesign phone number: A phone number you have purchased from Telesign to use as a caller ID. Purchase a number using the Telesign Phone Numbers API or ask our Customer Support Team to purchase a number for you. Make sure that the number is voice-capable (include the parameter and value voice_capable=true in your request to the Phone Numbers API). Refer to Phone Numbers API - Get Started for more details.
  • Customer event URL: A notification service you have set up for Telesign to post Event notifications to. See Voice - Receive Events with webhooks for instructions on how to set that up.

Be sure also to only use supported standards and codecs (see Voice - Supported standards and codecs).

Receive an inbound call

You receive an inbound call from Telesign via an incoming_call Event.

Example (body only)

{
  "event": "incoming_call",
  "reference_id": "534e1848-235f-482d-983d-e3e11a04f58a",
  "data": {
    "to": "15555551212",
    "from": "15558675309"
  }
}

You then decide how you want to handle this event, for example by sending an Action to Telesign.


Did this page help you?