# Inbox entrou num grupo

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

A própria inbox foi adicionada ou entrou num grupo. `by` diz quem adicionou, quando foi outra pessoa. Assine `group.joined` 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 |  |

### Inbox entrou num grupo

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "group.joined",
  "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"
    },
    "by": {
      "id": "5511988887777@s.whatsapp.net"
    },
    "reason": "added",
    "at": "2026-10-17T12:00:00.000Z"
  }
}
```

## Referências

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