Pular para o conteúdo

Reagir

POST/connections/{id}/react

Reage com um emoji a uma mensagem de uma conversa. Um emoji vazio (ou ausente) remove a reação do número. Escopo necessário: messages:send.

Ver em Markdown

Parâmetros de caminho

idstring · uuidobrigatório

Identificador da conexão (o número) que reage.

Corpo da requisição

messageIdstringobrigatório

O id do WhatsApp da mensagem que recebe a reação.

tostringobrigatório

A conversa da mensagem: um número de telefone com código do país e DDD, só dígitos (vira <dígitos>@s.whatsapp.net, sem consulta ao WhatsApp), ou um JID usado como está, como o jid do evento (…@s.whatsapp.net, …@lid ou …@g.us).

emojistring

O emoji da reação, como 👍. Vazio remove a reação.

Respostas

Respostas: código de status, erro e descrição
CódigoErro e descrição
200A reação foi enviada: {"success": true}.
400FST_ERR_VALIDATIONFalta messageId ou to no corpo; message diz o que está errado.
400A conexão não está open: o corpo traz Connection not ready (status: …). Espere o evento connection.status com open e repita.
401Sem chave de API, ou com uma chave inválida (desconhecida, revogada ou expirada).
402subscription_inactiveA organização dona da conexão não pode usar o WhatsApp agora: o período de teste acabou, ou uma fatura venceu e passou do prazo de carência. Regularize o pagamento no painel e repita.
403A chave de API não tem o escopo messages:send; a mensagem do erro cita o escopo que falta.
404A conexão não existe ou não é de quem chama (o recurso de outra pessoa responde igual a um que não existe).
429Requisições demais deste IP de origem, ou autenticações com falha demais: espere Retry-After segundos.Cabeçalho: Retry-After
500O WhatsApp recusou a operação ou não respondeu (Failed to send reaction). Pode repetir: reagir de novo com o mesmo emoji só mantém a reação.
501unsupported_by_providerO provedor da conexão não oferece esta operação.
503A instância do gateway que roda a conexão está mudando (um reinício, um failover) ou não responde: espere Retry-After segundos e tente de novo.Cabeçalho: Retry-After

Detalhes

A reação sai na hora, fora da fila de envio. A conexão precisa estar open. Se o WhatsApp não aceitar a reação, a resposta é 500.

O id de uma mensagem recebida está em data.raw.key.id do evento message.incoming, e a conversa em data.jid. As reações que o número recebe chegam no evento message.reaction.

Guia: Enviar mensagens

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