How to Handle WhatsApp Opt-Outs and Unsubscribe Requests

When someone asks to stop hearing from you on WhatsApp, you must stop, wherever they asked: in the chat, by email, on a call or in your shop. WhatsApp’s Business Messaging Policy requires businesses to respect every request to block, discontinue or opt out, and customers can also stop your marketing themselves from the chat, after which your marketing templates to them fail with error 131050.

Handling opt-outs well protects your number as much as it protects your customers: someone who can opt out easily doesn’t need to block or report you. This guide covers the ways people opt out, how to add an opt-out button, what to do when a request arrives, how to keep a reliable opt-out list, when you may message someone again, and what ignoring opt-outs costs you.

The ways customers opt out

Every one of these beats a block. The aim is to make opting out easier than blocking.

What WhatsApp’s own controls do

Every business chat on WhatsApp has controls for offers and announcements. According to WhatsApp’s Help Centre, a customer can open your chat, tap Stop and confirm, and later tap Resume to get them again. They can also tell WhatsApp whether they’re interested in your offers, or block and report you.

• Stopped customers still get other messages they chose to receive, such as boarding passes, delivery updates and one-time passwords. The Stop control is about marketing.
• Your marketing templates fail with 131050: “This recipient has chosen to stop receiving marketing messages on WhatsApp from your business”. Meta’s advice is not to retry.
• Software can be told automatically. The user_preferences webhook fires when a customer stops or resumes marketing messages, with the value stop or resume.
• “Not interested” is softer. It can reduce how many of your marketing messages that person receives and offers them the option to stop completely, but it doesn’t trigger the webhook.

Add an opt-out button to marketing templates

Meta’s template documentation describes the quick-reply button this way: a common use is letting customers easily opt out of marketing messages. Meta’s own examples are labelled “Unsubscribe from Promos” and “Unsubscribe from All”. Many businesses use “Stop promotions”.

• Button labels can be up to 25 characters, and a template can have up to 10 quick-reply buttons.
• Quick replies must be grouped together, either before or after any website or phone buttons, not mixed in between them.
• Templates with four or more buttons, or a quick reply combined with another button type, can’t be viewed on WhatsApp desktop; customers are asked to open them on their phone.
• A tap is a message from the customer, so it also opens a 24-hour window in which you can reply with a normal message.

Sample marketing template with an opt-out button

“Hi {{1}}, our winter collection is now in store at Example Store. Tap below to see this week’s picks.” Buttons: [See the collection] [Stop promotions]

Sample text with a placeholder business. If your software opts people out when they type a keyword, you can also add a footer such as “Reply STOP to opt out”. And say how to opt out when you collect consent, as Meta’s opt-in guidance recommends; see WhatsApp opt-in.

What to do when someone opts out

1. Mark the contact as opted out the same day, with the scope: marketing only, or everything if they asked you to stop all messages.
2. Remove them from anything already scheduled: campaigns, drip sequences and follow-ups that would send marketing.
3. Confirm once, briefly, if you like. Meta lists opt-out confirmation as a utility use, with the example: “Thank you for confirming your opt-out preference. You will no longer receive messages from us on WhatsApp.” If they’ve just tapped a button, a normal reply inside the 24-hour window does the job.
4. Keep only the messages they still need. Someone who stopped promotions may still expect order or appointment updates. Someone who asked you to stop everything should get nothing more.
5. Record it: date, time, channel (button, chat, call, email, in store) and what they opted out of.

Keep an opt-out list that actually works

Meta doesn’t prescribe how you store opt-outs, but the policy covers requests made anywhere, so your list has to be the single source of truth for every team and system. For each person, keep:

• Phone number with country code, and name.
• Date and time of the opt-out.
• Where it came from: WhatsApp’s Stop control (131050 or the webhook), your button, a chat reply, a call, an email or a store visit.
• Scope: marketing only, or all messages.
• Any later opt-in, with the same details.

Check the list before every campaign, not just once a month. The most common slip is a re-import: a spreadsheet from sales or an old CRM export quietly adds opted-out people back to your audience. Import into the same contact records rather than creating duplicates, and filter opted-out contacts out before you send.

Re-opt-in: when can you message them again?

WhatsApp’s policy doesn’t set a waiting period for asking again, and it doesn’t need one: the customer decides. Treat an opted-out person as off-limits for marketing until they clearly opt back in themselves:

• They tap Resume in WhatsApp’s offers and announcements control; the user_preferences webhook reports resume.
• They message you and ask for offers, or tap a button such as “Yes, send me offers” in a chat they started.
• They give a fresh opt-in elsewhere, such as a website or checkout checkbox, which must say they’re opting in and name your business.

Don’t send a marketing template asking “Do you want to hear from us again?” to someone who opted out: that’s the very message they asked you not to send. Record the new opt-in the same way you recorded the opt-out.

Why ignoring opt-outs costs you

• Blocks and reports. People who can’t get you to stop will block you, often picking reasons like “Didn’t sign up” or “No longer needed”.
• Lower quality ratings. Meta rates your number from the last seven days of feedback, including blocks, reports and block reasons, and rates each template on negative feedback and read rates. See WhatsApp quality rating.
• Paused templates. A template that drops to low quality is paused for 3 hours, then 6 hours, then disabled.
• Rate limits and restrictions. Meta says its systems rate-limit businesses whose quality stays low, and the policy allows it to limit or remove access for violations. See WhatsApp account restricted or banned.

More ways to keep blocks down are in how to reduce WhatsApp blocks and spam reports.

Managing opt-outs in Automate AI

• Typed keywords opt people out automatically. When a customer’s whole message is stop, stopall, unsubscribe, unsub, optout, cancel, quit or end (any capitals, punctuation ignored, so “STOP” or “Stop.” count but “don’t stop” doesn’t), the contact is marked as opted out of WhatsApp: campaigns skip them and any drip campaigns they’re in stop.
• Add your own keywords. Owners and managers can add opt-out keywords in Settings › General › Opt-out Settings, such as a word in Hindi or your own phrase. For these added keywords the app can send an editable confirmation reply; the built-in words above opt people out without a reply.
• Button taps are recorded, not acted on. A “Stop promotions” quick-reply tap shows up in Button Clicks, so you can see who tapped it and mark them as opted out, or ask people in the template to type STOP instead.
• Mark anyone by hand. For requests made by phone, email or in store, your team can mark the contact as opted out. The contacts list has an Opted Out filter.
• Create templates in the app, submit them to Meta and see their approval status.
• Use groups, tags and custom fields to record the scope and source of each opt-out or opt-in.
• Drip campaigns stop on reply, so a customer who writes back isn’t sent the rest of the sequence. See drip campaigns and WhatsApp campaigns.