Tipi di messaggio WhatsApp non supportati
Alcuni messaggi funzionano nell'app WhatsApp ma non possono essere letti tramite la API. Bird li registra come messaggi ricevuti con un campo unsupported. Puoi vedere chi ha inviato il messaggio e quando, ma non puoi leggerne il contenuto nella dashboard o tramite la API. Chiedi al mittente di reinviare l'informazione come testo o come un altro tipo di messaggio supportato.
Perché un messaggio ricevuto può contenere un errore
Meta può includere l'errore 131051 in una notifica di messaggio in arrivo quando WhatsApp Cloud API non supporta quel contenuto. Una funzionalità può funzionare nell'app WhatsApp e risultare comunque non disponibile tramite Cloud API.
Bird registra quella notifica con direction: inbound e status: received. Il campo last_error del messaggio può contenere meta_error_code: "131051", anche se Bird non ha tentato di inviarlo. In questo caso, l'errore descrive il contenuto in arrivo non disponibile. Non indica un invio in uscita fallito.
Il campo normalizzato last_error.code può avere il valore undeliverable in questo record ricevuto. Controlla direction, status e last_error.meta_error_code insieme prima di trattare un record come un errore di consegna.
Meta usa 131060 anche per un messaggio attualmente non disponibile. Questo può accadere quando qualcuno invia il primo messaggio a un'azienda usando un numero dell'app WhatsApp Business connesso. Ha un significato diverso dall'errore di contenuto non supportato 131051. Consulta il riferimento Meta sui messaggi non supportati per queste notifiche.
Leggere il tipo di messaggio
Il campo unsupported.type identifica il contenuto con la massima precisione consentita dalla notifica:
- Quando Meta fornisce
unsupported.type, Bird ne preserva il valore, ad esempiopoll_creation,pinoedit. - Quando Meta omette
unsupported.type, Bird mantiene il tipo di primo livello del messaggio in quel campo. Un valore comeunsupportedounknownnon identifica l'azione compiuta dal mittente. - Quando Meta fornisce contenuto che il API di Bird non modella, Bird registra il tipo anche qui, ad esempio
orderosystem.
Il nome del tipo non include il contenuto mancante. Ad esempio, poll_creation non fornisce la domanda o le scelte, e edit non fornisce il testo sostitutivo. Conserva i valori di tipo non riconosciuti quando memorizzi i messaggi, così la tua integrazione può accettare nuovi tipi.
Bird supporta immagini, risposte tramite pulsante, risposte da lista e reazioni. Una notifica non supportata con uno di questi nomi descrive quella specifica notifica; non significa che l'intera funzionalità non sia supportata. Vedi ricezione di immagini, risposte interattive e webhook delle reazioni.
Gestire il webhook ricevuto
Un messaggio non supportato emette whatsapp.received con data.unsupported.type. Il webhook ricevuto non include il last_error del record del messaggio; recupera il messaggio tramite la API quando hai bisogno di quel dettaglio diagnostico.
Gestisci unsupported esplicitamente prima di elaborare il contenuto. Mostra che il contenuto non è disponibile, memorizza il tipo e conferma il webhook con una risposta 2xx dopo averlo gestito. Riprovare la stessa notifica non recupera il contenuto mancante. Vedi consegna dei webhook per il comportamento di conferma e ripetizione.
Il record rimane visibile nel log WhatsApp. Bird lo gestisce come messaggio in arrivo ai fini della finestra del servizio clienti.
Esempi da provare
Questi sono esempi di valori di unsupported.type. Se la tua app WhatsApp offre l'azione corrispondente nella conversazione che stai testando, puoi provarla e ispezionare il record risultante:
| Messaggio o azione | unsupported.type |
|---|---|
| Creare un sondaggio | poll_creation |
| Votare in un sondaggio | poll_update |
| Fissare un messaggio | pin |
| Modificare un messaggio inviato | edit |
| Conservare un messaggio effimero nella chat | keep_in_chat |
| Inviare un invito a un gruppo | group_invite |
| Messaggio non identificato | unknown |
La disponibilità dipende dall'app, dalla conversazione e dall'account. Potresti ricevere un tipo generico oppure nessuna notifica di messaggio in entrata per un'azione. Confronta il mittente, il timestamp e unsupported.type con l'azione che hai eseguito. Se il tipo è generico, non puoi identificare l'azione solo da quel record.
Passaggi successivi
- Come funziona la ricezione: messaggi in arrivo, media e webhook
- Ricezione delle risposte interattive: tap sui pulsanti e selezioni da lista
- Log WhatsApp: ispeziona i messaggi nella dashboard o tramite API
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.