> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral

> Crie e gerencie grupos do WhatsApp

# Grupos

A API de grupos permite criar, gerenciar e interagir com grupos do WhatsApp.

<Note>
  Esta funcionalidade requer que a sessão tenha `allowGroup: true` e que o
  plano inclua o recurso de grupos.
</Note>

## Endpoints

<CardGroup cols={2}>
  <Card title="Criar Grupo" icon="plus" href="/api-reference/groups/create">
    Cria um novo grupo
  </Card>

  <Card title="Listar Grupos" icon="list" href="/api-reference/groups/list">
    Lista todos os grupos da sessão
  </Card>

  <Card title="Metadados" icon="info" href="/api-reference/groups/metadata">
    Obtém informações detalhadas
  </Card>

  <Card title="Participantes" icon="users" href="/api-reference/groups/participants">
    Gerencia membros do grupo
  </Card>

  <Card title="Configurações" icon="settings" href="/api-reference/groups/settings">
    Atualiza configurações do grupo
  </Card>

  <Card title="Convite" icon="link" href="/api-reference/groups/invite">
    Gerencia link de convite
  </Card>
</CardGroup>

## Permissões

As ações disponíveis dependem do papel do usuário no grupo:

| Ação                     | Participante | Admin | Criador |
| ------------------------ | ------------ | ----- | ------- |
| Enviar mensagens         | ✅            | ✅     | ✅       |
| Ver participantes        | ✅            | ✅     | ✅       |
| Adicionar membros        | ❌\*          | ✅     | ✅       |
| Remover membros          | ❌            | ✅     | ✅       |
| Alterar nome/descrição   | ❌\*          | ✅     | ✅       |
| Promover/rebaixar admins | ❌            | ❌\*\* | ✅       |
| Alterar configurações    | ❌            | ✅     | ✅       |

\* Depende das configurações do grupo\
\*\* Admins podem promover outros, mas apenas o criador pode rebaixar admins

## Formato do JID de Grupo

Grupos possuem JID no formato: `{id}@g.us`

**Exemplo:** `120363123456789012@g.us`