What are SMS Opt-Out Keywords?

Telnyx automatically processes incoming messages and recognises English language stop words. Stop words are specific words such as STOP or UNSUBSCRIBE that signal that a person no longer wishes to receive messages from you.

When Telnyx identifies a stop word, the person's phone number is added to the opt-out list and you will no longer be able to send messages to that number.

This is default behaviour when you create an account. This means any further messages from numbers on the same messaging profile that are sent to a number on the opt-out list will not be processed. So if there are two messaging profiles: X and Y

Coming soon: You will soon be able to retrieve all phone numbers that are on the opt-out list.

Please note that stop words are only recognized if they are the only words in the message. For example, "stop all" is recognized but "please stop all messages" would not be recognized.

Note that to be able to restart messages, the end user needs to send the opt in keywords above to the exact same number they opted out from. When using our number pool feature you might not get clarity as what number they opted out from since it you used several numbers to send messages out. You should be able to find the opt out SMS in your MDRs by filtering for number that opted out, this way you can easily determine the number where the opt in needs to be sent to.

By default, Telnyx will handle the auto response. If a user of your services decides to opt out via one of the above stop words towards your numbers, Telnyx will detect this and automatically send out a generic unsubscribed message from the number that received the opt out message.

Generic Messages:

However, It is possible to allow for custom block rules and auto responses on a per messaging profile basis but recommend contacting our sales team (sales@telnyx.com) to discuss this further.

Telnyx now offers the ability to add custom keywords for opt-in/out and help messages along with specifying the new keywords auto responses.

This feature can be accessed on the portal here: https://portal.telnyx.com/#/app/programmable-messaging/keywords-management

To set up custom keywords simply select your desired messaging profile form the keywords management menu where you will then be given the option to add keywords for the messaging profile globally (Country: Global). Or if you wish to specify keywords for particular countries you can click the "Add keywords in other languages based on country selected" button at the bottom of this list. This will then create a new rule set for custom keywords and allow you to select a specified country that these new rules should apply to from the drop down menu, then just fill in your new keywords and auto response and don't forget to hit the save button before closing the menu.

Restrictions for the above: