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:

{
  "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