STOP と配信停止のメッセージを自動で処理する
WhatsApp の STOP メッセージを自動で処理するには、STOP とその表記ゆれをメッセージ全体の完全一致で検出するキーワードの自動化を設定します。確認メッセージを返し、Webhook を呼び出して、自社のリストでその連絡先を配信停止済みとして記録します。Meta のポリシーでは配信停止の要求に応じることが求められており、キーワードの自動化はキャッチオールの返信より先に実行されるため、AI の返信が代わりに応答することはありません。
easyCoexistence は、アプリで使っている WhatsApp Business の番号を Coexistence 経由で Meta の Cloud API に接続し、STOP に数秒で応答するキーワードの自動化を実行します。
1 つの自動化で最大 30 件の表記を照合でき、そのうちどれか 1 つに一致すれば十分です。大文字と小文字は区別されません。
メッセージ全体がキーワードと一致したときだけ実行されるキーワードモードです。前後の空白は取り除かれます。
Meta のポリシーでは、どのチャネルから届いたものであっても、配信停止やメッセージ停止の要求を尊重することが事業者に求められています。
Meta は、マーケティング配信の停止をお客様が選べるボタンを、クイックリプライボタンの一般的な用途として挙げています。
「お知らせとオファー」でマーケティング配信を停止している相手に送信されたマーケティングテンプレートは、ステータスが失敗となります。
Meta は、お客様の配信停止の希望を確認することを、ユーティリティメッセージの例として挙げています。
STOP の自動化はどのように動作しますか?
2 つのステップからなるキーワードの自動化で、他の自動化と同じ番号上で動作します。キーワードの自動化が先に判定され、各メッセージには 1 つの自動化だけが応答するため、STOP が AI のキャッチオールや歓迎メッセージに渡されることはありません。お客様には数秒で確認が届き、自社システムはキャンペーンが参照する場所に配信停止を保存します。
どの語を照合させるべきですか?
通常の文に誤って反応しないよう、短い語は「完全一致」で設定します。「含む」で stop を指定すると、nonstop や don't stop the updates にも反応してしまいます。完全一致は大文字・小文字と前後の空白を無視しますが、句読点は無視しません。そのため STOP. には別の登録が必要です。最大 30 件のキーワードを登録でき、3 言語分に十分な数です:
- 英語: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」は単独では登録しないでください。お客様は注文のキャンセルにも同じ語を使うためです。
自動化はどのような構成になりますか?
これは create_automation を通じて AI が作成する自動化、またはエディターの「Keyword reply」の例から組み立てる自動化と同じものです。確認メッセージが先に送られるため、自社システムが遅くても、お客様には返信が届きます。その後に Webhook が配信停止を記録します。opted_out などの Tag ステップを追加すると、その連絡先は easyCoexistence 内でも配信停止の印を持ち、「会話」や任意の条件から確認できます。エンドポイントが reply フィールドのない HTTP 200 を返すと、それ以上は何も送信されません。失敗した場合は、実行が「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 と送らずに配信停止する方法は?
ほかに 3 つの方法があり、そのうち 2 つはチャットに届きません。「Stop promotions」のクイックリプライボタンをタップすると、そのテキストのメッセージとして届くため、ラベルがキーワードに登録されていれば同じ自動化が応答します。WhatsApp の「お知らせとオファー」設定でオファーをオフにしても、何も送られてきません。次のマーケティングテンプレートはエラー 131050 で失敗します。メッセージが easyCoexistence を経由していて Forward URL が設定されていれば、その失敗ステータスが自社システムに届くので、同じフラグを設定すべきです。番号をブロックすると配信がすべて止まります。Meta のポリシーは、メール、電話、対面での配信停止も対象としているため、すべてのチャネルが同じリストに書き込むべきです。
再び購読するには、どうすればよいですか?
最初の自動化と対になる、2 つ目のキーワードの自動化を使います。条件は「Has keyword」「Is exactly」で START、subscribe、voltar、alta を指定します。次に「Reply with text」ステップで、お客様が再び受け取る内容を確認し、事業者名を示します。さらに「Call my webhook」ステップでフラグを解除します。START と書いたお客様は、ご自身の言葉で許可を与えているので、その時刻とメッセージを新しい同意の記録として保存してください。配信停止の確認メッセージに 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.
よくある間違い
- 「含む」で「stop」や「sair」を指定すること。「含む」は長い文の中の一致も対象になるため、「今日は立ち寄れません」のような文でも、配信停止を望んでいないお客様が登録解除されてしまいます。
- 「Reply with text」ステップの後で、配信停止のエンドポイントから {"reply": "..."} を返すこと。自動化が両方を送信するため、お客様には確認が 2 回届きます。
- 配信停止を WhatsApp のチャットにだけ記録すること。別のリストを読まないツールからキャンペーンを送信すると、次の送信で停止を求めた人に届いてしまいます。
- エラー 131050 で失敗したマーケティングテンプレートを再送信すること。この人は WhatsApp でオファーをオフにしています。再送信はエラーを増やし、ブロックされるリスクを高めるだけです。
署名付きの「Call my webhook」ステップで配信停止を自社システムに引き渡し、そのステップが失敗した場合はメールで通知します。自動化の追加料金はかかりません。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。
よくある質問
お客様が STOP と書くと、WhatsApp でビジネスが制限されますか?
いいえ。STOP は通常のメッセージで、WhatsApp 自体はこれを処理しないため、停止するかどうかは事業者側に委ねられています。そのため自動化がそれを記録します。お客様は番号をブロックしたり、WhatsApp でオファーをオフにしたりすることもでき、その場合は Meta 側で配信が止まります。
お客様が STOP と書いたら、注文の更新も止めるべきですか?
STOP が何をカバーするかを決め、確認メッセージでそれを明記してください。Meta のオプトインに関するガイダンスでは、特定のカテゴリーの配信停止について明確な手順を示すことが推奨されています。そのため、よくある選択は、STOP でオファーを止め、注文の更新は継続し、すべてを止める別のキーワードを設けることです。
AI は、文章で書かれた配信停止の依頼を処理できますか?
応答はできますが記録はできません。「Reply with AI」ステップはテキストを書くだけです。AI エージェントは、opted_out など許可されたタグを追加したり、依頼が明確なときに STOP の自動化を開始したりできます。また、「unsubscribe me」のような長い表現のために、「含む」モードで 2 つ目のキーワードの自動化を作成することもできます。どちらも同じ 2 つのステップで構成します。
お客様が営業時間外に STOP と書いたらどうなりますか?
STOP の自動化は引き続き応答します。キーワードの自動化は、「After hours」「First message」「Every message」の自動化より先に判定されるため、不在時の返信が代わりに配信停止に応答することはありません。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日