WhatsApp受信メッセージ
双方向通信に WhatsApp を使用する場合、受信メッセージ は Webhook エンドポイントにリアルタイムで配信されます。これらのメッセージは、返信、メディアのアップロード、ボタン操作など、ユーザーが開始したアクションを表します。
受信メッセージの受信
API を使用して受信メッセージを受信するには:
- Webhook が構成され、アクセス可能である必要があります。
- Infobip プラットフォームにアクセス許可を付与する必要があります。
- 承認ヘッダーを使用して、エンドポイントをセキュリティで保護します。
メッセージは、JSON ペイロードを含む HTTPS POST 要求を使用して配信されます。
受信メッセージの種類
WhatsAppは、次の受信メッセージタイプをサポートしています。
| メッセージの種類 | 形容 |
|---|---|
| テキスト | 標準のユーザー送信メッセージ |
| 画像 / 動画 / 音声 | ユーザーのデバイスから送信されたメディアファイル |
| 声 | 録音された音声メモ |
| 文書 | アップロードされたファイル(.pdf、.docx、.xlsxなど) |
| 場所 | 静的位置ピン |
| 接触 | vCard 形式の連絡先カード |
| ボタンの返信 | クイック返信ボタンの操作 |
| 返信リスト | ユーザーによって選択されたリスト項目 |
| 注文メッセージ | WhatsApp Paymentsに関連する注文インタラクション |
| ステッカー / その他のメディア | その他のメディアタイプ(ステッカーやサポートされていない形式など) |
メディアは、WhatsApp APIを使用して30日以内にダウンロードまたは削除できます。
インバウンドメディアを管理する
画像、ビデオ、オーディオ、ドキュメントなど、ユーザーが送信した受信メディアファイルは一時的に保存され、API を介して管理できます。
- メディアは最大 30 日間保存されます。
- この間、必要に応じてメディア をダウンロード (opens in a new tab) または 削除できます (opens in a new tab) 。
- 30 日が経過すると、メディアは自動的に削除され、アクセスできなくなります。
引用符で囲まれたメッセージ
ユーザーは、前のメッセージを引用符で囲んで、応答コンテキストを示すことができます。
ユーザーが特定のメッセージに返信すると、受信ペイロードにはコンテキスト オブジェクトが含まれます。 このオブジェクトには、次のものが含まれます。
id: 引用符で囲まれたメッセージの IDfrom:引用されたメッセージの送信者のWhatsApp ID
見積もりは、ビジネスから送信されたメッセージ(送信メッセージ)でのみサポートされます。受信メッセージや 4 日以上経過したメッセージへの返信は解決されない場合があります。
紹介メッセージ
ユーザーが Instagram の Facebook で Click-to-WhatsApp 広告または投稿をクリックしてメッセージを送信すると、WhatsApp はメッセージペイロードに 参照メタデータ を含めます。
これには以下が含まれます。
- ソースタイプ(広告またはオーガニック投稿)
- Facebook広告ID
- 広告の URL、広告見出し、本文
- クリックごとの一意の識別子
- メディア情報(該当する場合)
製品コンテキスト
ユーザーが製品または複数製品メッセージに返信すると、WhatsAppは受信メッセージに製品メタデータを含めます。 これにより、次の項目を特定できます。
- 製品 ID
- 製品名
- カタログ ID
- サムネイルまたは画像データ
メッセージを既読にする
既読マーク機能を使用すると、受信メッセージをプログラムで確認済みとしてマークできます。これにより、ユーザーのWhatsAppクライアントのメッセージステータスが更新されます。
この機能は 既定では無効 になっています。有効にするには、アカウントマネージャーまたは サポート (opens in a new tab)にお問い合わせください。
有効にしたら、 既読としてマーク (opens in a new tab) API 要求を使用して、受信メッセージを既読としてマークします。