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 membahas bagian yang tidak khusus grup: setiap content arm, mengambil media masuk, 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), 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.

Membalas ke grup

Peserta yang menulis di grup membuka satu 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.

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 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 dengan ID pesan itu sendiri. Tidak ada yang berubah pada panggilan ini untuk grup.
• Bereaksi dengan satu emoji. Reaksi dikirim ke grup, sehingga setiap peserta melihatnya. Grup yang tidak aktif menolak perubahan dengan 409 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:

{
  "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, atau baca kembali seperti yang ditunjukkan di Mengelola grup WhatsApp.

Langkah berikutnya

• Mengirim ke grup WhatsApp: mengalamatkan grup, persyaratannya, dan tanda terima per peserta
• Mengelola grup WhatsApp: membuat grup melalui API, tautan undangan, permintaan bergabung, dan pin
• Grup WhatsApp: fungsi grup, dan batasan WhatsApp
• Menerima pesan WhatsApp: setiap content arm, media, dan quoted reply
• Business-scoped user ID: menyapa peserta yang nomor teleponnya tidak Anda miliki