Skip to content

Fuzzy opt-out

iOS message chat that shows outbound opt-out messages in response to the inbound fuzzy opt-out "Please stopppp".

Users that send SMS, MMS, and RCS with Braze must adhere to the applicable laws, regulations, and industry standards that are defined. For opt-out, the laws dictate that when a user texts “STOP” that all subsequent messaging related to that messaging program will be stopped. Braze automatically processes these messages and unsubscribes the user.

Fuzzy opt-out attempts to recognize when an inbound message does not match an opt-out keyword, but indicates opt-out intent. If fuzzy opt-out is enabled and an inbound keyword response is deemed “fuzzy,” you can configure Braze to either automatically unsubscribe the user or respond with a message that instructs them how to opt out manually.

Currently, only opt-out keywords created using English as the local language are supported.

What is deemed as fuzzy?

The criteria for an inbound response to be deemed as “fuzzy” are as follows:

  • If switching a letter with the letter one to the left or right of it on a QWERTY keyword yields a matching opt-out keyword.
  • A substring of the message matches an opt-out keyword.

For example, “Stpo” or “Please stopppp” will be deemed fuzzy, and a fuzzy opt-out response will be sent. If the user then responds with an opt-out keyword, an unsubscribe event will trigger.

Configure fuzzy opt-out

To configure fuzzy opt-out, navigate to the subscription group keyword management page.

  1. Go to Audience > Subscription Group Management and select an SMS/MMS/RCS subscription group.
  2. In Global Keywords, find the Opt-out category and select the pencil icon.
  3. Toggle Fuzzy Opt-Out to On.
  4. Select your preferred Fuzzy Opt-Out Logic option:
    • Automatically unsubscribe: When a user sends a message similar to an opt-out keyword, they are immediately unsubscribed without being prompted. The standard opt-out confirmation message is then sent.
    • Send opt-out instructions: When a user sends a message similar to an opt-out keyword, Braze sends a custom reply (the Opt-out instruction message) explaining how to unsubscribe.
  5. If you selected Send opt-out instructions, enter your custom text in the Opt-out instruction message field. This field is required for this setting.
  6. Select Save.

Section to edit opt-out keywords and provide an opt-out instruction message.

Best practices for fuzzy opt-out messages

To ensure a clear, compliant, and positive experience for your subscribers, it’s crucial to configure your fuzzy opt-out message thoughtfully. The main purpose of the fuzzy opt-out message is to guide users who send a message similar to, but not exactly, your designated opt-out keyword. The message prompts users on how to successfully unsubscribe.

Critical considerations

The fuzzy opt-out message is sent before the user has successfully opted out. Using confirmation language (such as “You have been unsubscribed”) misleads the subscriber into believing they are unsubscribed when they are not, leading to continued unwanted messages, subscriber frustration, and significant compliance risks.

To unsubscribe users immediately upon a fuzzy match, use the Automatically unsubscribe setting instead.

If your fuzzy message is the same as, or too close to, your exact opt-out keyword (for example, if “STOP” is your exact keyword and your fuzzy message is “Text STOP to unsubscribe”), it can create confusion about whether the user’s initial message actually resulted in an unsubscribe or if they need to take another action. The fuzzy message should always clarify what action the user needs to take.

Examples of fuzzy opt-out messages

If you choose Send opt-out instructions, focus your message on guiding the user. For example, if your opt-out keyword is “STOP”, these are good and poor examples of fuzzy opt-out messages you could create:

New Stuff!