雲端 API

心情回應訊息

心情回應訊息是指表情符號心情，您可以將其套用到先前收到的 WhatsApp 用戶訊息。

限制

傳送心情回應訊息時，只有已發送訊息 Webhook（status 設定為 sent）會觸發；已送達和已讀訊息 Webhooks 則不會觸發。

傳送心情回應訊息

使用 POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages 端點將表情符號心情回應套用到您收到的 WhatsApp 用戶訊息。

要求語法

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

張貼內容

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

張貼內容參數

預留位置說明範例值

<EMOJI>

字串

必要項目。

套用到用戶訊息的表情符號或表情符號本身的 Unicode 逸出序列。

Unicode 逸出序列範例：

\uD83D\uDE00

表情符號範例：

😀

<WHATSAPP_MESSAGE_ID>

字串

必要項目。

要套用表情符號的訊息的 WhatsApp 訊息編號。

如果您要傳送心情回應的訊息已超過 30 天、無法對應對話中的任何訊息、已刪除，或其本身就是心情回應訊息，則該心情回應訊息將不會成功送達，而且您會收到錯誤代碼為 131009 的訊息 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"
    }
  ]
}