インタラクティブメッセージの送信：ボタンとリスト
インタラクティブメッセージでは、受信者は入力する代わりにボタンやリストをタップできます。種類は返信ボタンとリストメッセージの 2 つで、どちらも固定された小さな制限があり、会話の設計を大きく左右します。
返信ボタン
メッセージの下に最大 3 個のボタンを配置できます。受信者が 1 つをタップすると、ボタンの id を含む通常の受信メッセージとして返信が Webhook に届きます。そのため、ラベルではなく id で照合してください。タイトルは 20 文字までで、思ったより短く、通常は書き直しが必要になる制約です。
- 1 メッセージあたり最大 3 個のボタン
- タイトルは 20 文字まで
- 各ボタンには任意の id を設定でき、返信で返される
- 周囲に任意のヘッダー、本文、フッターを配置できる
リストメッセージ
1 個のボタンから、最大 10 行のメニューを開けます。メニューは最大 10 セクションに分けられます。各行にはタイトル、任意の説明、id を設定できます。ボタン 3 個では足りない場合に使ってください。受信者はリストを開くまで内容を見られないため、ボタンのラベルが重要です。
- 合計最大 10 行、最大 10 セクション
- 行タイトルは 24 文字まで、説明は 72 文字まで
- 1 メッセージにつき 1 リストで、ボタンとは組み合わせられない
- すべてのカテゴリのメッセージテンプレートで利用できるわけではない
返信の届き方
他の受信メッセージと同じ messages Webhook に、ボタンまたは行の id を示す interactive オブジェクトが届きます。別の購読設定は必要ありません。
タイトルではなく id で照合してください。タイトルはコピーを編集する人によって書き換えられます。テキストで照合するハンドラーは、誰かが誤字を直した瞬間に静かに動かなくなります。
Coexistence で変わること
ボタンとリスト自体については何も変わりません。通常の Cloud API メッセージとして、Coexistence の番号でも他の番号と同じように機能します。
変わるのは返信の届く場所です。Coexistence の番号では、顧客のタップがスマートフォンの WhatsApp Business アプリと Webhook の両方に届きます。自動返信するハンドラーでは、アプリ上で人が同じメッセージに返信する可能性も考慮してください。
よくある間違い
- ボタンタイトルで返信を照合する。タイトルは編集されますが、id は変わりません。
- 3 個を超えるボタンを前提に設計する。この上限は固定で、回避策はありません。
- 同じタップに人が WhatsApp Business アプリから返信する可能性を忘れる。
EasyCoexistence はインタラクティブ返信を含むメッセージイベントを Meta からエンドポイントへ直接転送するため、ボタンのタップが id を保持したままシステムに届きます。
よくある質問
送信できるボタンの数は？
3 個です。固定されたプラットフォーム上限で、回避策はありません。
タップすると何が返りますか？
ボタンまたは行に設定した id を含む、messages Webhook 上の通常の受信メッセージです。
ボタンとリストは組み合わせられますか？
いいえ。1 メッセージにはどちらか一方だけを含められます。
追加料金はかかりますか？
いいえ。通常のメッセージとして、同じ会話内の他のメッセージと同じく Meta の料金体系で課金されます。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日