# 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](/docs/knowledge-base/whatsapp/customer-service-window).

## Apa yang dibawa pesan teks masuk

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

```json
{
  "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](/docs/guides/whatsapp/message-types/plain-text#limits), 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:

```json
{
  "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](/docs/guides/whatsapp/receiving-whatsapp#quoted-replies) 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:

```json
{
  "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](/docs/guides/whatsapp/business-scoped-user-ids), 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](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies) pada arm tersendiri.

## Langkah selanjutnya

- [Cara kerja penerimaan](/docs/guides/whatsapp/receiving-whatsapp): envelope masuk, pengambilan media, dan webhook `whatsapp.received`
- [Pesan teks biasa WhatsApp](/docs/guides/whatsapp/message-types/plain-text): sisi kirim dari arm yang sama
- [Menerima balasan interaktif](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies): bentuk kedatangan ketukan pada tombol atau baris daftar
- [Mengirim pesan WhatsApp](/docs/guides/whatsapp/sending-whatsapp): membalas di dalam jendela layanan, dan mengutip pesan

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)