---
title: "Menerima pesan grup WhatsApp"
description: "Cara membaca pesan grup, peserta mana yang menulisnya, cara membalas ke grup, dan apa yang dibawa webhook whatsapp.received untuk pesan tersebut."
canonical: "https://bird.com/id-id/dokumentasi/guides/whatsapp/groups/receiving"
---

# Menerima pesan grup WhatsApp

Apa pun yang ditulis peserta dalam grup tiba seperti pesan masuk WhatsApp lainnya: event `whatsapp.received` yang sama, content arm yang sama, media fetch yang sama. Dua hal khusus untuk grup. Pesan mencantumkan peserta yang menulisnya dan grup tempatnya masuk, serta balasan Anda dikirim ke grup, bukan ke orang tersebut.

[Menerima pesan WhatsApp](/docs/guides/whatsapp/receiving-whatsapp) membahas bagian yang tidak khusus grup: setiap content arm, [mengambil media masuk](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media), dan quoted reply.

## Apa yang dibawa pesan grup

Pesan grup masuk terbaca dengan dua alamat, bukan satu:

- **`from` adalah peserta yang menulisnya**, bukan grup. Di dalamnya terdapat `bsuid` mereka ([business-scoped user ID](/docs/guides/whatsapp/business-scoped-user-ids)), `phone_number` mereka jika bisnis Anda mengetahuinya, serta `username` dan `display_name` mereka jika mereka menerbitkan profil. Peserta yang belum membagikan nomornya kepada Anda diidentifikasi hanya oleh `bsuid`, dan itu sudah cukup untuk mengalamatkan mereka.
- **`to` membawa nomor bisnis Anda dan grup.** `phone_number` adalah nomor yang menerima pesan, dan `group_id` adalah grup tempat pesan tersebut masuk.

`group_id` muncul di `to` dan tidak di tempat lain, sehingga kehadirannya di sana yang membedakan pesan grup dari pesan satu-ke-satu, di kedua arah. Pesan grup tidak membawa penghitung: `recipient_count`, `delivered_count`, dan `read_count` melaporkan fan-out keluar, dan pesan masuk tidak memilikinya.

Untuk membaca thread satu grup dalam kedua arah sekaligus, filter daftar pesan berdasarkan `group_id` seperti yang ditunjukkan [Mengirim ke grup WhatsApp](/docs/guides/whatsapp/groups/sending#4-read-one-groups-conversation).

## Membalas ke grup

Peserta yang menulis di grup membuka satu [customer service window](/docs/knowledge-base/whatsapp/customer-service-window) 24 jam untuk seluruh grup, bukan satu per orang. Selama jendela terbuka, konten bebas bentuk dapat menjangkau grup; setelah habis, hanya template. Alamatkan balasan ke grup, dengan group ID di `to` dan tanpa `from`. Lihat [Mengirim ke grup WhatsApp](/docs/guides/whatsapp/groups/sending).

Menulis ke peserta tersebut secara pribadi adalah percakapan terpisah dengan jendelanya sendiri, dan pesan grup tidak membukanya. Pesan bebas bentuk yang dialamatkan ke nomor telepon atau `bsuid` mereka ditolak dengan `422` [`E15044`](/docs/api/errors/E15044) kecuali mereka telah mengirim pesan terpisah ke bisnis Anda dalam 24 jam terakhir. Template tetap dapat menjangkau mereka.

## Konfirmasi dan reaksi

Kedua bentuk konfirmasi berfungsi pada pesan grup dan menggunakan panggilan yang sama seperti pada pesan masuk lainnya:

- [Tandai sebagai dibaca](/docs/guides/whatsapp/mark-message-as-read) dengan ID pesan itu sendiri. Tidak ada yang berubah pada panggilan ini untuk grup.
- [Bereaksi](/docs/guides/whatsapp/reactions) dengan satu emoji. Reaksi dikirim ke grup, sehingga setiap peserta melihatnya. Grup yang tidak aktif menolak perubahan dengan `409` [`E15047`](/docs/api/errors/E15047), yaitu satu-satunya penolakan yang dimiliki reaksi pada pesan grup tetapi tidak pada reaksi satu-ke-satu.

## Webhook

`whatsapp.received` membawa pesan grup pada envelope yang sama seperti pesan lainnya, dengan grup di `to`:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-09-15T14:05:41.204Z",
  "data": {
    "whatsapp_id": "wam_01kya1b3xdq7fe8m2v5t9rncgs",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+15550002222", "bsuid": "US.AbC1", "display_name": "Dana Reyes" },
    "to": { "phone_number": "+15550001111", "group_id": "wag_01krdgeqcxet5s7t44vh8rt9mg" },
    "text": { "body": "Got it, thanks." },
    "tags": null,
    "metadata": null
  }
}
```

Baca `data.to.group_id` untuk merutekan pesan ke thread grup, dan `data.from` untuk mengatribusikannya ke peserta. Subscriber yang mendasarkan percakapan hanya pada `from` akan memecah setiap peserta grup ke thread terpisah dan kehilangan konteks grup.

Tidak ada event untuk grup itu sendiri. Seseorang bergabung atau keluar, perubahan nama, atau pin tidak menghasilkan webhook, sehingga keanggotaan grup dibaca, bukan di-push: buka grup di halaman [**Groups**](https://bird.com/dashboard/w/whatsapp/groups), atau baca kembali seperti yang ditunjukkan di [Mengelola grup WhatsApp](/docs/guides/whatsapp/groups/management#2-wait-for-whatsapp-to-confirm-it).

## Langkah berikutnya

- [Mengirim ke grup WhatsApp](/docs/guides/whatsapp/groups/sending): mengalamatkan grup, persyaratannya, dan tanda terima per peserta
- [Mengelola grup WhatsApp](/docs/guides/whatsapp/groups/management): membuat grup melalui API, tautan undangan, permintaan bergabung, dan pin
- [Grup WhatsApp](/docs/guides/whatsapp/groups): fungsi grup, dan batasan WhatsApp
- [Menerima pesan WhatsApp](/docs/guides/whatsapp/receiving-whatsapp): setiap content arm, media, dan quoted reply
- [Business-scoped user ID](/docs/guides/whatsapp/business-scoped-user-ids): menyapa peserta yang nomor teleponnya tidak Anda miliki

## 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](/whatsapp-api) (product)

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