# Webhook dei gruppi WhatsApp

Due eventi webhook segnalano le richieste di adesione a un [gruppo](/docs/guides/whatsapp/groups) 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

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

## Richiesta di adesione revocata

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

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](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group) e accettato dalle operazioni batch di approvazione e rifiuto, così puoi decidere direttamente dall'evento |
| `join_request.bsuid`        | L'[ID utente con ambito aziendale](/docs/guides/whatsapp/business-scoped-user-ids) 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](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group): approvare o rifiutare una richiesta
- [Webhook WhatsApp](/docs/guides/whatsapp/webhooks): gli altri eventi a cui puoi iscriverti
- [Guida ai webhook](/docs/guides/webhooks): endpoint, verifica della firma e ripetizione dei tentativi

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