Cloud API

Reaction-Nachrichten

Reaction-Nachrichten sind Emoji-Reactions, die du auf zuvor erhaltene Nachrichten von WhatsApp-Nutzer*innen anwenden kannst.

Einschränkungen

Wenn du eine Reaction-Nachricht sendest, wird nur der Webhook für gesendete Nachrichten (status festgelegt als sent) ausgelöst. Die Webhooks für ausgelieferte und gelesene Nachrichten werden nicht ausgelöst.

Reaction-Nachrichten senden

Mit dem Endpunkt POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages kannst du eine Emoji-Reaction auf eine Nachricht anwenden, die du von einem*einer WhatsApp-Nutzer*in erhalten hast.

Anfragesyntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

POST-Body

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

Parameter für POST-Body

PlatzhalterBeschreibungBeispielwert

<EMOJI>

String

Erforderlich.

Unicode-Escape-Sequenz des Emojis oder das Emoji selbst, die/das auf die Nachricht angewendet wird.

Beispiel einer Unicode-Escape-Sequenz:

\uD83D\uDE00

Beispiel-Emoji:

😀

<WHATSAPP_MESSAGE_ID>

String

Erforderlich.

WhatsApp-Nachrichten-ID der Nachricht, auf die du das Emoji anwenden möchtest.

Wenn die Nachricht, auf die du reagierst, mehr als 30 Tage alt ist, keiner Nachricht in der Unterhaltung entspricht, gelöscht wurde oder selbst eine Reaction-Nachricht ist, wird die Reaction-Nachricht nicht zugestellt. Dann erhältst du einen messages-Webhook mit dem Fehlercode 131009.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Beispielanfrage

Beispielanfrage, um das lachende Emoji (😀) auf eine erhaltene Nutzer*innen-Nachricht anzuwenden.

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

Beispielantwort

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