---
title: "WhatsApp-Gruppen-Webhooks"
description: "Payloads der zwei WhatsApp-Gruppen-Webhooks, die ausgelöst werden, wenn jemand einer Gruppe beitreten möchte, die eine Genehmigung erfordert, und wenn die Person diese Anfrage zurückzieht."
canonical: "https://bird.com/de-de/dokumentation/guides/whatsapp/webhooks/groups"
---

# WhatsApp-Gruppen-Webhooks

Zwei Webhook-Events melden Beitrittsanfragen-Aktivität in einer [Gruppe](/docs/guides/whatsapp/groups), 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

```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` gibt an, wann die Person um Beitritt gebeten hat.

## Beitrittsanfrage widerrufen

```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"
    }
  }
}
```

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](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group) 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](/docs/guides/whatsapp/business-scoped-user-ids) 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](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group): eine Anfrage genehmigen oder ablehnen
- [WhatsApp-Webhooks](/docs/guides/whatsapp/webhooks): die weiteren Events, die Sie abonnieren können
- [Webhooks-Leitfaden](/docs/guides/webhooks): Endpoints, Signaturverifizierung und Wiederholungsversuche

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