Reações a mensagens: enviar e receber emojis
Uma reação associa um único emoji a uma mensagem existente. Para enviar uma, é necessário indicar o message id e o emoji. Para a remover, envia-se a mesma reação com uma cadeia emoji vazia, em vez de chamar uma operação de eliminação.
O número de reações que um remetente pode ter numa mensagem de cada vez.
Custo de uma reação. Não inicia uma conversa faturável.
O erro devolvido ao reagir fora da janela de serviço.
Enviar uma reação
Uma mensagem do tipo reaction, que inclui o message id da mensagem à qual se reage e um único emoji. Ao enviar uma segunda reação para a mesma mensagem, substitui-se a primeira em vez de a adicionar, porque cada remetente só pode ter uma reação por mensagem.
O message id tem de ser um que o seu número consiga ver: uma mensagem recebida desse cliente ou uma mensagem que lhe enviou.
Remover uma reação
É esta a parte que costuma surpreender. Não existe uma chamada de eliminação. Envia-se a mesma mensagem de reação com o campo emoji definido como uma cadeia vazia, o que a remove.
Um processador preparado para esperar um evento de remoção ficará à espera indefinidamente. O que chega é uma reação com um emoji vazio, com a mesma estrutura de uma reação nova, e tem de ser interpretada como remoção através da verificação do campo.
Receber reações
As reações recebidas chegam no messages webhook como uma mensagem do tipo reaction, indicando o message id ao qual estão associadas e o emoji.
- Subscreva o campo messages; não existe um campo separado para reações.
- Um emoji vazio significa que o cliente removeu a sua reação.
- O message id referenciado é de uma mensagem que enviou ou recebeu anteriormente.
- As reações não reabrem a janela de serviço de 24 horas.
A janela continua a aplicar-se
Uma reação é uma mensagem, pelo que o seu envio exige que a janela de serviço ao cliente de 24 horas esteja aberta. Reagir a uma mensagem de um cliente com três dias devolve o erro 131047, exatamente como aconteceria com uma mensagem de texto.
Receber uma reação de um cliente reabre a janela, porque qualquer mensagem recebida o faz. Isto é importante para as automatizações: um gosto na sua última mensagem é um sinal válido de que já pode responder livremente.
Erros comuns
- Procurar um endpoint de eliminação. A remoção usa 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 serviço. Falha como qualquer outra mensagem.
A EasyCoexistence entrega os eventos de reação no seu endpoint, através do mesmo webhook que todas as outras mensagens, mantendo o emoji vazio quando uma reação é removida.
Perguntas frequentes
Como removo uma reação?
Envie a mesma mensagem de reação com uma cadeia emoji vazia. Não existe uma chamada de eliminação.
As reações têm algum custo?
Não. Não iniciam uma conversa faturável.
Posso reagir a qualquer mensagem?
Apenas a mensagens que o seu número enviou ou recebeu, e somente dentro da janela de serviço de 24 horas.
A reação de um cliente reabre a janela?
Sim. Qualquer mensagem recebida desse cliente o faz, incluindo uma reação.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em