SMQ または HTTP プッシュで MT 配信と MO 返信を受信 - Chat App Message Service

Chat App Message Service API を使用してメッセージを送信した後、Simple Message Queue (SMQ) 消費モードまたは HTTP バッチプッシュモードのいずれかを通じて、ステータス更新とユーザーからの返信を受信できます。

注意事項

ネットワークの例外や応答タイムアウトにより、レシートの重複プッシュや取得の失敗が発生する可能性があります。

メッセージレシートは、SMQ 消費モードまたは HTTP バッチプッシュモードで受信できます。ニーズに最も適したモードを選択してください。

重要

メッセージレシートのべき等性は保証されません。メッセージレシートを受信した後、データの精度と一貫性を確保するために適切な対策を講じることを推奨します。

SMQ 消費モード
SMQ 消費モードは、SMQ のキューを使用して、特定のリージョンのメッセージレシートを受信します。すべてのサービスメッセージは SMQ を通じて外部に送信できます。Chat App Message Service コンソールで SMQ を有効にし、特定のメッセージタイプをサブスクライブすると、システムはそのタイプ専用のメッセージキューとキュー名を自動的に作成します。その後、SDK を使用して、対応するキュー名とメッセージタイプでキューからメッセージステータスレポートを取得できます。
HTTP バッチプッシュモード
HTTP バッチプッシュモードは、HTTP POST リクエストを介して、指定された Web URL にデータを送信します。Chat App Message Service コンソールで HTTP コールバック URL を設定すると、システムはモバイル発信 (MO) メッセージやモバイル着信 (MT) 配信通知などのサービスメッセージを、指定した URL にプッシュします。

レシートモードを選択した後、受信したい特定のタイプのレシートをサブスクライブします。利用可能なタイプは、メッセージの配信やユーザーからの返信など、特定のイベントに対応しています。

タイプ	説明	SMQ 消費モード	HTTP バッチプッシュモード
ChatAppInbound (MO メッセージレシート)	MO メッセージは、エンドユーザーからご利用のビジネス番号に送信されるメッセージです。ChatAppInbound をサブスクライブすることで、これらのユーザーメッセージの内容を取得できます。	ChatAppInbound	ChatAppInbound
ChatAppStatus（MTメッセージ受信）	MO メッセージに対応するのが、ユーザーに送信される MT メッセージです。ChatAppStatus をサブスクライブすることで、各メッセージの配信ステータスを追跡できます。	ChatAppStatus	ChatAppStatus
ChatAppAudit (テンプレート審査ステータス)	`CreateChatappTemplate` API を呼び出した後、テンプレートの審査ステータスを通知します。	ChatAppAudit	ChatAppAudit

メッセージレシートを受信するには、まず Chat App Message Service コンソールでレシートを有効にする必要があります。

Chat App Message Service コンソールにログインします。
左側のナビゲーションウィンドウで、Channel Management を選択します。次に、チャネル ID をクリックするか、Manage 列の [管理] をクリックします。
チャネルの Data Panel ページで、ナビゲーションツリーからご利用のチャネルタイプに対応する機能をクリックします。
1. WhatsApp チャネル： WABA Management > Configure Webhook を選択します。
2. Viber チャネル： Service Number Management > Webhook Settings を選択します。
3. Messenger チャネル： Facebook Homepage > Configure Webhook を選択します。
4. Instagram チャンネル：[Professional Account］＞ [Configure Webhook] を選択してください。

サブスクライブしたいメッセージを設定します。
1. ページ、アカウント、またはサービス ID が接続された後、Configure Webhook をクリックし、サブスクライブしたいメッセージを選択します。
  説明
  [ステータスレポートコールバック URL]： ChatAppStatus (MT メッセージレシート) 用です。
  [MO メッセージコールバック URL]： ChatAppInbound (MO メッセージ) 用です。
HTTP Protocol を有効にし、コールバック URL を入力します。例：
説明
メッセージタイプごとに異なる URL パスを使用することを推奨します。これにより、メッセージの区別が簡単になります。すべてのメッセージタイプを単一の URL に指定し、メッセージ本文の解析を必要とする構成は避けてください。
1. Status Report Callback URL フィールドに、コールバック URL を入力します。例： https://xxxx.com/appstatus
2. MO Message Callback URL フィールドに、コールバック URL を入力します。例： https://xxxx.com/inbound
Message Queue Monitoring を有効にし、[OK] をクリックします。
再度 Configure Webhook をクリックします。表示されるダイアログボックスで、Message Receipt Queue と MO Message Queue の名前をコピーできます。

説明

テンプレート審査ステータスメッセージの設定は、WhatsApp チャネルのみがサポートしています。

Chat App Message Service コンソールにログインします。
左側のナビゲーションウィンドウで、Channel Management を選択します。次に、チャネル ID をクリックするか、Manage 列の [管理] をクリックします。
チャネルの Data Panel ページで、WABA Management > Channel Webhook Settings を選択します。
HTTP Protocol を有効にします。
1. Notification Callback URL：コールバック URL を入力します。例： https://xxxx.com/appaudit
2. Message Queue Monitoring を有効にし、[OK] をクリックします。
再度 Channel Webhook Settings をクリックします。表示されるダイアログボックスで、Notification Queue の名前をコピーできます。

SMQ Java SDK をダウンロードして、SMQ メッセージをプルできます。

ダウンロードリンク： SMQ Java SDK