Webhooks
(new)
Proxy Public Beta is not available to new customers
Proxy Public Beta is currently closed for new customers. Please consider using Twilio Conversations and Programmable Voice directly if you are building your masking application.
(new)
Public Beta for customers already using Proxy
Twilio's Proxy API is currently available as a Public Beta product. Some features are not yet implemented and others may be changed before the product is declared as Generally Available.
Public Beta products are not covered by a Twilio SLA.
Twilio Proxy can call a webhook in your system to notify you of various events. To enable webhooks, configure an optional callback URL on your Proxy Service using either the REST API or the Console.
| Name | Description |
|---|---|
| CallbackUrl | These webhooks are fired for each new interaction and are informational only. |
| InterceptCallbackUrl | Fires on each interaction. If responded to with a 403 to this webhook we will abort/block the interaction. Any other status or timeout, the interaction continues. |
| OutOfSessionCallbackUrl | A URL to send webhooks to when an action (inbound call or SMS) occurs where there is no session or a closed session. If your server (or a Twilio function) responds with valid TwiML, this will be processed. This means it is possible to e.g. play a message for a call, send an automated text message response, or redirect a call to another number. |
All webhook parameters are submitted as form parameters (application/x-www-form-urlencoded). Each webhook above will pass you specific parameters as shown below with their example values.
| Name | Example Value |
|---|---|
| inboundParticipantSid | KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundResourceSid | CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundResourceStatus | completed |
| inboundResourceType | call |
| inboundResourceUrl | https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Calls/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json |
| interactionAccountSid | ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionData | |
| interactionDateCreated | 2018-03-13T22:42:54Z |
| interactionDateUpdated | 2018-03-13T22:42:56Z |
| interactionServiceSid | KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionSessionSid | KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionSid | KIXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionType | Voice |
| outboundParticipantSid | KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundResourceSid | CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundResourceStatus | initiated |
| outboundResourceType | call |
| outboundResourceUrl | https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Calls/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json |
| Name | Example Value |
|---|---|
| inboundParticipantSid | KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundResourceSid | CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundResourceStatus | completed |
| inboundResourceType | call |
| inboundResourceUrl | https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Calls/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json |
| interactionAccountSid | ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionData | |
| interactionDateCreated | 2018-03-13T22:42:54Z |
| interactionDateUpdated | 2018-03-13T22:42:54Z |
| interactionServiceSid | KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionSessionSid | KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionSid | KIXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| interactionType | Voice |
| Name | Example Value |
|---|---|
| AccountSid | ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| AddOns | {"status":"successful","message":null,"code":null,"results":{}} |
| ApiVersion | 2010-04-01 |
| Called | +1415XXXXXXX |
| CalledCity | OAKLAND |
| CalledCountry | US |
| CalledState | CA |
| CalledZip | 94612 |
| Caller | +1951XXXXXXX |
| CallerCity | CORONA |
| CallerCountry | US |
| CallerState | CA |
| CallerZip | 92879 |
| CallSid | CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| CallStatus | ringing |
| Direction | inbound |
| From | +1951XXXXXXX |
| FromCity | CORONA |
| FromCountry | US |
| FromState | CA |
| FromZip | 92879 |
| inboundParticipantAccountSid | ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundParticipantDateCreated | 2018-03-14T06:22:05Z |
| inboundParticipantDateUpdated | 2018-03-14T06:22:05Z |
| inboundParticipantFriendlyName | user_cjeqp7cxv00018dd5ho0n2792 |
| inboundParticipantIdentifier | +1951XXXXXXX |
| inboundParticipantProxyIdentifier | +1415XXXXXXX |
| inboundParticipantProxyIdentifierSid | PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundParticipantServiceSid | KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundParticipantSessionSid | KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| inboundParticipantSid | KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundParticipantAccountSid | AC4XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundParticipantDateCreated | 2018-03-14T06:22:06Z |
| outboundParticipantDateUpdated | 2018-03-14T06:22:06Z |
| outboundParticipantFriendlyName | user_cjeqp7d7w00028dd5d7bus6vj |
| outboundParticipantIdentifier | +1707XXXXXXX |
| outboundParticipantProxyIdentifier | +1707XXXXXXX |
| outboundParticipantProxyIdentifierSid | PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundParticipantServiceSid | KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundParticipantSessionSid | KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| outboundParticipantSid | KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| sessionAccountSid | ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| sessionClosedReason | api |
| sessionDateCreated | 2018-03-14T06:22:05Z |
| sessionDateEnded | 2018-03-14T06:22:06Z |
| sessionDateUpdated | 2018-03-14T06:22:06Z |
| sessionMode | voice-only |
| sessionServiceSid | KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| sessionSid | KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| sessionStatus | closed |
| sessionUniqueName | session_cjeqp7cot00008dd5v4rbowgp |
| To | +1415XXXXXXX |
| ToCity | OAKLAND |
| ToCountry | US |
| ToState | CA |
| ToZip | 94612 |