Voice API - Receive Events with Webhooks

To use Voice, you need to set up and control a notification service, using it to receive events from TeleSign at one or more webhook endpoints.

Requirements

This service should:

  • Have a valid DNS name (can't just be an IP address)
  • Require the HTTPS protocol
  • Require a certificate signed by a valid certificate authority
  • (OPTIONAL) Use Digest authentication.

Authentication

Authentication to validate the requests coming in to your server from TeleSign is not required. We do recommend however that you use Digest authentication to prevent malicious parties from contacting your server.

Send Endpoint URL to TeleSign

Once you have set up this service, send the endpoint URL to our Customer Support Team. If you plan to use multiple webhook endpoints, send us the one you want to serve as the default. You can pass an alternate webhook endpoint in any of your requests to the Voice API, overriding the default for the duration of that phone call.

After one business day, we will begin sending events to this URL.

🚧

Caution

Double-check that the customer event URL is accurate when you send it to TeleSign! If you provide us the wrong URL, we will not be able to send you any events.


Did this page help you?