# message.reaction

Fonte: https://apiwpp.com/docs/webhooks/message-reaction
Seção: Webhooks
Atualizado em: 2026-09-28

Alguém reagiu a uma mensagem.

`POST` para o `webhookBaseUrl` do projeto.

Uma reação foi adicionada ou removida numa conversa do número. `messageId` é o id da mensagem que recebeu a reação, enviada ou recebida pelo número, e `emoji` vazio quer dizer que a reação foi removida.

Para uma mensagem que o número enviou, `messageId` é o mesmo de [`message.delivery`](https://apiwpp.com/docs/webhooks/message-delivery) e [`message.outgoing`](https://apiwpp.com/docs/webhooks/message-outgoing). Para uma mensagem recebida, é o `raw.key.id` do [`message.incoming`](https://apiwpp.com/docs/webhooks/message-incoming).

Uma reação não chega como `message.incoming`: só por este evento. Cada pessoa tem uma reação por mensagem; trocar o emoji gera um novo evento com o emoji novo, e remover gera um evento com `emoji` vazio.

O evento não diz quem reagiu. Numa conversa em grupo, `jid` é o grupo e `phone` é `null`.

Para reagir pela API, use [`POST /connections/{id}/react`](https://apiwpp.com/docs/api/mensagens/reagir).

Como toda entrega de webhook é feita pelo menos uma vez, aplique-o de forma idempotente: a mesma reação pode chegar duas vezes.

**Entrega.** Um `POST` com `Content-Type: application/json` ao `webhookBaseUrl` do projeto, feito **pelo menos uma vez**; um projeto inativo não recebe webhooks. Responda `2xx` em até 10 segundos: o corpo da resposta é ignorado, e um redirecionamento (`3xx`) não é seguido e conta como falha. Uma entrega que falha é tentada de novo depois de cerca de 2, 4, 8, 16 e 32 segundos, **6 tentativas** no total, e então fica `dead`. Depois de 5 falhas seguidas, as entregas do projeto ficam em pausa de 30 segundos a 5 minutos, e um evento que passa 24 horas sem ser entregue também fica `dead`. Uma nova tentativa pode chegar depois de eventos mais novos: ordene pelo `timestamp` do envelope. Reenvie as entregas `dead` com [`POST /webhooks/deliveries/{id}/resend`](https://apiwpp.com/docs/api/registros/reenviar-entrega) ou [`POST /webhooks/deliveries/resend-dead`](https://apiwpp.com/docs/api/registros/reenviar-entregas-mortas).

**Assinatura.** `X-Webhook-Token` vem sempre, com o `webhookToken` do projeto, junto com os `webhookHeaders` personalizados. Com um `webhookSecret`, cada tentativa também traz `X-Sales-Timestamp` (segundos unix da tentativa) e `X-Sales-Signature`: calcule `"sha256=" + hex(HMAC-SHA256(webhookSecret, X-Sales-Timestamp + "." + corpo))` sobre os bytes do corpo exatamente como chegaram, compare em tempo constante e rejeite um `X-Sales-Timestamp` a mais de 300 segundos do seu relógio. Veja [Webhooks e assinatura](https://apiwpp.com/docs/guias/webhooks-e-assinatura).

## Cabeçalhos da entrega

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `X-Webhook-Token` | `string` | sim | O `webhookToken` do projeto, em toda entrega. Pode ser definido, mas nunca é devolvido pela API: troque-o com [`PATCH /tenants/{id}`](https://apiwpp.com/docs/api/projetos/atualizar-projeto). Os `webhookHeaders` personalizados do projeto também são enviados. |
| `X-Sales-Timestamp` | `string` | não | Só quando o projeto tem um webhookSecret: segundos unix desta tentativa de entrega (as novas tentativas são assinadas de novo). Rejeite um que esteja a mais de 300 s do seu relógio. (formato `^\d+$`) |
| `X-Sales-Signature` | `string` | não | Só quando o projeto tem um webhookSecret: "sha256=" + hex(HMAC-SHA256(webhookSecret, X-Sales-Timestamp + "." + rawBody)). Calcule sobre os bytes do corpo exatamente como recebidos, nunca sobre um objeto serializado de novo, e compare em tempo constante. (formato `^sha256=[0-9a-f]{64}$`) |

## Envelope

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `type` | `string` | sim | O tipo do evento, que decide o formato de `data`. Ignore os tipos que você não conhece: a lista de eventos pode crescer. (sempre "message.reaction") |
| `connectionId` | `string · uuid` | sim | O id (UUID) da conexão, ou seja, do número, que gerou o evento. |
| `tenantId` | `string · uuid` | sim | O id (UUID) do projeto dono da conexão. |
| `externalId` | `string \| null` | sim | O `externalId` que você informou ao criar a conexão, para ligá-la a um registro seu. `null` quando a conexão foi criada sem ele. |
| `timestamp` | `string · date-time` | sim | Quando o evento foi gerado, em ISO 8601 (UTC). É o mesmo em todas as tentativas de entrega; o momento de cada tentativa vem no cabeçalho `X-Sales-Timestamp`. |

## Campos de `data`

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `messageId` | `string` | sim | Id do WhatsApp da mensagem que recebeu a reação. |
| `from` | `string` | sim | Campo antigo: o `jid` sem `@s.whatsapp.net` (um LID ou um grupo passam como estão). Prefira `jid` e `phone`. |
| `jid` | `string` | sim | JID da conversa: `…@s.whatsapp.net` ou `…@lid` numa conversa individual, `…@g.us` num grupo. Sempre presente. |
| `phone` | `string \| null` | sim | Telefone da outra pessoa da conversa em E.164 (por exemplo, `+5511988887777`). `null` num grupo ou quando a conversa é endereçada por um LID que a apiwpp ainda não resolveu; o evento nunca é descartado por isso. Veja [LID e contact.resolved](https://apiwpp.com/docs/guias/lid-e-contact-resolved). (formato `^\+[1-9]\d{7,14}$`) |
| `emoji` | `string` | sim | O emoji da reação. Vazio (`""`) quando a reação foi removida. |

## Exemplo

```json
{
  "type": "message.reaction",
  "connectionId": "8b1d4e7f-2c3a-4f5b-9e6d-7a8b9c0d1e2f",
  "tenantId": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
  "externalId": "shop-42",
  "timestamp": "2026-09-24T12:00:00.000Z",
  "data": {
    "messageId": "3EB0C767D26A1D8A3F52",
    "from": "5511988887777",
    "emoji": "👍",
    "jid": "5511988887777@s.whatsapp.net",
    "phone": "+5511988887777"
  }
}
```

Guia: [Enviar mensagens](https://apiwpp.com/docs/guias/enviar-mensagens).
