Webhook dei gruppi WhatsApp

Due eventi webhook segnalano le richieste di adesione a un gruppo che richiede approvazione. Entrambi sono azioni del richiedente, quindi nessuno dei due compare nella risposta a una chiamata che fai tu, e una richiesta creata e annullata tra due letture della lista non lascia traccia. Iscriviti a questi eventi e non dovrai fare polling.

Evento	Si attiva quando
whatsapp.group.join_request_created	Qualcuno apre il link di invito e chiede di entrare
whatsapp.group.join_request_revoked	L'utente annulla la richiesta prima che tu la gestisca

Gestire una richiesta non genera alcun evento, perché il risultato è già nella risposta alla tua chiamata. Nessuno dei due eventi fa parte della timeline di un messaggio.

Richiesta di adesione creata

Esempio di codice

{
  "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 indica quando la persona ha chiesto di entrare.

Richiesta di adesione revocata

Esempio di codice

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

Il data è lo stesso della richiesta che annulla, con lo stesso join_request.id. timestamp indica quando la richiesta è stata annullata.

Campi

Campo	Significato
group_id	Il gruppo a cui la persona ha chiesto di entrare
whatsapp_number_id	Il numero aziendale che ha creato e amministra il gruppo
workspace_id	Lo spazio di lavoro proprietario del gruppo
join_request.id	La richiesta. Lo stesso ID restituito dalla lista delle richieste di adesione e accettato dalle operazioni batch di approvazione e rifiuto, così puoi decidere direttamente dall'evento
join_request.bsuid	L'ID utente con ambito aziendale del richiedente. Ogni richiesta lo contiene e viene trasferito a participants se approvi, quindi usalo come chiave nei tuoi record
join_request.phone_number	Il numero del richiedente in formato E.164, oppure null se non lo ha condiviso con la tua azienda
join_request.username	Il nome utente WhatsApp del richiedente, oppure null se non ne ha scelto uno

Prossimi passi

Gestione dei gruppi WhatsApp: approvare o rifiutare una richiesta
Webhook WhatsApp: gli altri eventi a cui puoi iscriverti
Guida ai webhook: endpoint, verifica della firma e ripetizione dei tentativi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channel Comprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builder Esplora la funzionalitàWhatsApp

Prova l'esercitazione e ottieni un brief di implementazione