Reações a mensagens: enviando e recebendo emoji
Uma reação anexa um único emoji a uma mensagem existente. Enviar uma significa referenciar o id da mensagem e o emoji, e remover uma significa enviar a mesma reação com a string de emoji vazia, em vez de chamar uma exclusão.
A EasyCoexistence entrega os eventos de reação no seu endpoint pelo mesmo webhook de todas as outras mensagens, então uma reação removida chega ao seu sistema com o emoji vazio intacto.
Reações que um remetente pode ter numa mesma mensagem ao mesmo tempo.
Custo de uma reação. Ela não abre uma conversa cobrável.
O erro devolvido se você reagir fora da janela de atendimento.
Enviando uma reação
Uma mensagem do tipo reaction, carregando o id da mensagem que está sendo reagida e um único emoji. Enviar uma segunda reação para a mesma mensagem substitui a primeira, em vez de somar a ela, porque um remetente só pode ter uma reação por mensagem.
O id da mensagem precisa ser um que o seu número consiga enxergar: uma mensagem de entrada daquele cliente, ou uma que você enviou para ele.
Removendo uma reação
A parte que surpreende as pessoas. Não existe chamada de exclusão. Você envia a mesma mensagem de reação com o campo de emoji definido como uma string vazia, e isso limpa a reação.
Um handler escrito para esperar um evento de remoção vai esperar para sempre. O que chega é uma reação com emoji vazio, que tem o mesmo formato de uma reação nova e precisa ser lida como remoção por meio da verificação do campo.
Recebendo reações
As reações de entrada chegam pelo webhook de mensagens como uma mensagem do tipo reaction, nomeando o id da mensagem à qual se anexam e o emoji.
- Assine o campo messages; não existe um campo separado para reações.
- Um emoji vazio significa que o cliente removeu a reação dele.
- O id de mensagem referenciado é de algo que você enviou ou recebeu antes.
- As reações não reabrem a janela de atendimento de 24 horas.
A janela continua valendo
Uma reação é uma mensagem, então enviar uma exige que a janela de atendimento de 24 horas esteja aberta. Reagir à mensagem de um cliente de três dias atrás devolve o erro 131047, exatamente como aconteceria com uma mensagem de texto.
Receber uma reação de um cliente reabre sim a janela, porque qualquer mensagem de entrada reabre. Isso vale conhecer para automações: um joinha na sua última mensagem é um sinal válido de que agora você pode responder livremente.
Erros comuns
- Procurar um endpoint de exclusão. A remoção é a mesma chamada com um emoji vazio.
- Tratar um emoji vazio como malformado. É assim que uma remoção é expressa.
- Enviar uma reação fora da janela de atendimento. Ela falha como qualquer outra mensagem.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Como eu removo uma reação?
Envie a mesma mensagem de reação com uma string de emoji vazia. Não existe chamada de exclusão.
As reações custam alguma coisa?
Não. Elas não abrem uma conversa cobrável.
Posso reagir a qualquer mensagem?
Só a mensagens que o seu número enviou ou recebeu, e só dentro da janela de atendimento de 24 horas.
A reação de um cliente reabre a janela?
Reabre. Qualquer mensagem de entrada vinda dele reabre, inclusive uma reação.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em