Campos do webhook do WhatsApp e respetivo destino

O que transporta cada campo?

messages transporta tudo o que um cliente envia para o número: texto, referências de multimédia, respostas e reações. smb_message_echoes transporta o que a sua equipa envia a partir da aplicação WhatsApp Business. Só existe num número de Coexistência e permite ao software ver as respostas de uma pessoa.

account_update transporta o estado da ligação: PARTNER_REMOVED quando a aplicação é desinstalada da conta, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED e eventos de restrição ou violação. phone_number_quality_update transporta alterações à classificação de qualidade e ao throughput. account_alerts transporta os alertas que a Meta emite para a conta, e account_review_update transporta o resultado de uma análise.

business_capability_update transporta alterações aos limites e capacidades de mensagens, e phone_number_name_update transporta aprovações e rejeições do nome apresentado.

Porque é que a separação importa para a arquitetura?

Porque determina se o conteúdo das conversas chega alguma vez a um fornecedor.

A substituição envia os dois campos de mensagens diretamente da Meta para o seu endpoint. Os seis campos operacionais continuam a ser enviados para o fornecedor, permitindo ter um painel e alertas sem que alguém retenha uma mensagem.

É também por isso que a afirmação de que não guardamos mensagens pode ser estrutural, e não apenas uma política. Se os campos de mensagens forem entregues noutro local, não existe um caminho de código onde possam ser guardados. No nosso caso, uma conta sem substituição recorre ao callback predefinido, onde o processador elimina esses eventos sem os guardar.

Que campos deve o seu processador esperar?

Apenas os dois campos de mensagens, se a substituição estiver definida. Ainda assim, é recomendável escrever o processador para ignorar tudo o resto, em vez de falhar.

A Meta acrescenta campos ao longo do tempo, e a estrutura de um payload pode ganhar chaves sem aviso. Um processador que usa o nome do campo e ignora o que não reconhece continua a funcionar. Um processador que pressupõe uma estrutura falha no primeiro evento desconhecido.

Também vale a pena tratar smb_message_echoes explicitamente, em vez de o considerar ruído. Sem este campo, o software não sabe que uma pessoa já respondeu, o que pode fazer com que um cliente receba duas respostas à mesma pergunta.

Erros comuns

• Pressupor um payload genérico. Cada evento identifica o seu campo, e o processador deve analisá-lo.
• Ignorar smb_message_echoes. Sem este campo, o software responde depois de uma pessoa já ter respondido.
• Falhar perante campos desconhecidos em vez de os ignorar. A Meta acrescenta campos sem pedir autorização.

Perguntas frequentes

Continue a ler