WhatsApp groepswebhooks
Twee webhook-events melden toetredingsverzoekactiviteit op een groep die goedkeuring vereist. Beide zijn het eigen initiatief van de aanvrager, dus geen van beide verschijnt in het antwoord op een call die je doet, en een verzoek dat wordt ingediend en geannuleerd tussen twee keer de lijst uitlezen laat niets achter. Abonneer je erop en je hoeft niet te pollen.
| Event | Wordt afgevuurd wanneer |
|---|---|
whatsapp.group.join_request_created | Iemand de uitnodigingslink opent en vraagt om lid te worden |
whatsapp.group.join_request_revoked | Diegene dat verzoek annuleert voordat je erover beslist |
Het beslissen over een verzoek vuurt geen event af, omdat het resultaat al in het antwoord op je eigen call staat. Geen van beide events maakt deel uit van de tijdlijn van een bericht.
Toetredingsverzoek aangemaakt
{
"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 is het moment waarop de persoon heeft gevraagd om lid te worden.
Toetredingsverzoek ingetrokken
{
"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"
}
}
}De data is dezelfde als op het verzoek dat het annuleert, met dezelfde join_request.id. timestamp is het moment waarop het verzoek werd geannuleerd.
Velden
| Veld | Betekenis |
|---|---|
group_id | De groep waar de persoon heeft gevraagd om lid te worden |
whatsapp_number_id | Het zakelijke nummer dat de groep heeft aangemaakt en beheert |
workspace_id | De werkruimte die eigenaar is van de groep |
join_request.id | Het verzoek. Dezelfde ID die de toetredingsverzoeklijst retourneert en die de batch-goedkeur- en afwijsoperaties verwachten, zodat je direct vanuit het event kunt beslissen |
join_request.bsuid | De zakelijk-scoped gebruikers-ID van de aanvrager. Elk verzoek bevat deze, en deze wordt overgenomen naar participants als je goedkeurt, dus gebruik deze als sleutel voor je eigen records |
join_request.phone_number | Het nummer van de aanvrager in E.164-formaat, of null als diegene het niet heeft gedeeld met je bedrijf |
join_request.username | De WhatsApp-gebruikersnaam van de aanvrager, of null als diegene er geen heeft gekozen |
Vervolgstappen
- WhatsApp-groepen beheren: een verzoek goedkeuren of afwijzen
- WhatsApp webhooks: de andere events waarop je je kunt abonneren
- Webhooks-gids: endpoints, handtekeningverificatie en opnieuw proberen
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.