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:

Contoh kode

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

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channel Pahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builder Jelajahi kemampuannyaWhatsApp

Coba praktiknya dan dapatkan ringkasan implementasi