클라우드 API

공감 메시지

공감 메시지는 수신한 이전 WhatsApp 사용자 메시지에 적용할 수 있는 이모티콘 공감 기능입니다.

제한 사항

공감 메시지를 전송할 때 메시지 전송 Webhooks(status가 sent로 설정됨)이 트리거됩니다. 전달됨 및 읽음 메시지 Webhooks은 트리거되지 않습니다.

공감 메시지 전송하기

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>

문자열

필수 항목.

사용자 메시지에 적용되는 이모티콘의 유니코드 이스케이프 시퀀스 또는 이모티콘입니다.

유니코드 이스케이프 시퀀스 예:

\uD83D\uDE00

이모티콘 예:

😀

<WHATSAPP_MESSAGE_ID>

문자열

필수 항목.

이모티콘을 적용하려는 메시지의 WhatsApp 메시지 ID입니다.

공감하는 대상인 메시지가 게시된 지 30일 넘게 지났거나 대화 내에서 어떤 메시지와도 대응되지 않았거나 삭제되었거나 그 자체가 공감 메시지인 경우, 공감 메시지는 전송되지 않고 오류 코드 131009가 포함된 메시지 Webhooks를 수신하게 됩니다.

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