すべてのプロダクト
Search

このプロダクト

    Chat App Message Service:メッセージレシートとその設定

    ドキュメントセンター

    Chat App Message Service:メッセージレシートとその設定

    最終更新日:Jun 22, 2026

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

    注意事項

    接続不良や応答タイムアウトなどのネットワーク問題により、メッセージレシートが重複したり、取得できなくなったりすることがあります。

    メッセージレシートモード

    メッセージレシートは、SMQ 消費モードと HTTP バッチプッシュモードの 2 つのモードで受信できます。用途に応じて最適なモードを選択してください。

    重要

    メッセージレシートはべき等性を保証しません。データ整合性と一貫性を確保するために、重複の可能性に対応する必要があります。レシート処理ロジックをべき等に設計することを推奨します。

    • SMQ 消費モード

      SMQ 消費モードでは、SMQ キューを使用して特定のリージョンのメッセージレシートを受信します。すべてのビジネスメッセージは、SMQ を介したアウトバウンド配信をサポートしています。Chat App Message Service コンソールで SMQ を有効にし、特定のメッセージタイプ (MessageType) をサブスクライブすると、システムは自動的に専用のメッセージキューを作成し、キュー名 (QueueName) を生成します。その後、この QueueName と MessageType を使用してバックエンドから SDK を呼び出し、キューからレシートを取得できます。

    • HTTP バッチプッシュモード

      HTTP バッチプッシュモードでは、システムは HTTP POST リクエストを使用して指定された URL にデータを送信します。Chat App Message Service コンソールでコールバック URL (callback_url) を設定すると、システムは MO メッセージやステータスレポートなどのメッセージレシートをその URL に自動的にプッシュします。

    メッセージレシートのタイプ

    レシートモードを選択した後、通知を受けたいイベントのメッセージタイプをサブスクライブする必要があります。次のメッセージタイプが利用可能です。

    タイプ

    説明

    SMQ 消費モード

    HTTP バッチプッシュモード

    ChatAppInbound (MO メッセージ)

    エンドユーザーからお客様のビジネス番号に送信されたメッセージを取得します。

    ChatAppInbound

    ChatAppInbound

    ChatAppStatus (MT メッセージのステータスレポート)

    お客様がエンドユーザーに送信するアウトバウンドメッセージ (MT メッセージ) の配信ステータスを追跡します。

    ChatAppStatus

    ChatAppStatus

    ChatAppAudit (テンプレートの審査ステータス)

    CreateChatappTemplate API を使用して作成されたテンプレートの審査ステータスに関する通知を受信します。

    ChatAppAudit

    ChatAppAudit

    メッセージレシートモードの設定

    ステータスレポートと MO メッセージの設定

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

    1. Chat App Message Service コンソールにログインします。

    2. 左側のナビゲーションペインで、チャンネル管理 をクリックします。対象のチャネルを見つけ、管理 列の 管理 をクリックします。

    3. チャネルの データパネル ページで、チャネルのタイプに応じて Webhook の設定に移動します：

      1. WhatsApp チャネルの場合、WABA 管理 > Webhook の設定 をクリックします。

      2. Viber チャネルの場合、サービス番号管理 > Webhook設定 をクリックします。

        image

      3. Messenger チャネルの場合、パブリックホームページ > Webhook の設定 をクリックします。

      4. Instagram チャネルの場合、プロフェッショナルアカウント > Webhook の設定 をクリックします。

    1. メッセージのサブスクリプションを設定します。

      1. ページ、アカウント、またはサービス番号の接続後、Webhook の設定 をクリックして、サブスクライブするメッセージタイプを選択します。

        説明

        ステータスレポートのコールバック URL：ChatAppStatus (MT メッセージのステータスレポート) に対応します。

        MO メッセージのコールバック URL：ChatAppInbound (MO メッセージ) に対応します。

        ダイアログボックスには、[HTTP Protocol] と [メッセージキューのモニタリング] の切り替えスイッチ、および [メッセージレシートキュー] と [MO メッセージキュー] のフィールドも表示されます。設定が完了したら、[OK] をクリックします。

    2. HTTP プロトコル を有効にし、ステータスレポートと MO メッセージのコールバック URL を入力します。例：

      説明

      ベストプラクティス：区別を容易にするため、サーバー上でメッセージタイプごとに異なる URL パス (例：https://xxxx.com/appstatus) を使用します。



      非推奨：すべてのメッセージタイプを単一の URL にルーティングし、リクエストボディを解析してタイプを識別する方法は避けてください。






















      1. ステータスレポート Webhook アドレス フィールドに、https://xxxx.com/appstatus などの URL を入力します。

      2. メッセージ受信 Webhook アドレス フィールドに、https://xxxx.com/inbound などの URL を入力します。

    3. メッセージキューモニタリング を有効にして [OK] をクリックします。

    4. 再度 Webhook の設定 をクリックします。表示されるダイアログボックスで、ステータス通知メッセージキュー と モバイル発信メッセージキュー の名前をコピーします。

    テンプレートの審査ステータスメッセージの設定

    説明

    現在、この機能は [WhatsApp] チャネルのみに対応しています。

    1. Chat App Message Service コンソールにログインします。

    2. 左側のナビゲーションペインで、チャンネル管理 をクリックします。対象のチャネルを見つけ、管理 列の 管理 をクリックします。

    3. チャネルの データパネル ページで、左側のナビゲーションペインで WABA 管理 > チャンネル Webhook 設定項目 をクリックします。

    4. HTTP プロトコル を有効にし、通知コールバック URL を入力します。

      1. 通知 Webhook アドレス フィールドに URL を入力します。例：https://xxxx.com/appaudit

      2. メッセージキューモニタリング を有効にして [OK] をクリックします。

      [Channel Webhook Settings] ダイアログボックスで [メッセージキューのモニタリング] を有効にすると [Notification Queue] フィールドが表示され、キュー名をコピーできます。必要に応じて [API version] を選択することもできます。

    5. 再度 チャンネル Webhook 設定項目 をクリックします。表示されるダイアログボックスで、通知キュー 名をコピーします。

    SMQ SDK のダウンロード

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

    SDK のダウンロード： SMQ Java SDK