Il webhook account_update e ogni motivo di disconnessione
account_update è il modo in cui Meta segnala che una connessione ha cambiato stato. Il campo event indica cosa è successo e, in caso di rimozione, disconnection_info.reason indica il motivo. Quel motivo distingue un numero che tornerà da uno definitivamente perso.
L'evento che Meta invia quando l'app viene disinstallata da un account.
I motivi di disconnessione nominati che una rimozione può contenere.
La finestra di inattività del dispositivo principale, indicata come PRIMARY_INACTIVITY.
Quali eventi contiene account_update?
PARTNER_REMOVED, quando l'app viene disinstallata dal WhatsApp Business Account. È il segnale autorevole di disconnessione e quello su cui conviene costruire, invece di dedurre una disconnessione dal passaggio di un campo a false.
ACCOUNT_OFFBOARDED, quando il numero viene rimosso completamente. ACCOUNT_RECONNECTED, quando una connessione rimossa in precedenza torna disponibile. E gli eventi di applicazione delle restrizioni: ACCOUNT_RESTRICTION e ACCOUNT_VIOLATION, insieme agli eventi il cui nome include DISABLED o BAN.
Anche gli esiti di verifica e approvazione arrivano qui, con nomi di evento che contengono VERIFIED o APPROVED. Un gestore dovrebbe basarsi sul nome dell'evento e trattare ciò che non riconosce come informativo, invece di fallire, perché Meta aggiunge eventi senza preavviso.
Quali sono i motivi di disconnessione?
Sei, e hanno significati molto diversi.
PRIMARY_INACTIVITY è la regola di circa quattordici giorni: l'app WhatsApp Business non è stata aperta sul dispositivo principale. È recuperabile e di gran lunga il caso più comune.
COMPANION_INACTIVITY segue la stessa logica su un dispositivo associato, con una finestra più lunga di circa trenta giorni.
BUSINESS_DOWNGRADE significa che il numero è tornato all'app WhatsApp per privati, interrompendo Coexistence perché Coexistence richiede l'app Business.
CHANGE_NUMBER indica che il numero di telefono è cambiato. USER_RE_REGISTERED indica che è stato registrato di nuovo su un dispositivo nuovo. ACCOUNT_DISCONNECTED indica che il cliente lo ha disconnesso deliberatamente o che lo ha fatto un sistema di applicazione delle regole.
Il motivo arriva anche insieme a disconnection_info.initiated_by, che indica se l'azione è stata eseguita da una persona o dal sistema.
Perché il motivo conta più dell'evento?
Perché PARTNER_REMOVED, da solo, non indica cosa fare.
Un numero rimosso per PRIMARY_INACTIVITY tornerà: l'azienda apre l'app, si riconnette e tutto riprende. Trattarlo come un cliente che se n'è andato genera un'email di cancellazione per qualcuno che è ancora cliente.
Un numero rimosso per BUSINESS_DOWNGRADE o ACCOUNT_DISCONNECTED è una situazione diversa, e trattarlo come temporaneo lascia una connessione sospesa per sempre.
Quando una rimozione arriva senza alcun motivo, initiated_by è il segnale di riserva: una rimozione eseguita da una persona appare deliberata, mentre una rimozione di sistema senza spiegazione no. Conviene gestire questa distinzione nel codice, invece che in una conversazione con l'assistenza in un secondo momento.
Errori comuni
- Trattare ogni PARTNER_REMOVED allo stesso modo. Il motivo distingue due settimane di silenzio da un cliente che se n'è andato.
- Dedurre la disconnessione dal passaggio di un campo a false invece che da questo evento. È così che si producono falsi allarmi.
- Fallire davanti a un nome di evento non riconosciuto. Meta aggiunge eventi e il gestore dovrebbe ignorare ciò che non conosce.
EasyCoexistence gestisce ognuno di questi casi per nome, registra il motivo nella cronologia della connessione e distingue una rimozione recuperabile per inattività da un numero realmente perso.
Domande frequenti
PARTNER_REMOVED è permanente?
Di solito no. La maggior parte arriva con PRIMARY_INACTIVITY, cioè l'app non è stata aperta, e la riconnessione ripristina tutto.
La riconnessione ripristina la destinazione del mio webhook?
No, ed è qui che sta il problema. La destinazione è un override sulla sottoscrizione dell'app e viene disinstallata insieme ad essa. Deve essere applicata di nuovo.
Che cos'è COMPANION_INACTIVITY?
La stessa logica di inattività su un dispositivo associato anziché su quello principale, con una finestra più lunga di circa trenta giorni.
Posso ricevere questo evento senza un motivo?
Sì. In quel caso, disconnection_info.initiated_by è l'unico segnale per capire se l'azione è stata deliberata.
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