# Webhook per messaggi in entrata WhatsApp

Quando un contatto ti invia un messaggio, Bird invia `whatsapp.received` al tuo endpoint. Il payload usa l'[envelope evento WhatsApp](/docs/guides/whatsapp/webhooks#the-event-envelope) e include i [campi presenti in ogni evento messaggio](/docs/guides/whatsapp/webhooks#fields-every-message-event-carries).

## Il payload received

`whatsapp.received` include il contenuto del messaggio oltre ai campi presenti in ogni evento messaggio, così un endpoint può elaborare un messaggio in entrata senza doverlo rileggere. Un tap su un messaggio interattivo arriva come `interactive_reply`, e `in_reply_to_message_id` indica il messaggio a cui risponde:

```json
{
  "data": {
    "direction": "inbound",
    "from": {
      "display_name": "Alex Rivera",
      "phone_number": "+14155550100",
      "username": "alexr"
    },
    "in_reply_to_message_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "interactive_reply": {
      "list": {
        "description": "Next day to 2 days",
        "slug": "priority_express",
        "text": "Priority Mail Express"
      },
      "type": "list"
    },
    "metadata": null,
    "tags": null,
    "to": { "phone_number": "+13124495569" },
    "whatsapp_id": "wam_01ky8b3xq4gd7pmzn2ka51f7te",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:52:04.118Z",
  "type": "whatsapp.received"
}
```

Le altre sezioni di contenuto seguono la stessa struttura a scelta singola: `text`, `image`, `video`, `audio`, `sticker`, `document`, `location`, `contact_cards` e `unsupported` per un tipo che API non modella. [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message) documenta ciascuna di esse.

## Passaggi successivi

- [Ricezione dei messaggi WhatsApp](/docs/guides/whatsapp/receiving-whatsapp): ogni sezione di contenuto e recupero dei media in entrata
- [Webhook per le reazioni](/docs/guides/whatsapp/webhooks/reactions): le reazioni di un contatto arrivano separatamente
- [Webhook per lo stato dei messaggi](/docs/guides/whatsapp/webhooks/message-status): payload di consegna e di errore per i messaggi che invii

## 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](/whatsapp-api) (product)

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