On October 5, 2021, Twilio Frontline introduced V2 of its callbacks. This new version of callbacks includes additional security measures and updates to make callback behavior more consistent with other Twilio webhooks.
Any account that created its SSO configuration after October 5, 2021 will automatically use V2 callbacks.
Any account that created its SSO configuration prior to October 5, 2021 will use V1 callbacks until the account upgrades to V2.
V1 callbacks will continue to be supported until April 27, 2022. On April 27, 2022, any account that has not manually upgraded will be automatically upgraded. V2 callbacks include breaking changes. If you upgrade to V2 without also updating your integration service, functionality related to inbound/outbound routing, CRM integration, and templates will be impacted.
Once you’ve made the following updates to your integration service, you can upgrade to V2 callbacks from within the Frontline console.
V2 callbacks will no longer have a Token body parameter or X-Twilio-Token header. Instead, all calback requests will have an
X-Twilio-Signature header like other Twilio Callbacks. See Callbacks Security for more information and tutorials.
V2 Callbacks will have request body parameters in application/x-www-form-urlencoded form similar with other Twilio Callbacks instead of application/json.
Please update your Frontline Integration Service to support application/x-www-form-urlencoded body for Frontline Callbacks. Note that this is only for request parameters, and the expected response type is still application/json. If you are using the Frontline Integration Service Example, it is already supported, and no additional action needed.
Location parameter will be sent as a body parameter instead of a query parameter, as it was in V1 callbacks. It has also been renamed from
Location to match the format of other parameters.
Instead of the Channel object, GetProxyAddress now have ChannelType and ChannelValue. These are strings and should match the Channel object.
|CustomerId||string||Customer ID provided by the server|
|ChannelType||string||The channel type. It can be
|ChannelValue||string||The channel address. Example:
See GetProxyAddress for more information.