API Đám mây

Tin nhắn cảm xúc

Tin nhắn cảm xúc là các biểu tượng cảm xúc mà bạn có thể áp dụng cho tin nhắn trước đó mình nhận được từ người dùng WhatsApp.

Giới hạn

Khi bạn gửi tin nhắn cảm xúc, chỉ webhook tin nhắn đã gửi (status được đặt thành sent) mới được kích hoạt; webhook tin nhắn đã gửi và đã đọc sẽ không được kích hoạt.

Gửi tin nhắn cảm xúc

Sử dụng điểm cuối POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages để áp dụng biểu tượng cảm xúc cho tin nhắn bạn nhận được từ người dùng WhatsApp.

Cú pháp yêu cầu

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Nội dung yêu cầu POST

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

Thông số nội dung yêu cầu POST

Phần giữ chỗMô tảGiá trị mẫu

<EMOJI>

Chuỗi

Bắt buộc.

Chuỗi thoát Unicode của biểu tượng cảm xúc hoặc chính biểu tượng cảm xúc đó để áp dụng cho tin nhắn của người dùng.

Ví dụ về chuỗi thoát Unicode:

\uD83D\uDE00

Ví dụ về biểu tượng cảm xúc:

😀

<WHATSAPP_MESSAGE_ID>

Chuỗi

Bắt buộc.

ID tin nhắn WhatsApp của tin nhắn bạn muốn áp dụng biểu tượng cảm xúc.

Nếu tin nhắn mà bạn muốn bày tỏ cảm xúc đã quá 30 ngày, không tương ứng với bất kỳ tin nhắn nào trong cuộc trò chuyện, đã bị xóa hoặc chính tin nhắn đó cũng là tin nhắn cảm xúc, hệ thống sẽ không gửi tin nhắn cảm xúc của bạn và bạn sẽ nhận được webhook tin nhắn kèm theo mã lỗi 131009.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Ví dụ về yêu cầu

Ví dụ về yêu cầu áp dụng biểu tượng cảm xúc cười nhe răng (😀) cho tin nhắn người dùng đã nhận trước đó.

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"
  }
}'

Ví dụ về phản hồi

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