WhatsApp-Gruppen-Webhooks
Zwei Webhook-Events melden Beitrittsanfragen-Aktivität in einer Gruppe, die eine Genehmigung erfordert. Beide werden von der anfragenden Person selbst ausgelöst und erscheinen daher nicht in der Antwort auf Ihre eigenen Aufrufe. Eine Anfrage, die zwischen zwei Abfragen der Liste erstellt und wieder zurückgezogen wird, hinterlässt keine Spur. Abonnieren Sie die Events, und Sie müssen nicht pollen.
| Event | Wird ausgelöst, wenn |
|---|---|
whatsapp.group.join_request_created | Jemand den Einladungslink öffnet und um Beitritt bittet |
whatsapp.group.join_request_revoked | Die Person die Anfrage zurückzieht, bevor Sie darüber entscheiden |
Eine Entscheidung über eine Anfrage löst kein Event aus, weil das Ergebnis bereits in der Antwort auf Ihren eigenen Aufruf enthalten ist. Keines der beiden Events gehört zur Timeline einer Nachricht.
Beitrittsanfrage erstellt
{
"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 gibt an, wann die Person um Beitritt gebeten hat.
Beitrittsanfrage widerrufen
{
"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"
}
}
}Der data ist derselbe wie bei der Anfrage, die zurückgezogen wird, mit derselben join_request.id. timestamp gibt an, wann die Anfrage zurückgezogen wurde.
Felder
| Feld | Bedeutung |
|---|---|
group_id | Die Gruppe, der die Person beitreten möchte |
whatsapp_number_id | Die Business-Nummer, die die Gruppe erstellt hat und verwaltet |
workspace_id | Der Workspace, dem die Gruppe gehört |
join_request.id | Die Anfrage. Dieselbe ID, die die Beitrittsanfragen-Liste zurückgibt und die die Batch-Operationen zum Genehmigen und Ablehnen entgegennehmen – Sie können also direkt aus dem Event heraus entscheiden |
join_request.bsuid | Die geschäftsbezogene Benutzer-ID der anfragenden Person. Jede Anfrage enthält sie, und sie wird bei Genehmigung auf participants übertragen – verwenden Sie sie als Schlüssel für Ihre eigenen Datensätze |
join_request.phone_number | Die Nummer der anfragenden Person im E.164-Format, oder null, wenn sie diese nicht mit Ihrem Unternehmen geteilt hat |
join_request.username | Der WhatsApp-Benutzername der anfragenden Person, oder null, wenn sie keinen gewählt hat |
Nächste Schritte
- WhatsApp-Gruppen verwalten: eine Anfrage genehmigen oder ablehnen
- WhatsApp-Webhooks: die weiteren Events, die Sie abonnieren können
- Webhooks-Leitfaden: Endpoints, Signaturverifizierung und Wiederholungsversuche
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.