Sending Opt-Out Links

Easily send a Opt-Out link with Chattabox

Andrew Craig avatar
Written by Andrew Craig
Updated over a week ago

Chattabox makes it easy to send a link to an opt-out page that lets your contacts unsubscribe if they no longer wish to receive messages from you.

The opt-out page is a simple mobile web page with one button. In order to access the opt-out page, the contact's phone will need a web browser and an internet connection.

If the contact clicks the button, by default, your Chattabox project will be blocked from sending any further messages to that contact, and the contact will see a confirmation page with the message "You have successfully unsubscribed."

Sending an Opt-Out Link

To send an opt-out link, when composing a message via the New Message dialog, click "Variables" and select link.optout, or type [[link.optout]].


When the message is sent, the variable will be replaced by a unique short link to an opt-out page that looks like https://rvt.me/xxxxxxxxx (24 characters). To reduce the number of characters added to an SMS message to 16 characters, you can optionally remove the https:// prefix on the Messaging Settings page.


All Chatti service plans support opt-out links, even if the short links feature is not available on your service plan. Enterprise plans can replace rvt.me with your own custom short link domain.

Customizing the Opt-Out Page

The text of Chattabox default opt-out page is in English, but you can edit the text and use another language. You can also customize the actions that are triggered when the user clicks the button to unsubscribe. By default, clicking the button on the opt-out page triggers an action to block that project from sending messages to the contact. However, you can change this behavior if necessary, and trigger other actions such as adding or removing the contact from a group, sending an email notification, or notifying another server via the webhook API.

Opt-out pages can be configured on the Short Link Pages tab of the Services page:


To add a new opt-out page, click Add New Service. To edit an existing opt-out page, click Edit. You can customize the prompt text (displayed above the button), the button text, the actions triggered when the button is clicked, and the confirmation page text.

It is possible for a project to have multiple opt-out pages. For example, if your project communicates with contacts in multiple languages, you can create a different opt-out page for each language. Each opt-out page must have a unique variable name to send a link to that page, such as [[link.optout_es]] or [[link.optout_en]].

The default opt-out page with the variable name [[link.optout]] does not count towards the maximum number of active services in your service plan, as long as the button only triggers one action. Otherwise, each active opt-out page counts towards the limit of active services in your plan.

The opt-out page is only available while your Opt-Out Page service is active and the message containing the opt-out link exists in your Chattabox account. If the message is deleted, or if the service is deactivated or deleted, the contact will see an error message if they click the link.

Allowing Contacts to Opt-Out via Keyword

If your route can receive incoming messages, you can create a Subscription service or Custom Actions service to allow users to opt-out by replying with a keyword like "STOP", instead of sending an opt-out link. This approach would not require the contact's phone to have a web browser or internet connection. However, this approach would not work when sending messages via alphanumeric sender IDs or other routes that can't receive incoming messages. In this case, sending an opt-out link would be the best way to let contacts unsubscribe.


Did this answer your question?