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