# Participantes do grupo

**Evento:** `group.participants` · **Transporte:** POST para o seu receptor

Alguém entrou, saiu, foi removido, promovido ou rebaixado num grupo. É o único aviso disso em tempo real: o registro também fica gravado como mensagem (`type: group_participant`) para a busca e o histórico do grupo, mas não sai em `message.received`. Assine `group.participants` num webhook (`POST /webhooks`).

**Estado:** Disponível

## Compatibilidade de canais

| Canal | Compatível | Observação |
|---|---|---|
| WhatsApp (Web) | Sim |  |
| WhatsApp (API oficial) | Não |  |
| Instagram | Não |  |
| Messenger | Não |  |
| Telegram | Não |  |

### Participantes do grupo

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "group.participants",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": {
    "id": "r0269625d29bfbd",
    "name": "loja",
    "phone": "5511888888888",
    "channel": "whatsapp_web"
  },
  "data": {
    "group": {
      "id": "120363028782550019@g.us",
      "name": "Clientes VIP"
    },
    "action": "joined",
    "participants": [
      {
        "id": "5511988887777@s.whatsapp.net"
      }
    ],
    "at": "2026-10-17T12:00:00.000Z"
  }
}
```

## Referências

- [Eventos e webhooks](/docs/webhook)
- [Contrato OpenAPI completo](/openapi-bundled.json)