Voice - Receive an inbound call

📘

NOTE:

To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.

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

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.