Un numero ha smesso di funzionare: come scoprirne il motivo
Quando un numero connesso smette di funzionare, quasi mai la causa è il codice. Verifica i problemi in ordine di frequenza: un token scaduto, un override del webhook perso dopo una riconnessione, una disconnessione dopo quattordici giorni di inattività, un calo della qualità e infine una restrizione dell’account.
Cause responsabili di quasi tutti i guasti silenziosi.
L’errore restituito da un token scaduto, che sembra indicare un numero mancante.
L’evento che segnala autorevolmente una disconnessione.
Perché sul telefono non sembra esserci nulla di anomalo?
Perché l’app WhatsApp Business e l’API sono superfici separate dello stesso numero, e quasi ogni guasto ne colpisce soltanto una.
Un token scade e l’app non viene modificata. Un override del webhook viene disinstallato e l’app non viene modificata. La qualità diminuisce e l’app non viene modificata. In ogni caso, l’azienda continua a rispondere ai clienti, vede un comportamento normale e non ha motivo di segnalare nulla.
Questo è il motivo per cui serve il monitoraggio, non una dashboard che qualcuno deve controllare. I guasti sono reali, silenziosi e le persone più vicine al numero sono quelle che hanno meno probabilità di notarli.
In quale ordine devo fare le verifiche?
Inizia dal token, perché è la causa più comune e quella meno costosa da risolvere. Una credenziale scaduta o invalidata fa fallire ogni richiesta nello stesso modo, dando l’impressione che il numero sia stato rimosso. Conservare una seconda credenziale sullo stesso account permette di distinguere i due casi.
Poi verifica l’override del webhook. Se c’è stata una riconnessione, la destinazione è stata disinstallata insieme all’app: invio e monitoraggio funzionano, mentre la consegna al tuo server fallisce senza segnali visibili.
Poi controlla una disconnessione: un evento account_update con PARTNER_REMOVED e una motivazione, dove PRIMARY_INACTIVITY significa che l’app è rimasta inutilizzata per circa quattordici giorni e la riconnessione risolve il problema.
Poi la qualità, che viene controllata tramite richieste periodiche anziché notifiche push, e infine una restrizione, cioè un provvedimento a livello di account che nessun fornitore può rimuovere.
Qual è la causa quasi certamente esclusa?
Il tuo codice, se ieri funzionava e non è stato fatto alcun deploy.
La Cloud API è stabile e la struttura delle sue richieste non cambia senza preavviso. Quando un’integrazione rimasta attiva per mesi si interrompe, la probabilità maggiore riguarda una credenziale, un cambiamento di instradamento o un evento a livello di account, tutti casi che possono verificarsi senza che nessuno tocchi un repository.
L’eccezione da considerare è un template modificato. Cambiare il numero di variabili in un template modifica il contratto per ogni mittente, senza segnali visibili, e sembra un errore del codice anche se si tratta di una modifica al contenuto fatta da un’altra persona in WhatsApp Manager.
Errori comuni
- Riconnettere subito il numero. Se è scaduto un token, si chiede al titolare dell’azienda di fare un lavoro inutile.
- Dare per scontato che il codice si sia rotto. Un’API stabile e l’assenza di deploy indicano un’altra causa.
- Cercare sintomi sul telefono. L’app continua a funzionare in quasi tutti questi casi.
EasyCoexistence controlla continuamente tutti e cinque i casi e li registra nella cronologia della connessione, così la diagnosi parte da un evento datato e non da un’ipotesi.
Domande frequenti
Il numero funziona sul telefono ma non viene inviato nulla. Da dove parto?
Dal token di accesso. È la causa più comune e quella che somiglia di più a un numero rimosso.
Ho riconnesso il numero, ma i messaggi non arrivano ancora al mio server.
L’override del webhook è stato disinstallato insieme all’app. Deve essere applicato di nuovo: lo facciamo automaticamente.
Come faccio a sapere se si è applicata la regola dei quattordici giorni?
La disconnessione arriva con la motivazione PRIMARY_INACTIVITY nell’evento account_update.
Una modifica a un template può bloccare gli invii?
Sì, ed è l’unica causa che somiglia a un errore del codice. Cambiare il numero di variabili modifica il contratto per ogni mittente.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il