Sign inGet Started

Webhook grup WhatsApp

Dua event webhook melaporkan aktivitas permintaan bergabung pada grup 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.

EventDipicu saat
whatsapp.group.join_request_createdSeseorang membuka tautan undangan dan meminta bergabung
whatsapp.group.join_request_revokedMereka 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

Contoh kode
{
  "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

Contoh kode
{
  "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

FieldArti
group_idGrup yang ingin diikuti orang tersebut
whatsapp_number_idNomor bisnis yang membuat dan mengelola grup
workspace_idWorkspace pemilik grup
join_request.idPermintaan. ID yang sama dikembalikan oleh daftar join-request dan digunakan oleh operasi approve dan reject secara batch, sehingga Anda dapat langsung memutuskan dari event
join_request.bsuidID pengguna cakupan bisnis 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_numberNomor pemohon dalam format E.164, atau null jika mereka belum membagikannya kepada bisnis Anda
join_request.usernameUsername WhatsApp pemohon, atau null jika mereka belum memilihnya

Langkah selanjutnya