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 e include i campi presenti in ogni evento messaggio.

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:

Esempio di codice

{
  "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} documenta ciascuna di esse.

Passaggi successivi

Ricezione dei messaggi WhatsApp: ogni sezione di contenuto e recupero dei media in entrata
Webhook per le reazioni: le reazioni di un contatto arrivano separatamente
Webhook per lo stato dei messaggi: payload di consegna e di errore per i messaggi che invii

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 channel Comprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builder Esplora la funzionalitàWhatsApp

Prova l'esercitazione e ottieni un brief di implementazione