Um número deixou de funcionar: como descobrir porquê
Quando um número ligado deixa de funcionar, a causa quase nunca está no código. Verifique pela ordem de frequência: um token expirado, uma substituição do webhook perdida numa nova ligação, uma desligação após catorze dias de inatividade, uma queda de qualidade e, por fim, uma restrição da conta.
A EasyCoexistence verifica continuamente os cinco casos e regista cada um na cronologia da ligação, para que a resolução de problemas comece num evento datado, não numa suposição.
Causas responsáveis por quase todas as falhas silenciosas.
O erro devolvido por um token expirado, que parece indicar que falta o número.
O evento que comunica oficialmente uma desligação.
Porque é que nada parece estar errado no telemóvel?
Porque a aplicação WhatsApp Business e a API são interfaces separadas no mesmo número, e quase todas as falhas afetam apenas uma delas.
Um token expira e a aplicação permanece intacta. Uma substituição do webhook é desinstalada e a aplicação permanece intacta. A qualidade baixa e a aplicação permanece intacta. Em todos os casos, a empresa continua a responder aos clientes, vê um comportamento normal e não tem motivo para comunicar qualquer problema.
Este é todo o argumento a favor da monitorização, em vez de um painel que alguém verifica. As falhas são reais, silenciosas, e as pessoas mais próximas do número são as menos propensas a detetá-las.
Por que ordem deve verificar?
Comece pelo token, porque é a causa mais comum e a mais barata de corrigir. Uma credencial expirada ou invalidada faz com que todos os pedidos falhem da mesma forma, parecendo exatamente que o número foi removido. Manter uma segunda credencial na mesma conta é o que permite distinguir os dois casos.
Depois, verifique a substituição do webhook. Se tiver ocorrido uma nova ligação, o destino foi desinstalado com a aplicação; por isso, o envio e a monitorização funcionam, mas a entrega ao seu servidor deixa silenciosamente de funcionar.
Depois, verifique uma desligação: um evento account_update com PARTNER_REMOVED e um motivo, em que PRIMARY_INACTIVITY significa que a aplicação ficou cerca de catorze dias sem ser aberta e que uma nova ligação resolve o problema.
Depois, verifique a qualidade, que é consultada em vez de enviada, e, por fim, uma restrição, que é uma medida aplicada ao nível da conta e que nenhum fornecedor pode remover.
O que quase nunca é a causa?
O seu código, se estava a funcionar ontem e nada foi implementado.
A Cloud API é estável e os formatos dos seus pedidos não mudam sem aviso. Quando uma integração que funcionou durante meses deixa de funcionar, a probabilidade esmagadora aponta para uma credencial, uma alteração de encaminhamento ou um evento ao nível da conta, tudo situações que podem ocorrer sem ninguém tocar num repositório.
A exceção que vale a pena mencionar é um template editado. Alterar o número de variáveis de um template muda o contrato para cada remetente, silenciosamente, e pode parecer uma falha de código, embora seja uma alteração de conteúdo feita por outra pessoa no WhatsApp Manager.
Erros comuns
- Voltar a ligar o número primeiro. Se um token expirou, isso pede ao responsável pela empresa um trabalho que nunca foi necessário.
- Assumir que o código deixou de funcionar. Uma API estável e a ausência de uma implementação apontam para outro lado.
- Verificar o telemóvel à procura de sintomas. A aplicação continua a funcionar durante quase todos estes casos.
Perguntas frequentes
O número funciona no telemóvel, mas nada é enviado. Por onde começo?
Pelo token de acesso. É a causa mais comum e a que mais se parece com um número removido.
Voltei a ligar o número, mas as mensagens continuam sem chegar ao meu servidor.
A substituição do webhook foi desinstalada com a aplicação. Tem de ser reaplicada; fazemos isso automaticamente.
Como sei se foi a regra dos catorze dias?
A desligação chega com o motivo PRIMARY_INACTIVITY no evento account_update.
Uma alteração num template pode impedir os meus envios?
Sim, e é a única causa que se parece com uma falha de código. Alterar o número de variáveis muda o contrato para cada remetente.
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