By default, Twilio handles standard English-language reply messages such as
CANCEL for Toll-Free and Long Code messages, in accordance with industry standards. These keywords trigger automatic standard replies from Twilio. This guide is intended to list the supported opt-out and opt-in keywords for Twilio Programmable Messaging service.
Notice: Text message campaigns may be subject to various legal compliance requirements depending on the nature of your text messaging campaign, the location from where you are sending your text messages, and the location of your recipients. While Twilio will handle the above-described messages on long codes and Toll-Free numbers in the way described in this article, you should consult with your legal counsel to ensure that your text messaging campaign conforms to all applicable legal compliance requirements.
If you have further questions on this, please contact Twilio Support.
Advanced Opt-Out for Messaging Services
As of August 2019, Messaging Services customers can also customize opt-in/out keywords and replies by using the Advanced Opt-Out feature. For more information, see the following resources:
- Getting Started with Advanced Opt-Out for Messaging Services
- Advanced Opt-Out for Messaging Service (Twilio Docs)
STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, or QUIT
Default reply: You have successfully been unsubscribed. You will not receive any more messages from this number. Reply START to resubscribe.
Any of these STOP keyword replies will prevent a customer from receiving new messages from the Twilio phone number they're responding to. When Twilio receives one of these replies, we will create a "blacklist" entry on our side, and then pass the message on to your webhook. Once we have a blacklist entry for a particular recipient phone number, any future attempts to message them will be met with a 400 response from our API, along with Error Code 21610 - Message cannot be sent to the 'To' number because the customer has replied with STOP. Recipients can disable this message stop, and resume receiving messages with the START, YES, or UNSTOP commands as outlined below.
Only single-word messages will trigger the block. So, for example, replying
STOP will stop the customer from receiving messages from that particular Twilio number, but replying "
STOP PLEASE" or "
PLEASE CANCEL" will not. Further, the block works and is logged even if your number currently has no messaging request URL.
Please note that these STOP keyword replies only apply to the most recent number that messaged the recipient. If you are using more than one Toll-Free number or Long Code for sending messages, you must take additional action separate from Twilio to prevent these customers from receiving messages from your other numbers. We recommend "blacklisting" numbers on your side when one of these message responses is received at your webhook.
START, YES and UNSTOP
Default reply: You have successfully been re-subscribed to messages from this number. Reply HELP for help. Reply STOP to unsubscribe. Msg&Data Rates May Apply.
Any of these replies will opt customers back in to the messages coming from a Twilio Long Code. These messages will also be delivered to your Twilio account, and the defined web hook, so you can update your application logic.
Notice: Twilio Toll-Free numbers only respond to
UNSTOP for re-subscribe.
HELP and INFO
Default reply: Reply STOP to unsubscribe. Msg&Data Rates May Apply.
These keywords should return basic helpful information, such as how to opt out. If you customize your keyword responses using Advanced Opt-Out, we recommend incorporating your business name in this reply as well.
Twilio does not forward HELP/INFO messages to your incoming message webhook.
When using a Messaging Service to send SMS messages, any STOP keyword replies will apply to the entire pool of phone numbers in the Messaging Service. Similarly, a START keyword will disable our blacklisting for the entire Messaging Service, and allow messages to this recipient once more.
It is possible to customize opt-out keywords and responses for a Messaging Service. For example, you can change the default keywords and replies, and add support for additional languages. For more information, see Getting Started with Advanced Opt-Out for Messaging Services.
By default, Twilio will not handle opt-out, opt-in or help keywords for short code numbers, unless the short code has been added to a Messaging Service.
If you are using a Messaging Service, you can configure your keywords using Advanced Opt-Out to match the compliant opt-out, opt-in and help message language from your short code application. You can also choose to disable Twilio’s keyword handling altogether and use your own system.
It is very important to ensure that your short code is compliant to all industry rules and regulations for opt-out handling. For detailed information on short code HELP and STOP responses, please see Industry Standards for US Short Code HELP and STOP.