# Ricevere messaggi di testo WhatsApp

Un contatto che scrive nella chat produce un messaggio in entrata con `text`. È il tipo di messaggio in entrata più comune, e quello che apre o azzera la [finestra di servizio clienti](/docs/knowledge-base/whatsapp/customer-service-window).

## Cosa contiene un messaggio di testo in entrata

`text.body` contiene ciò che il contatto ha digitato, e nient'altro è presente sul ramo:

```json
{
  "id": "wam_01kya19eknftrs2s6p82asmvnh",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "text": { "body": "Is my order out for delivery yet?" },
  "created_at": "2026-08-25T09:04:11Z"
}
```

`preview_url` è un campo lato invio. Un messaggio di testo in entrata non porta alcun flag per l'anteprima del link, indipendentemente da ciò che il client del contatto ha mostrato, quindi un URL in `body` viene restituito come parte del testo.

Lo schema di lettura non dichiara un massimo per un `body` in entrata. Il limite di 4096 caratteri appartiene al [lato invio](/docs/guides/whatsapp/message-types/plain-text#limits), quindi dimensiona il tuo storage come testo illimitato anziché su un limite che il ramo in entrata non garantisce.

## Un messaggio di testo inviato come risposta citata

Quando il contatto risponde a uno dei tuoi messaggi citandolo, il ramo resta invariato e `in_reply_to_message_id` indica il messaggio a cui ha risposto:

```json
{
  "id": "wam_01kyb2m4xq7whs0d8n3prv6tez",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "text": { "body": "Yes, that one" },
  "created_at": "2026-08-25T09:06:02Z"
}
```

WhatsApp non contrassegna ogni risposta, e una risposta non contrassegnata non porta alcun ID. Consulta [le risposte citate](/docs/guides/whatsapp/receiving-whatsapp#quoted-replies) nell'hub per capire cosa la risoluzione può mancare e come correlare senza di essa.

## Il payload del webhook

`whatsapp.received` porta lo stesso ramo nell'envelope dell'evento, quindi un endpoint può agire sul testo senza rileggere il messaggio:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:04:11.118Z",
  "data": {
    "whatsapp_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
    "to": { "phone_number": "+13124495569" },
    "text": { "body": "Is my order out for delivery yet?" },
    "tags": null,
    "metadata": null
  }
}
```

## Aspetti da tenere d'occhio

- **Un messaggio di testo è il modo più economico per un contatto di riaprire la finestra.** Qualsiasi messaggio in entrata azzera la finestra di servizio a 24 ore, e un messaggio di testo è ciò che la maggior parte dei contatti invia; una risposta libera da parte tua è recapitabile da quel momento.
- **`from` può arrivare senza un numero di telefono.** Un contatto che ha adottato un nome utente WhatsApp ti raggiunge tramite [user ID con ambito business](/docs/guides/whatsapp/business-scoped-user-ids), quindi leggi l'identità da `from` anziché dare per scontato che `from.phone_number` sia impostato.
- **Il corpo è ciò che il contatto ha digitato.** Un tap su qualcosa che hai inviato arriva invece come [risposta interattiva](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies) su un ramo a sé.

## Prossimi passi

- [Come funziona la ricezione](/docs/guides/whatsapp/receiving-whatsapp): l'envelope in entrata, il recupero dei media e il webhook `whatsapp.received`
- [Messaggi di testo WhatsApp](/docs/guides/whatsapp/message-types/plain-text): il lato invio dello stesso ramo
- [Ricevere risposte interattive](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies): come arriva un tap su un pulsante o una riga di lista
- [Inviare messaggi WhatsApp](/docs/guides/whatsapp/sending-whatsapp): rispondere all'interno della finestra di servizio e citare un messaggio

## 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)