# 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](/docs/guides/whatsapp/message-log) 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:

```json
{
  "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"
}
```

| `type`        | Cosa ha inviato il contatto                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| `interactive` | Contenuto interattivo la cui forma di risposta non è stata interpretata dal API come un tap                   |
| `button`      | Un tap su pulsante che il API non è riuscito a interpretare come risposta                                     |
| `order`       | Un carrello o un ordine effettuato da un catalogo prodotti                                                    |
| `system`      | Una notifica di sistema sulla conversazione, ad esempio un contatto che cambia numero di telefono             |
| `unsupported` | Il 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:

```json
{
  "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](/docs/guides/whatsapp/message-types/interactive) 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](/docs/guides/whatsapp/business-scoped-user-ids) 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](/docs/guides/whatsapp/events#reaction-events).
- **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

- [Come funziona la ricezione](/docs/guides/whatsapp/receiving-whatsapp): l'envelope in entrata, il recupero dei media e il webhook `whatsapp.received`
- [Ricevere risposte interattive](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies): i tap che arrivano come contenuto modellato
- [Log WhatsApp](/docs/guides/whatsapp/message-log): navigare la conversazione nella dashboard
- [Eventi WhatsApp](/docs/guides/whatsapp/events): l'elenco completo degli eventi, tramite API o webhook

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)