クラウドAPI

リアクションメッセージ

リアクションメッセージは、ユーザーから受信した直前のメッセージに絵文字でリアクションできる機能です。

制限

リアクションメッセージの送信時は、メッセージ送信済み(sent)のWebhookのみがトリガーされます(statusがsentにセットされます)。メッセージ配信済み(delivered)と既読(read)のWebhookはトリガーされません。

リアクションメッセージの送信

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messagesエンドポイントを使って、WhatsAppユーザーから受け取ったメッセージに絵文字リアクションを返します。

リクエストの構文

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

POSTのボディ

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "reaction",
  "reaction": {
    "message_id": "<WHATSAPP_MESSAGE_ID>",
    "emoji": "<EMOJI>"
  }
}

POSTのボディのパラメーター

プレースホルダー説明値の例

<EMOJI>

文字列

必須。

ユーザーからのメッセージに返す絵文字のUnicodeエスケープシーケンス(または絵文字自体)。

Unicodeエスケープシーケンスの例:

\uD83D\uDE00

絵文字の例:

😀

<WHATSAPP_MESSAGE_ID>

文字列

必須。

絵文字を返したいメッセージのWhatsAppメッセージID。

リアクション対象のメッセージが、30日以上前のものであるか、スレッド内のどのメッセージとも対応しないか、すでに削除されたか、またはそれ自体がリアクションメッセージである場合、リアクションメッセージは配信されず、エラーコード131009が付いたmessages Webhookが届きます。

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

リクエストの例

ユーザーから受信した直前のメッセージに、にっこりの絵文字(😀)を返す場合、リクエストは次のようになります。

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=",
    "emoji": "\uD83D\uDE00"
  }
}'

レスポンスの例

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}