自动处理 STOP 和退订消息
要自动处理 WhatsApp 上的 STOP 消息,请设置一个关键词自动化:它仅在整条消息与 STOP 及其变体完全一致时触发,回复确认信息,并调用 Webhook,在您自己的名单中将联系人标记为已退订。Meta 的政策要求尊重退订请求,而关键词自动化会先于兜底回复运行,因此 AI 回复不会代为处理这类消息。
easyCoexistence 通过 Coexistence 将您保留在应用中的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并运行关键词自动化,在几秒内回应 STOP。
每个自动化最多可匹配 30 个关键词,匹配其中任意一个即可触发,且大小写不影响结果。
“完全匹配”模式:仅当整条消息与某个关键词相同(去掉前后空格后)时才运行。
Meta 的政策要求企业尊重退订或停止接收消息的请求,无论这些请求来自哪个渠道。
Meta 列举的快速回复按钮常见用途之一,是让客户退订营销消息。
向在 “Offers and announcements” 中已停止接收营销消息的用户发送营销模板,状态会显示为 Failed。
Meta 将确认客户的退订偏好列为实用类消息的示例之一。
STOP 自动化如何运作?
这是一个包含两个步骤的关键词自动化,与您的其他自动化位于同一个号码上。关键词自动化会优先检查,且每条消息只由一个自动化作出回复,因此 STOP 不会交给您的 AI 兜底回复或欢迎消息处理。客户会在几秒内收到确认,而您自己的系统会保存退订记录,供营销活动读取。
自动化应匹配哪些词?
请使用简短的词并选择 “Is exactly”,这样普通句子不会误触发:若使用 “Contains” 匹配 “stop”,那么 “nonstop” 和 “don't stop the updates” 也会被触发。“Is exactly” 会忽略大小写和文字两端的空格,但不忽略标点,因此 “STOP.” 需要单独添加一项。最多可添加 30 个关键词,足以覆盖三种语言:
- 英语:stop、stop.、unsubscribe、opt out、stop promotions、no more messages。
- 葡萄牙语:parar、pare、sair、descadastrar、não quero mais、cancelar inscrição。
- 西班牙语:baja、darme de baja、no más mensajes、detener、cancelar suscripción。
- 与您模板中写法完全一致的按钮文字,例如 “Stop promotions”。
- 单独的 “cancel” 和 “cancelar” 应排除在外,因为客户也用这些词取消订单。
自动化看起来是什么样子?
这就是 AI 通过 create_automation 创建的自动化,也是您在编辑器中依据 “Keyword reply” 示例搭建的自动化。确认消息会先发送,因此即使您的系统响应较慢,客户也能立即收到回复;Webhook 随后记录退订。您可以添加一个 Tag 步骤,例如 opted_out,这样该联系人在 easyCoexistence 内部也会带有退订标记,Conversations 和任何条件都能看到它。您的端点需返回 HTTP 200 且不包含 reply 字段,这样就不会再发送任何消息。如果调用失败,该运行会被标记为 Failed,并向您发送邮件,以便您手动记录这次退订。
{
"connection_id": "<from list_numbers>",
"name": "Opt-out: STOP",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "keyword",
"keyword_mode": "exact",
"keywords": ["stop", "stop.", "unsubscribe", "stop promotions",
"parar", "sair", "descadastrar", "baja", "darme de baja"]
},
"steps": [
{ "type": "reply_text",
"text": "Done, {{first_name}}. Bloom Store will not send you offers on WhatsApp anymore. Order updates still arrive. Reply START to subscribe again." },
{ "type": "call_webhook",
"url": "https://example.com/hooks/whatsapp-opt-out" }
]
}您的系统会接收并存储什么?
系统会收到一个 JSON POST 请求,其 X-EC-Signature 请求头使用自动化的 Signing secret 签名,该密钥显示在 “Call my webhook” 步骤中。重要字段包括:contact.wa_id(客户的国际格式号码)、message.text(客户发送的词)、message.at 和 automation.name。请先验证签名,然后在营销活动读取的 CRM、数据库或表格中,为该电话号码设置退订标记,并记录时间和关键词。当 dry_run 为 true 时跳过写入,这表示来自 “Try it” 的测试。easyCoexistence 的联系人保存字段和标签,但从不用于驱动您的营销活动,因此您的发送工具所读取的那条记录才是有效的依据。
客户如何在不发送 STOP 的情况下退订?
还有三种方式,其中两种不会进入聊天。点击 “Stop promotions” 快速回复按钮,会以带有该文字的消息形式到达,因此只要该文字在关键词中,同一个自动化即可回复。在 WhatsApp 的 “Offers and announcements” 设置中关闭优惠后,您不会收到任何通知;下一封营销模板会因错误 131050 而失败。若消息通过 easyCoexistence 路由并设置了 Forward URL,则失败状态会送达您的系统,此时系统应设置相同的标记。屏蔽该号码会完全停止投递。Meta 的政策还涵盖通过电子邮件、电话或当面提出的退订,因此所有渠道都应写入同一份名单。
客户如何重新订阅?
通过一个与第一个自动化相对应的第二个关键词自动化。它包含:“Has keyword”、“Is exactly”,关键词为 START、“subscribe”、“voltar” 和 “alta”;一个 “Reply with text” 步骤,用于确认客户将再次收到的内容并注明您的企业名称;以及一个用于清除标记的 “Call my webhook” 步骤。写下 START 的客户是以自己的话表达了许可,因此应将时间和消息存为新的同意记录。请在 STOP 的确认消息中提及 START,让客户知道如何重新订阅。
设置方法
- Build the opt-out endpointExpose an HTTPS endpoint, or an n8n Webhook node, that verifies X-EC-Signature, sets the opted-out flag for contact.wa_id and returns HTTP 200 with no reply.
- Create the STOP automationStart from Keyword reply, set Has keyword to Is exactly, add the words and button labels, write the confirmation, then add Call my webhook with your URL. Set the switch to Off.
- Copy the Signing secretSave the automation, select its Call my webhook step and copy the Signing secret into your endpoint's configuration.
- Test the wordsClick Test and send "STOP", "stop." and "please don't stop" in Try it: the first two should run, the third should not. Then switch it On and save.
- Add START and the status checkCreate the START automation, and have your system treat failed statuses with error 131050 as an opt-out from marketing.
常见错误
- 使用 Contains 匹配 “stop” 或 “sair”。Contains 会匹配较长句子中的内容,因此 “I can't stop by today” 会让从未提出要求的客户被退订。
- 在 Reply with text 步骤之后,从退订端点返回 {"reply": "..."}。自动化会同时发送两条消息,客户会收到两条确认。
- 只在 WhatsApp 聊天中记录退订。如果营销活动通过从不读取该名单的其他工具发出,下一次发送就会打扰到已要求停止的人。
- 对因错误 131050 失败的营销模板进行重试。该用户已在 WhatsApp 中关闭了您的优惠;重试只会增加错误,并可能导致账号受限。
该自动化还包含一个已签名的 “Call my webhook” 步骤,将退订交给您自己的系统;如果该步骤失败,您会收到邮件通知。自动化功能不另外收费。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,并提供前 3 天免费试用。
常见问题
写下 STOP 会让我的业务无法在 WhatsApp 上发送消息吗?
不会。STOP 只是一条普通消息,WhatsApp 本身不会对它做任何处理,因此是否停止发送由您决定。这正是自动化要记录它的原因。客户也可以屏蔽该号码或在 WhatsApp 中关闭您的优惠,这些操作会在 Meta 一侧停止投递。
客户写下 STOP 时,订单更新是否应当停止?
请先决定 STOP 涵盖的范围,并在确认消息中说明。Meta 的选择加入指南建议为退订特定类别提供清晰的说明,因此常见做法是:STOP 结束优惠,但订单更新继续,同时另设一个关键词用于停止全部消息。
我的 AI 能否处理以完整句子写成的退订请求?
它可以回复这类请求,但无法记录:Reply with AI 步骤只会写入文本。AI 智能体可以添加您允许的标签(例如 opted_out),或在请求明确时启动您的 STOP 自动化;您也可以另建一个 Contains 模式的第二个关键词自动化,用于 “unsubscribe me” 之类较长的表达,并包含相同的两个步骤。
如果客户在营业时间之外写下 STOP 会怎样?
STOP 自动化仍会回复。关键词自动化会先于 “After hours”、“First message” 和 “Every message” 自动化运行,因此离线消息不会代替它回复退订。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间