Message Feedback is one of the best tools at our disposal to understand your message deliverability and enable us to optimize it on your behalf automatically.
Sending text messages around the world is not a one-size-fits-all operation. Deliverability varies by geography, mobile operator, use case, and even for individual companies. There are many different knobs that Twilio can tune, such as various routing paths and carrier configurations.
Twilio’s backend uses a mix of automated algorithms and manual adjustments to ensure the best possible deliverability for our customers. We tweak these parameters regularly to keep up with the ever-changing telecom ecosystem. We use several sources of data to make sure that the configuration changes we make are improving deliverability, but we trust what you tell us the most.
The Message Feedback API enables customers to report back to Twilio in real-time when a text message is delivered successfully. Using this feedback information, Twilio can then detect and quickly react to changes in the global messaging networks, both in aggregate and specific to your account, thereby improving the delivery of your messages.
You can view your reported feedback information in your Console to help you monitor and understand your message deliverability. Feedback information is aggregated every 15 minutes and will only display once you have reported feedback information to Twilio.
The Message Feedback API is useful to Twilio customers who have some trackable user action that results from their message being sent. Examples of trackable user actions include:
- A user receives a passcode via SMS and enters it into a website or app
- A user enters a temporary password
- A user replies to a message with a call or SMS
- A user clicks on a unique link contained in the message
Once a user takes a trackable action, you can guarantee they received the message. Simply submit this information to Twilio, and we take care of the rest.
- When you send a message, let Twilio know that you are expecting a trackable user action by including the
ProvideFeedback=trueparameter in the initial HTTP POST.
- Save the Message SID from the POST response. You'll need this later.
- When the user takes the expected action, let Twilio know by sending a POST request to the Message Feedback instance subresource with
Outcome=confirmedparameter. If the user does not take an action, do not POST anything.
For step-by-step instructions on how to track the delivery status of your sent messages, follow our guide to Tracking Delivery Status in your web programming language of choice.