Webhooki grup WhatsApp
Dwa zdarzenia webhookowe informują o aktywności związanej z prośbami o dołączenie do grupy wymagającej zatwierdzenia. Oba są wynikiem działania samego wnioskującego, więc żadne z nich nie pojawia się w odpowiedzi na żadne Twoje wywołanie, a prośba złożona i anulowana między dwoma odczytami listy nie zostawia śladu. Zasubskrybuj je, a nie musisz odpytywać.
| Zdarzenie | Kiedy jest wywoływane |
|---|---|
whatsapp.group.join_request_created | Ktoś otwiera link z zaproszeniem i prosi o dołączenie |
whatsapp.group.join_request_revoked | Anuluje tę prośbę, zanim ją rozpatrzysz |
Rozpatrzenie prośby nie wyzwala żadnego zdarzenia, ponieważ wynik jest już w odpowiedzi na Twoje własne wywołanie. Żadne z tych zdarzeń nie jest częścią osi czasu wiadomości.
Prośba o dołączenie utworzona
{
"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 to moment, w którym osoba poprosiła o dołączenie.
Prośba o dołączenie cofnięta
{
"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"
}
}
}data jest taki sam jak w prośbie, którą anuluje, z tym samym join_request.id. timestamp to moment anulowania prośby.
Pola
| Pole | Znaczenie |
|---|---|
group_id | Grupa, do której osoba poprosiła o dołączenie |
whatsapp_number_id | Numer firmowy, który utworzył grupę i nią zarządza |
workspace_id | Obszar roboczy będący właścicielem grupy |
join_request.id | Prośba. To samo ID, które zwraca lista próśb o dołączenie i które przyjmują operacje zbiorczego zatwierdzania i odrzucania, więc możesz podjąć decyzję bezpośrednio z poziomu zdarzenia |
join_request.bsuid | ID użytkownika w zakresie firmy wnioskującego. Każda prośba je zawiera i jest ono przenoszone do participants po zatwierdzeniu, więc używaj go jako klucza we własnych rekordach |
join_request.phone_number | Numer wnioskującego w formacie E.164 lub null, jeśli nie udostępnił go Twojej firmie |
join_request.username | Nazwa użytkownika WhatsApp wnioskującego lub null, jeśli jej nie wybrał |
Następne kroki
- Zarządzanie grupami WhatsApp: zatwierdzanie lub odrzucanie prośby
- Webhooki WhatsApp: inne zdarzenia, które możesz subskrybować
- Przewodnik po webhookach: endpointy, weryfikacja podpisu i ponowne próby
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.