Pular para o conteúdo

message.reaction

POSTpara o webhookBaseUrl do projeto

Alguém reagiu a uma mensagem.

Ver em Markdown

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 e message.outgoing. Para uma mensagem recebida, é o raw.key.id do 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.

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 ou POST /webhooks/deliveries/resend-dead.

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.

Guia: Enviar mensagens

Cabeçalhos da entrega

X-Webhook-Tokenstringsempre

O webhookToken do projeto, em toda entrega. Pode ser definido, mas nunca é devolvido pela API: troque-o com PATCH /tenants/{id}. Os webhookHeaders personalizados do projeto também são enviados.

X-Sales-Timestampstring

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-Signaturestring

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

typestringsempre presente

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"
connectionIdstring · uuidsempre presente

O id (UUID) da conexão, ou seja, do número, que gerou o evento.

tenantIdstring · uuidsempre presente

O id (UUID) do projeto dono da conexão.

externalIdstring | nullsempre presente

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.

timestampstring · date-timesempre presente

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

messageIdstringsempre presente

Id do WhatsApp da mensagem que recebeu a reação.

fromstringsempre presente

Campo antigo: o jid sem @s.whatsapp.net (um LID ou um grupo passam como estão). Prefira jid e phone.

jidstringsempre presente

JID da conversa: …@s.whatsapp.net ou …@lid numa conversa individual, …@g.us num grupo. Sempre presente.

phonestring | nullsempre presente

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.

formato `^\+[1-9]\d{7,14}$`
emojistringsempre presente

O emoji da reação. Vazio ("") quando a reação foi removida.

Esta página ajudou? · Atualizado em 28 set 2026