オプトインとオプトアウト
WhatsAppのオプトインとオプトアウトの処理は非常に重要です。WhatsAppは電話番号の品質評価を監視しており、評価が低いとメッセージ送信数の上限が引き下げられる可能性があります。
高品質な評価を維持する方法の1つは、ユーザーがビジネスをブロックしたり報告したりすることを防ぐことです。これは、高品質なメッセージング(ユーザーにとって価値のある内容など)を提供し、メッセージの頻度を管理し、顧客が今後のコミュニケーションの受信をオプトアウトできるようにすることで実現できます。
このページでは、オプトインとオプトアウトの設定方法、および「regex」と「is」修飾子の違いについて説明します。
オプトインは、外部ソースまたはBrazeの方法(SMSやアプリ内メッセージ、ブラウザ内メッセージなど)から取得できます。オプトアウトは、Brazeで設定したキーワードやWhatsAppマーケティングボタンを使用して処理できます。オプトインとオプトアウトの設定に関するガイダンスについては、以下の方法を参照してください。
オプトイン方法
オプトアウト方法
BrazeのWhatsAppチャネルのオプトインを設定する
WhatsAppのオプトインについては、WhatsAppの要件に準拠する必要があります。また、Brazeに以下の情報を提供する必要があります。
- すべてのユーザーの
external_id、電話番号、および更新されたサブスクリプションステータス。これは、SDKを使用するか、/users/trackエンドポイントを通じて電話番号とサブスクリプションステータスを更新することで実行できます。
Brazeは/users/trackエンドポイントの改善をリリースし、サブスクリプションステータスの更新が可能になりました。詳細は購読グループで確認できます。ただし、/v2/subscription/status/setエンドポイントを使用してオプトインプロトコルをすでに作成している場合は、引き続きそちらを使用できます。
Braze外部のオプトイン方法
アプリまたはWebサイト(アカウント登録、チェックアウトページ、アカウント設定、クレジットカード端末)からBrazeへ。
メールやテキストメッセージのマーケティング同意をすでに取得している場合は、WhatsApp用の追加セクションを含めてください。ユーザーがオプトインした後、external_id、電話番号、および更新されたサブスクリプションステータスが必要です。これを行うには、Brazeのインストール方法に応じて、/subscription/status/setエンドポイントを活用するか、SDKを使用します。
外部で構築されたオプトインリスト
以前WhatsAppを使用していた場合、WhatsAppの要件に従ってオプトイン済みのユーザーリストをすでに構築している可能性があります。その場合は、CSVをアップロードするか、以下の情報を使用してAPIでBrazeにインポートしてください。
カスタマーサポートWhatsAppチャネルでのアウトバウンドメッセージ
カスタマーサポートチャネルで、解決済みの問題に対するフォローアップとして、マーケティングメッセージのオプトインを希望するかどうかを尋ねる自動メッセージを送信します。ここでの機能は、選択したカスタマーサポートツールの機能の可用性と、ユーザー情報の保存場所に依存します。
- WhatsApp Businessの電話番号からメッセージリンクを提供します。
- 顧客が「はい」と返信してオプトインを示すクイック返信アクションを提供します。
- カスタムキーワードトリガーを設定します。
- これらのアイデアのいずれかについて、おそらく以下の方法でパスを完了する必要があります。
/users/trackエンドポイントを呼び出してユーザーを更新または作成する/subscription/status/setエンドポイントを活用するか、SDKを使用する
インバウンドWhatsAppメッセージ
顧客にWhatsApp番号へインバウンドメッセージを送信してもらいます。
これは、新しいチャネルで確認メッセージをユーザーに受信させたいかどうかに応じて、CanvasまたはCampaignとして設定できます。
- インバウンドメッセージのアクションベースの配信トリガーを持つCampaignを作成します。
- Webhook Campaignを作成します。Webhookの例については、購読グループを参照してください。
WhatsAppマネージャーのPhone Number > Message Linksから、WhatsAppチャネルに参加するためのURLまたはQRコードを作成できます。
Brazeを活用したオプトイン方法
SMSメッセージ
Canvasで、以下のいずれかの方法を使用して、WhatsAppメッセージの受信をオプトインするかどうかを顧客に尋ねるCampaignを設定します。
- 顧客Segment:米国外の購読済みマーケティンググループ
- カスタムキーワードトリガーの設定
ユーザープロファイルのサブスクリプションステータスの更新については、購読グループを参照してください。
アプリ内またはブラウザ内メッセージ
WhatsAppの利用をオプトインするよう顧客に促すアプリ内メッセージまたはブラウザ内ポップアップを作成します。
Braze SDKとインターフェイスするために、JavaScript「ブリッジ」を使用したHTMLアプリ内メッセージを使用します。WhatsAppサブスクリプショングループIDを必ず使用してください。
電話番号キャプチャフォーム
アプリ内メッセージのドラッグ&ドロップエディターで電話番号キャプチャフォームテンプレートを使用して、ユーザーの電話番号を収集し、WhatsAppサブスクリプショングループを拡大します。
BrazeのWhatsAppチャネルのオプトアウトを設定する
一般的なオプトアウトキーワード
特定の単語をメッセージとして送信したユーザーが今後のメッセージングをオプトアウトできるCampaignまたはCanvasを設定できます。Canvasは、オプトアウトの成功を確認するフォローアップメッセージを含めることができるため、特に有益です。
ステップ 1:「インバウンドWhatsAppメッセージ」トリガーでCanvasを作成する

キーワードトリガーを選択する際は、「Stop」や「No Message」などの単語を含めてください。この方法を選択する場合は、顧客がオプトアウトの単語を知っていることを確認してください。例えば、最初のオプトインを受信した後、「これらのメッセージをオプトアウトするには、いつでも「Stop」とメッセージしてください。」のようなフォローアップ応答を含めます。

ステップ 2:ユーザーのプロファイルを更新する
購読グループで説明されている方法のいずれかを使用して、ユーザーのプロファイルを更新します。
マーケティングオプトアウトの選択
WhatsAppメッセージテンプレートクリエーター内で、「マーケティングオプトアウト」オプションを含めることができます。これを含める場合は、テンプレートがサブスクリプショングループの変更のための後続ステップを持つCanvasで使用されていることを確認してください。
- 「マーケティングオプトアウト」クイック返信を含むメッセージテンプレートを作成します。


- このメッセージテンプレートを使用するCanvasを作成します。
- 前述の例と同じ手順に従いますが、トリガーテキストは「STOP PROMOTIONS」を使用します。
- 購読グループで説明されている方法のいずれかを使用して、ユーザーのサブスクリプションステータスを更新します。
オプトインとオプトアウトのワークフローを設定する
以下の2つの方法で、WhatsAppの「START」と「STOP」キーワード応答ワークフローを設定できます。
ユーザーの更新ステップ
ユーザーの更新ステップは、ユーザーがサブスクリプショングループの電話番号にキーワードを送信した際に、ユーザーの電話番号をWhatsAppサブスクリプショングループに追加できます。
ユーザーの更新ステップは、ユーザーの電話番号がサブスクリプショングループに追加される前にCanvasの次のステップに進むことがないため、競合を回避できます。また、他の方法よりも設定手順が少ないため、Brazeでは一般的にこの方法を推奨しています。
- アクションベースのステップSend a WhatsApp Inbound MessageでCanvasを作成します。Where the message bodyを選択し、Isに「START」と入力します。
「STOP」メッセージの場合は、オプトアウトを確認するメッセージステップとユーザーの更新ステップの順序を逆にしてください。そうしないと、ユーザーが最初にサブスクリプショングループからオプトアウトされ、確認メッセージを受信する資格がなくなります。

- Canvasで、Set Up User Updateステップを作成し、ActionでAdvanced JSON Editorを選択します。

- 以下のJSONペイロードでUser Update objectを入力し、
XXXXXXXXXXXをサブスクリプショングループIDに置き換えます。
1
2
3
4
5
6
7
8
9
10
11
12
{
"attributes": [
{
"subscription_groups": [
{
"subscription_group_id": "XXXXXXXXXXX",
"subscription_state": "subscribed"
}
]
}
]
}
- 後続のWhatsAppメッセージステップを追加します。

考慮事項
Brazeはユーザーの更新ステップのリクエストをバッチ処理するため、更新の完了速度は変動する可能性があります。
2番目のWhatsApp Campaignをトリガーするwebhook Campaign
Webhook Campaignは、ユーザーがサブスクリプショングループの電話番号にキーワードを送信した際に、ユーザーの電話番号をWhatsAppサブスクリプショングループに追加した後、2番目のCampaignへのエントリをトリガーできます。
STOPメッセージにはこの方法を使用する必要はありません。確認メッセージはユーザーがサブスクリプショングループから削除される前に送信されるため、他の2つのステップのいずれかを使用できます。
- アクションベースのステップSend a WhatsApp Inbound MessageでCampaignまたはCanvasを作成します。Where the message bodyを選択し、Isに「START」と入力します。

- CampaignまたはCanvasで、Webhookメッセージステップを作成し、Request BodyをRaw Textに変更します。

- Webhook URLに顧客のエンドポイントURLを入力し、その後にエンドポイントリンク
campaigns/trigger/sendを続けます。例えば、https://dashboard-02.braze.eu/campaigns/trigger/sendのようになります。

- Raw Textに以下のJSONペイロードを入力し、
XXXXXXXXXXXをサブスクリプショングループIDに置き換えます。2番目のCampaignを作成した後にcampaign_idを置き換える必要があります。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"campaign_id": "XXXXXXXXXXX",
"recipients": [
{
"external_user_id": "{{${user_id}}}",
"attributes": {
"subscription_groups": [
{
"subscription_group_id": "XXXXXXXXXXX",
"subscription_state": "subscribed"
}
]
}
}
]
}
- WhatsApp Campaign(2番目のCampaign)を作成し、トリガーをAPIに設定します。この
campaign_idを最初のCampaignのJSONペイロードにコピーしてください。
考慮事項
- Canvas APIトリガーのJSONペイロード内からの属性更新はまだサポートされていないため、WhatsApp応答メッセージ用のWhatsApp Campaignのみをトリガーできます(ステップ2のように)。
- WhatsAppテンプレートは、応答メッセージとして送信するために承認されている必要があります。これは、クイック応答ではインバウンドメッセージトリガーが同じCampaignまたはCanvas内にある必要があるためです。ユーザーの更新ステップを使用する場合は、Metaの承認なしにクイック応答メッセージを送信できます。
「regex」と「is」修飾子の違いを理解する
この表では、修飾子の動作を示すために、トリガーワードの例としてSTOPを使用しています。
| 修飾子 | トリガーワード | アクション |
|---|---|---|
Is |
STOP |
大文字小文字に関係なく、「stop」の完全一致の単語をキャッチします。例えば、「stop」はキャッチしますが、「please stop」はキャッチしません。 |
Matches regex |
STOP |
正確にその大文字小文字での「STOP」の使用をキャッチします。例えば、「STOP」と「PLEASE STOP」はキャッチしますが、「stop」はキャッチしません。 |
Matches regex |
(?i)STOP(?-i) |
大文字小文字に関係なく、「STOP」の使用をキャッチします。例えば、「stop」、「please stop」、「never stop sending me messages」をキャッチします。 |