Objective
This article helps you set the message handling for a TwiML App, so incoming messages on any phone number assigned to the app are sent to your web application, with a fallback if that handler fails.
Product
Programmable Messaging
Environment
Twilio Console
User Account Permission/Role(s) Required
Your user needs permission to read TwiML Apps on the account. Without it, the console shows an access-required message instead of the settings form.
Procedure
- In the Twilio Console, select Builder tools in the left sidebar.
- Select TwiML host & config, then TwiML apps.
- Select the app you want to configure, then select the Messaging tab.
- Under Primary message control configuration, enter the Request URL that handles incoming messages, and choose its HTTP method, HTTP GET or HTTP POST. The URL can be a webhook, a Function, or a TwiML bin URL.
- Under Fallback message control configuration, enter a Fallback URL and its HTTP method. This configuration is used if your primary handler fails.
- Under Status callback, enter a Status callback URL. This URL receives an HTTP request with the status of a message sent in response to an inbound message.
- Select Save. A confirmation appears reading Messaging settings updated successfully, and the fields keep the values you entered.
Additional Information
- Each URL field must be a valid URL. A Fallback URL cannot be saved on its own: if you enter one without a Request URL, the form reports Fallback URL cannot be set without a Request URL. Please provide a Request URL first.
- Both editable HTTP method fields default to HTTP POST.
- A reserved application cannot be modified. On one of those, the fields are unavailable.
This content was generated by AI and reviewed, edited, and verified by a human.