Menerima pesan teks WhatsApp

Kontak yang mengetik di chat menghasilkan pesan masuk yang membawa text. Ini adalah arm masuk yang paling umum, dan arm yang membuka atau mereset jendela layanan pelanggan.

Apa yang dibawa pesan teks masuk

text.body berisi apa yang diketik kontak, dan tidak ada hal lain pada arm ini:

{
  "id": "wam_01kya19eknftrs2s6p82asmvnh",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "text": { "body": "Is my order out for delivery yet?" },
  "created_at": "2026-08-25T09:04:11Z"
}

preview_url adalah field sisi kirim. Pesan teks masuk tidak membawa flag untuk pratinjau tautan, apa pun yang dirender oleh klien kontak, sehingga URL di body terbaca kembali sebagai bagian dari teks.

Skema baca tidak menyatakan batas maksimum pada body masuk. Batas 4096 karakter ada di sisi kirim, jadi atur penyimpanan Anda sebagai teks tanpa batas, bukan mengikuti batas yang tidak dijanjikan oleh arm masuk.

Teks yang dikirim sebagai balasan kutipan

Ketika kontak membalas salah satu pesan Anda dengan mengutipnya, arm tidak berubah dan in_reply_to_message_id menyebutkan pesan yang mereka balas:

{
  "id": "wam_01kyb2m4xq7whs0d8n3prv6tez",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "text": { "body": "Yes, that one" },
  "created_at": "2026-08-25T09:06:02Z"
}

WhatsApp tidak menandai setiap balasan, dan balasan yang tidak ditandai tidak membawa ID sama sekali. Lihat balasan kutipan di hub untuk mengetahui apa yang bisa terlewat oleh resolusi dan cara mengorelasikan tanpa ID tersebut.

Payload webhook

whatsapp.received membawa arm yang sama pada envelope event, sehingga endpoint dapat bertindak berdasarkan teks tanpa membaca kembali pesan:

{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:04:11.118Z",
  "data": {
    "whatsapp_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100", "display_name": "Alex Rivera" },
    "to": { "phone_number": "+13124495569" },
    "text": { "body": "Is my order out for delivery yet?" },
    "tags": null,
    "metadata": null
  }
}

Hal yang perlu diperhatikan

• Teks adalah cara termurah bagi kontak untuk membuka kembali jendela. Setiap pesan masuk mereset jendela layanan ke 24 jam, dan teks adalah yang paling sering dikirim kontak; balasan bebas dari Anda dapat dikirimkan mulai saat itu.
• from bisa datang tanpa nomor telepon. Kontak yang telah menggunakan username WhatsApp menghubungi Anda melalui business-scoped user ID, jadi baca identitas dari from alih-alih mengasumsikan from.phone_number terisi.
• Body adalah ketikan kontak sendiri. Ketukan pada sesuatu yang Anda kirim tiba sebagai balasan interaktif pada arm tersendiri.

Langkah selanjutnya

• Cara kerja penerimaan: envelope masuk, pengambilan media, dan webhook whatsapp.received
• Pesan teks biasa WhatsApp: sisi kirim dari arm yang sama
• Menerima balasan interaktif: bentuk kedatangan ketukan pada tombol atau baris daftar
• Mengirim pesan WhatsApp: membalas di dalam jendela layanan, dan mengutip pesan