Webhook pesan masuk WhatsApp

Saat kontak mengirim pesan kepada Anda, Bird mengirimkan whatsapp.received ke endpoint Anda. Payload menggunakan envelope event WhatsApp dan membawa field yang ada di setiap event pesan.

Payload received

whatsapp.received membawa konten pesan di atas field yang ada di setiap event pesan, sehingga endpoint dapat memproses pesan masuk tanpa membacanya kembali. Ketukan pada pesan interaktif masuk sebagai interactive_reply, dan in_reply_to_message_id menyebutkan pesan yang dijawabnya:

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

Cabang konten lainnya mengikuti bentuk salah-satu-dari yang sama: text, image, video, audio, sticker, document, location, contact_cards, dan unsupported untuk jenis yang tidak dimodelkan oleh API. GET /v1/whatsapp/messages/{message_id} mendokumentasikan masing-masing cabang.

Langkah selanjutnya

• Menerima pesan WhatsApp: setiap cabang konten dan pengambilan media masuk
• Webhook reaksi: reaksi kontak masuk secara terpisah
• Webhook status pesan: payload pengiriman dan kegagalan untuk pesan yang Anda kirim