Reagir
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.
Parâmetros de caminho
idstring · uuidobrigatórioIdentificador da conexão (o número) que reage.
Corpo da requisição
messageIdstringobrigatórioO id do WhatsApp da mensagem que recebe a reação.
tostringobrigatórioA 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).
emojistringO emoji da reação, como 👍. Vazio remove a reação.
Respostas
| Código | Erro e descrição |
|---|---|
| 200 | A reação foi enviada: {"success": true}. |
| 400 | FST_ERR_VALIDATIONFalta messageId ou to no corpo; message diz o que está errado. |
| 400 | A conexão não está open: o corpo traz Connection not ready (status: …). Espere o evento connection.status com open e repita. |
| 401 | Sem chave de API, ou com uma chave inválida (desconhecida, revogada ou expirada). |
| 402 | subscription_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. |
| 403 | A chave de API não tem o escopo messages:send; a mensagem do erro cita o escopo que falta. |
| 404 | A conexão não existe ou não é de quem chama (o recurso de outra pessoa responde igual a um que não existe). |
| 429 | Requisições demais deste IP de origem, ou autenticações com falha demais: espere Retry-After segundos.Cabeçalho: Retry-After |
| 500 | O 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. |
| 501 | unsupported_by_providerO provedor da conexão não oferece esta operação. |
| 503 | A 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