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