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.



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.



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


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?