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

# Grupos do WhatsApp

> A base do Switchbord para conversas via Meta Groups API e pilotos internos de grupos de equipe.

# Grupos do WhatsApp

O Switchbord agora inclui a primeira base para conversas em grupo do WhatsApp. A caixa de entrada pode marcar conversas como grupos, exibir resumos de grupo e filtrar a lista de conversas para **Grupos**, voltado a testes internos da equipe.

<Info>
  Esta é uma camada de base. Ela ainda não oferece gerenciamento completo do ciclo de vida do grupo, gerenciamento de participantes ou aplicação completa das regras de envio em grupo.
</Info>

## Restrições da Meta Groups API

A Groups API da Meta tem restrições diferentes das mensagens padrão um a um pela Cloud API:

* As empresas precisam ter uma **Conta Comercial Oficial (OBA)** para usar os recursos da Groups API.
* Os grupos são apenas por convite, e os participantes entram por meio de um link de convite de grupo.
* Máximo de participantes por grupo: **8**.
* Os tipos de mensagem suportados incluem texto, mídia, templates baseados em texto e templates baseados em mídia.
* Experiências não suportadas incluem Calling API, mensagens que desaparecem, mensagens de visualização única, mensagens de autenticação, mensagens de comércio e mensagens interativas.
* As análises de template não estão disponíveis para templates usados em grupos; crie templates separados para uso em grupo.

## Suporte atual do Switchbord

A base da v0.15.53 adiciona:

* Resumos de domínio `Conversation.isGroup` e `Conversation.group`.
* Detecção de grupo baseada em metadados a partir de `conversations.metadata` (`chatType`, `conversationType`, `type` ou `isGroup`).
* Um filtro (pill) exclusivo para Grupos em `/inbox`, ao lado dos filtros existentes na lista de conversas.
* Suporte no lado do servidor para `groupsOnly=1` em `/api/inbox/conversations`.
* Um índice de metadados do Supabase para descoberta de conversas em grupo.
* Dados fictícios de grupo interno da equipe para QA inicial.

## Formato recomendado de metadados

Até que uma tabela dedicada de grupos seja implementada, as conversas em grupo devem carregar metadados semelhantes a:

```json theme={null}
{
  "chatType": "group",
  "groupId": "120363012345678901@g.us",
  "groupName": "Internal Team · May arrivals",
  "participantCount": 6
}
```

Evite retornar links de convite em respostas amplas da lista da caixa de entrada, a menos que a ação do operador realmente precise deles.

## Limitações atuais

* A caixa de entrada consegue filtrar e identificar grupos, mas o painel de detalhes selecionado ainda precisa de um refinamento na apresentação voltada a grupos.
* As restrições de envio específicas de grupo ainda não estão totalmente aplicadas.
* O gerenciamento da lista de participantes não está implementado.
* A criação/renovação de links de convite não está implementada.
* Templates e análises de grupo devem ser separados dos templates de campanha um a um.

## Checklist de implementação de acompanhamento

1. Destacar o nome do grupo, o id do grupo e a contagem de participantes na linha da lista, no cabeçalho e no painel de detalhes lateral.
2. Adicionar proteções de envio específicas de grupo para tipos de mensagem não suportados.
3. Adicionar importação/sincronização de grupo a partir da Meta Groups API, uma vez confirmada a elegibilidade de OBA.
4. Adicionar gerenciamento de participantes e ações de link de convite protegidos por permissões explícitas.
5. Adicionar testes usando o grupo interno da equipe como o primeiro alvo de QA em produção.