---
title: "Webhook grup WhatsApp"
description: "Payload untuk dua webhook grup WhatsApp, yang dipicu saat seseorang meminta bergabung ke grup yang memerlukan persetujuan dan saat mereka membatalkan permintaan tersebut."
canonical: "https://bird.com/id-id/dokumentasi/guides/whatsapp/webhooks/groups"
---

# Webhook grup WhatsApp

Dua event webhook melaporkan aktivitas permintaan bergabung pada [grup](/docs/guides/whatsapp/groups) yang memerlukan persetujuan. Keduanya merupakan tindakan pemohon sendiri, sehingga tidak muncul pada respons panggilan API apa pun yang Anda buat, dan permintaan yang diajukan lalu dibatalkan di antara dua kali pembacaan daftar tidak meninggalkan jejak. Berlangganan event ini agar Anda tidak perlu melakukan polling.

| Event                                 | Dipicu saat                                                       |
| ------------------------------------- | ----------------------------------------------------------------- |
| `whatsapp.group.join_request_created` | Seseorang membuka tautan undangan dan meminta bergabung           |
| `whatsapp.group.join_request_revoked` | Mereka membatalkan permintaan tersebut sebelum Anda memutuskannya |

Memutuskan permintaan tidak memicu event, karena hasilnya sudah ada pada respons panggilan Anda sendiri. Kedua event ini bukan bagian dari linimasa pesan.

## Join request created

```json
{
  "type": "whatsapp.group.join_request_created",
  "timestamp": "2026-09-22T10:07:57Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}
```

`timestamp` adalah waktu orang tersebut meminta bergabung.

## Join request revoked

```json
{
  "type": "whatsapp.group.join_request_revoked",
  "timestamp": "2026-09-22T11:12:03Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}
```

`data` sama dengan yang ada pada permintaan yang dibatalkannya, dengan `join_request.id` yang sama. `timestamp` adalah waktu permintaan dibatalkan.

## Field

| Field                       | Arti                                                                                                                                                                                                                                                 |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_id`                  | Grup yang ingin diikuti orang tersebut                                                                                                                                                                                                               |
| `whatsapp_number_id`        | Nomor bisnis yang membuat dan mengelola grup                                                                                                                                                                                                         |
| `workspace_id`              | Workspace pemilik grup                                                                                                                                                                                                                               |
| `join_request.id`           | Permintaan. ID yang sama dikembalikan oleh [daftar join-request](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group) dan digunakan oleh operasi approve dan reject secara batch, sehingga Anda dapat langsung memutuskan dari event |
| `join_request.bsuid`        | [ID pengguna cakupan bisnis](/docs/guides/whatsapp/business-scoped-user-ids) pemohon. Setiap permintaan membawanya, dan ID ini diteruskan ke `participants` jika Anda menyetujui, jadi gunakan ID ini sebagai kunci pada catatan Anda sendiri        |
| `join_request.phone_number` | Nomor pemohon dalam format E.164, atau `null` jika mereka belum membagikannya kepada bisnis Anda                                                                                                                                                     |
| `join_request.username`     | Username WhatsApp pemohon, atau `null` jika mereka belum memilihnya                                                                                                                                                                                  |

## Langkah selanjutnya

- [Mengelola grup WhatsApp](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group): menyetujui atau menolak permintaan
- [Webhook WhatsApp](/docs/guides/whatsapp/webhooks): event lain yang dapat Anda ikuti
- [Panduan webhook](/docs/guides/webhooks): endpoint, verifikasi tanda tangan, dan percobaan ulang

## 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)