Documentazione
Sign inGet started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

Tipi di messaggio WhatsApp non supportati

WhatsApp trasporta contenuti che il API di Bird non modella, dagli ordini da catalogo alle notifiche di sistema sulla conversazione. Invece di scartare un messaggio di questo tipo o consegnarlo vuoto, Bird lo registra con un arm unsupported che indica il tipo di contenuto WhatsApp. Il messaggio è visibile nel log WhatsApp e raggiunge il vostro webhook come qualsiasi altro.

Cosa contiene un messaggio non supportato

unsupported.type riporta la stringa di tipo propria di WhatsApp per ciò che è arrivato, ed è l'unico contenuto presente nel messaggio. L'envelope che lo circonda resta invariato:
Esempio di codice
{
  "id": "wam_01kyh0w4ujnz2x8p1s5dci0vlg",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "unsupported": { "type": "order" },
  "created_at": "2026-08-25T09:31:20Z"
}
typeCosa ha inviato il contatto
interactiveContenuto interattivo la cui forma di risposta non è stata interpretata dal API come un tap
buttonUn tap su pulsante che il API non è riuscito a interpretare come risposta
orderUn carrello o un ordine effettuato da un catalogo prodotti
systemUna notifica di sistema sulla conversazione, ad esempio un contatto che cambia numero di telefono
unsupportedIl tipo unsupported proprio di WhatsApp, per un messaggio che i suoi stessi client non possono renderizzare
unsupported non è un segnaposto in quella tabella. WhatsApp segnala un tipo di contenuto proprio con quel nome quando uno dei suoi client invia qualcosa che gli altri non possono visualizzare, e il valore che arriva è questo.
L'elenco è aperto. WhatsApp aggiunge tipi di contenuto nel tempo, quindi trattate un type che non riconoscete come un tipo futuro anziché come un errore: registratelo e proseguite invece di interrompere la lettura.

Il payload del webhook

whatsapp.received si attiva anche per un messaggio non supportato, con lo stesso arm:
Esempio di codice
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:31:20.774Z",
  "data": {
    "whatsapp_id": "wam_01kyh0w4ujnz2x8p1s5dci0vlg",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "unsupported": { "type": "order" },
    "tags": null,
    "metadata": null
  }
}
Un endpoint che fa switch sul campo content trovato dovrebbe avere un branch di default, e questo arm è ciò che vi finisce. Confermate il webhook con un 2xx in ogni caso: riprovare non cambia nulla, perché il contenuto non diventerà modellato tra un tentativo e l'altro.

Cosa fa comunque un messaggio non supportato

Il messaggio conta come messaggio in entrata sotto ogni aspetto che non dipende dal suo contenuto:
  • Reimposta la finestra di assistenza clienti a 24 ore nuove, quindi un ordine effettuato dal vostro catalogo riapre le risposte in formato libero.
  • Compare nella lista messaggi e nel log WhatsApp, con il tipo mostrato anziché una riga vuota.
  • Non viene mai addebitato. Nessun messaggio in entrata ha un costo.
Quello che non potete fare è leggere il contenuto. Un ordine non include il carrello, e una notifica di sistema non dice cosa è cambiato. Dove quel dettaglio è importante, chiedete al contatto a parole oppure usate un pulsante di risposta o un menu a lista così la risposta arriva su un arm modellato su cui potete agire.

Aspetti da tenere d'occhio

  • Non trattate l'arm come un errore. Il messaggio è stato ricevuto correttamente; solo il suo contenuto non è modellato. Generare un allarme su di esso significa generare un allarme ogni volta che un contatto effettua un ordine.
  • Un tipo system può significare che il contatto ha cambiato numero. Meta documenta un cambio di numero di telefono come uno degli eventi che genera un messaggio di sistema, e allo stesso tempo rigenera l'ID utente con scope business del contatto. L'arm indica il tipo e nient'altro, quindi trattatelo come un invito a ristabilire con chi state parlando.
  • Una reazione emoji non è un messaggio non supportato. Non è affatto un messaggio in entrata, quindi non raggiunge nessun webhook e non compare in nessuna lista messaggi: ogni modifica viene registrata nel log delle reazioni del messaggio a cui si riferisce, descritto in eventi WhatsApp.
  • Salvate il tipo così com'è. Un tipo futuro si risolve in un nome per cui non avete ancora codice, e conservare il valore grezzo è ciò che vi permette di trovare quei messaggi quando lo avrete.

Prossimi passi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channelComprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builderEsplora la funzionalitàWhatsApp
Prova l'esercitazione e ottieni un brief di implementazione