Campos do webhook do WhatsApp, e para onde cada um vai

O que cada campo carrega?

messages carrega tudo o que um cliente envia para o número: texto, referências de mídia, respostas e reações. smb_message_echoes carrega o que a sua equipe envia pelo app do WhatsApp Business, que só existe em um número com Coexistência e é como o software enxerga as respostas de uma pessoa.

account_update carrega o estado da conexão: PARTNER_REMOVED quando o app é desinstalado da conta, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, e eventos de restrição ou de violação. phone_number_quality_update carrega mudanças de classificação de qualidade e de throughput. account_alerts carrega alertas que a Meta levanta contra a conta, e account_review_update carrega o resultado de uma revisão.

business_capability_update carrega mudanças de limite de mensagens e de capacidades, e phone_number_name_update carrega aprovações e recusas do nome de exibição.

Por que essa separação importa na arquitetura?

Porque ela decide se o conteúdo das conversas chega ou não a um provedor.

O override manda os dois campos de mensagem para o seu endpoint direto da Meta. Os seis campos operacionais seguem para o provedor, e é isso que torna possível ter painel e alertas sem ninguém guardar uma mensagem.

É também por isso que a afirmação de não armazenar mensagens pode ser estrutural, e não apenas uma política. Se os campos de mensagem são entregues em outro lugar, não existe caminho de código no qual eles poderiam ser armazenados. No nosso caso, uma conta sem override cai no callback padrão, onde o handler descarta esses eventos sem persistir nada.

Quais campos o seu handler deve esperar?

Só os dois campos de mensagem, se o override estiver definido, e vale escrever o handler para ignorar qualquer outra coisa em vez de falhar com ela.

A Meta acrescenta campos com o tempo e o formato de um payload pode ganhar chaves sem aviso. Um handler que decide pelo nome do campo e ignora o que não reconhece continua funcionando; um que presume um formato quebra no primeiro evento desconhecido.

Também vale tratar smb_message_echoes de forma explícita em vez de encarar como ruído. Sem ele, o software não tem ideia de que uma pessoa já respondeu, e é assim que um cliente acaba com duas respostas para a mesma pergunta.

Erros comuns

• Presumir um payload genérico. Todo evento nomeia o seu campo, e o handler deve decidir por ele.
• Ignorar smb_message_echoes. Sem ele o software responde em cima de uma pessoa que já respondeu.
• Falhar em campos não reconhecidos em vez de pular. A Meta acrescenta campos sem pedir licença.

Perguntas frequentes

Continue lendo