Webhooks de groupe WhatsApp
Deux événements webhook signalent l'activité des demandes d'adhésion sur un groupe 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
{
"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
{
"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 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 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 : approuver ou rejeter une demande
- Webhooks WhatsApp : les autres événements auxquels vous pouvez vous abonner
- Guide des webhooks : points de terminaison, vérification de signature et réessais
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.