云端 API

心情消息

心情消息属于表情心情，可应用于您之前收到的 WhatsApp 用户消息。

限制

发送心情消息后，只会触发已发送消息的 Webhook（status 设置为 sent）；不会触发已送达和已读消息的 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 消息编号。

如果您要对某一消息留下心情，但该消息属于以下情况之一：发生在 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"
    }
  ]
}