---
title: "Triggered when a WhatsApp message reaction is set or cleared."
method: POST
path: "message:reaction"
tags: ["messages"]
---

# Triggered when a WhatsApp message reaction is set or cleared.

`POST message:reaction` (webhook)

## Payload

- ReactionData
  - `event_type` 'message:reaction', required — Webhook event name
  - `chat` ReactionDataChatInfo, required
    - `full_name` string, required
    - `chat_url` string, required
    - `chat_id` integer, required
    - `chat_type` 'direct' | 'group', required — Chat type: direct or group
    - `platform` 'whatsapp', required — Messaging platform
    - `phone` string, required — Bare digits (no + prefix) for direct chats; empty string for groups.
    - `responsible_name` string
    - `responsible_email` string
  - `whatsapp_account` ReactionDataWhatsappAccountInfo, required
    - `full_name` string, required
    - `email` string, required
    - `phone` string, required
    - `whatsapp_account_wid` string, required — WhatsApp account WID
  - `reaction` ReactionInfo, required
    - `message_uid` string, required — UID of the message that was reacted to
    - `action` 'set' | 'clear', required — Reaction action: set or clear
    - `emoji` string, required — Emoji reaction
    - `reactor` ReactorInfo
      - `full_name` string, required
      - `phone` string, required
    - `timestamp` string, required
    - `reactions` object, required — Current reaction counts as integer values

## Acknowledgement `200`

Receiver accepted the event

---

[API](https://skmtc.dev/initechsoftware/apis/webhook-api.md) · [All operations](https://skmtc.dev/initechsoftware/apis/webhook-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/initechsoftware/webhook-api/revisions/3d68b53c5c85/schema)