---
title: "Webhooks de groupe WhatsApp"
description: "Charges utiles des deux webhooks de groupe WhatsApp, déclenchés lorsqu'une personne demande à rejoindre un groupe nécessitant une approbation et lorsqu'elle annule cette demande."
canonical: "https://bird.com/fr-fr/documentation/guides/whatsapp/webhooks/groups"
---

# Webhooks de groupe WhatsApp

Deux événements webhook signalent l'activité des demandes d'adhésion sur un [groupe](/docs/guides/whatsapp/groups) nécessitant une approbation. Les deux résultent d'une action du demandeur : aucun n'apparaît dans la réponse à vos propres appels, et une demande créée puis annulée entre deux lectures de la liste ne laisse aucune trace. Abonnez-vous à ces événements et vous n'avez plus besoin d'interroger l'API.

| Événement                             | Se déclenche quand                                                       |
| ------------------------------------- | ------------------------------------------------------------------------ |
| `whatsapp.group.join_request_created` | Une personne ouvre le lien d'invitation et demande à rejoindre le groupe |
| `whatsapp.group.join_request_revoked` | Elle annule cette demande avant que vous ne la traitiez                  |

Le traitement d'une demande ne déclenche aucun événement, car le résultat figure déjà dans la réponse à votre propre appel. Aucun de ces événements ne fait partie de la chronologie d'un message.

## Demande d'adhésion créée

```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` correspond au moment où la personne a demandé à rejoindre le groupe.

## Demande d'adhésion révoquée

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

Le `data` est identique à celui de la demande qu'il annule, avec le même `join_request.id`. `timestamp` correspond au moment où la demande a été annulée.

## Champs

| Champ                       | Signification                                                                                                                                                                                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_id`                  | Le groupe que la personne a demandé à rejoindre                                                                                                                                                                                                                                                    |
| `whatsapp_number_id`        | Le numéro professionnel qui a créé et administre le groupe                                                                                                                                                                                                                                         |
| `workspace_id`              | L'espace de travail propriétaire du groupe                                                                                                                                                                                                                                                         |
| `join_request.id`           | La demande. Le même identifiant que celui renvoyé par la [liste des demandes d'adhésion](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group) et accepté par les opérations d'approbation et de rejet par lot : vous pouvez donc traiter la demande directement depuis l'événement |
| `join_request.bsuid`        | L'[identifiant utilisateur à portée professionnelle](/docs/guides/whatsapp/business-scoped-user-ids) du demandeur. Chaque demande le contient, et il est repris dans `participants` si vous approuvez la demande : utilisez-le comme clé dans vos propres enregistrements                          |
| `join_request.phone_number` | Le numéro du demandeur au format E.164, ou `null` s'il ne l'a pas partagé avec votre entreprise                                                                                                                                                                                                    |
| `join_request.username`     | Le nom d'utilisateur WhatsApp du demandeur, ou `null` s'il n'en a pas choisi                                                                                                                                                                                                                       |

## Étapes suivantes

- [Gérer les groupes WhatsApp](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group) : approuver ou rejeter une demande
- [Webhooks WhatsApp](/docs/guides/whatsapp/webhooks) : les autres événements auxquels vous pouvez vous abonner
- [Guide des webhooks](/docs/guides/webhooks) : points de terminaison, vérification de signature et réessais

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