Campi webhook di WhatsApp e dove vengono inviati

Cosa contiene ogni campo?

messages contiene tutto ciò che un cliente invia al numero: testo, riferimenti multimediali, risposte e reazioni. smb_message_echoes contiene ciò che il tuo team invia dall'app WhatsApp Business, disponibile solo su un numero Coexistence e necessario perché il software possa vedere le risposte delle persone.

account_update contiene lo stato della connessione: PARTNER_REMOVED quando l'app viene disinstallata dall'account, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED ed eventi di limitazione o violazione. phone_number_quality_update contiene le variazioni della valutazione della qualità e del volume consentito. account_alerts contiene gli avvisi generati da Meta per l'account, mentre account_review_update contiene l'esito di una verifica.

business_capability_update contiene le variazioni dei limiti e delle funzionalità di messaggistica, mentre phone_number_name_update contiene le approvazioni e i rifiuti del nome visualizzato.

Perché la separazione conta per l'architettura?

Perché determina se il contenuto della conversazione raggiunge mai un provider.

La sovrascrittura invia i due campi del messaggio direttamente da Meta al tuo endpoint. I sei campi operativi continuano ad arrivare al provider, rendendo possibile una dashboard con avvisi senza che nessuno debba conservare un messaggio.

Per questo anche l'affermazione di non conservare i messaggi può dipendere dalla struttura, non solo da una policy. Se i campi del messaggio vengono consegnati altrove, non esiste un percorso del codice in cui possano essere conservati. Nel nostro caso, un account senza sovrascrittura usa il callback predefinito, il cui gestore scarta questi eventi senza salvarli.

Quali campi deve aspettarsi il tuo gestore?

Solo i due campi del messaggio, se la sovrascrittura è impostata. Conviene scrivere il gestore in modo che ignori tutto il resto invece di bloccarsi.

Meta aggiunge campi nel tempo e la struttura di un payload può ottenere nuove chiavi senza preavviso. Un gestore che controlla il nome del campo e ignora ciò che non riconosce continua a funzionare; uno che presume una struttura fissa si blocca al primo evento sconosciuto.

Conviene inoltre gestire esplicitamente smb_message_echoes, invece di trattarlo come rumore. Senza questo campo, il software non sa che una persona ha già risposto, e il cliente può ricevere due risposte alla stessa domanda.

Errori comuni

• Presumere un payload generico. Ogni evento indica il proprio campo e il gestore deve controllarlo.
• Ignorare smb_message_echoes. Senza questo campo, il software risponde a una persona che ha già risposto.
• Bloccarsi sui campi non riconosciuti invece di saltarli. Meta aggiunge campi senza chiedere.

Domande frequenti

Continua a leggere