雲端 API

心情回應訊息

心情回應訊息是各種表情符號心情回應，可以套用至您之前收到的 WhatsApp 用戶訊息。

限制

您傳送心情回應訊息時，系統只會觸發已傳送訊息 Webhook（status 設定為 sent），而不會觸發已送達和已讀訊息 Webhook。

傳送心情回應訊息

使用 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"
    }
  ]
}