SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How to Configure a Disaster Recovery URL for your Elastic SIP Trunk

In the event that calls cannot be delivered to your Elastic SIP Trunk due to a disaster in your organization or outage in your geographic area, Twilio can trigger a webhook to a backup application at a URL specified by the Disaster Recovery URL in the Twilio Console.

Your Disaster Recovery URL may look something like this: http://fallback.mycompany.com/index

The disaster recovery URL is expected to return TwiML, which is a set of call control instructions used by Twilio's Programmable Voice product. These TwiML instructions can perform any operation normally done by a Twilio application. It could be as simple as saying a message to "try again later," taking a voicemail message, redirecting to another phone number, or replicating the functionality of your PBX.

How to configure in the Twilio Console

To configure this setting in the Twilio Console, login and navigate to the origination page for your Elastic SIP Trunk.

Elastic SIP Trunking --> Trunks --> {trunk-name} --> Origination

Once there, paste in the URL that you would like to fetch call instructions from and save the configuration changes made.

Keep in mind that for each new origination SIP request, Twilio will first try your configured SIP URIs, and if none of them succeed, Twilio will then invoke the disaster recovery URL if one is configured. No additional steps are required when the areas of your network affected by the disaster or outage have been restored.

How to configure with the API

Alternatively, you can configure the disaster recovery URL using the Twilio Trunk API. See the disasterRecoveryUrl and disasterRecoveryMethod properties under Trunk Properties in our documentation.

More information

For more general information about the Disaster Recovery URL, see our documentation here: Disaster Recovery URL.

*Please note that when calls are redirected to your disaster recovery URL, normal Twilio Programmable Voice rates apply. See Programmable Voice Pricing for more details.

Have more questions? Submit a request
Powered by Zendesk