Want to provide feedback?

Write to docs@telesign.com.

NOTE:

If you are interested in trying TeleSign’s Voice API, sign up by contacting our experts.

Receive an Inbound Call with TeleSign’s Voice API

You can use TeleSign’s Voice API to receive an inbound call. This is often used for setting up an inbound IVR system.

Note

TeleSign calls have a maximum call duration of four hours.

Requirements

You must have the following:

TeleSign credentials: Your customer ID and API key
TeleSign phone number: A phone number you have purchased from the TeleSign Phone Numbers API to use as a caller ID. 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 Get Started with the Phone Numbers API for more details.
Customer event URL: A notification service you have set up for TeleSign to post event information to. For more details, refer to the Set up the Customer Event URL section on the Voice API Reference page.

Be sure also to only use supported standards and codecs (see Supported Standards and Codecs).

Receive an Inbound Call

You receive an inbound call from TeleSign via an incoming_call event.

Example (body only)

application/json

{
  "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 further actions to the Voice API.

Next Steps

Check out these related pages:

Get Started with the Phone Numbers API - Learn how to buy a phone number from TeleSign to use as a caller ID.
Play Message and Collect Digits - Learn how to play a phone message and collect digits.