# Configuração de Grupos - Chatbot v3
## Comportamento Padrão
| Tipo | Comportamento |
|------|---------------|
| **Chat Privado** | Sempre responde |
| **Grupo** | Ignorado por padrão |
| **Grupo + @menção** | Responde se grupos habilitados |
## Como Funciona
```
Mensagem recebida
│
▼
É do número autorizado? ──NO──▶ Ignora
│
YES
│
▼
É grupo? ──NO──▶ Processa normalmente
│
YES
│
▼
Grupos habilitados? ──NO──▶ Ignora
│
YES
│
▼
Foi @mencionado? ──NO──▶ Ignora
│
YES
│
▼
Na whitelist? ──NO──▶ Ignora (se whitelist não vazia)
│
YES
│
▼
Processa e responde no grupo
```
---
## Comandos de Configuração
### Via Chat Privado
```
Você: habilitar grupos
Bot: Grupos habilitados! Agora responderei em grupos quando for @mencionado.
Você: desabilitar grupos
Bot: Grupos desabilitados. Ignorarei todas mensagens de grupo.
Você: responder só com @
Bot: Configurado! Só responderei em grupos quando for @mencionado.
Você: responder sempre em grupos
Bot: Configurado! Responderei todas mensagens em grupos habilitados.
```
### Whitelist de Grupos
```
Você: adicionar grupo Trabalho na whitelist
Bot: Grupo "Trabalho" adicionado à whitelist!
Você: remover grupo Trabalho da whitelist
Bot: Grupo "Trabalho" removido da whitelist.
Você: listar whitelist
Bot: Grupos na whitelist:
- Trabalho (120363xxx@g.us)
- Família (120363yyy@g.us)
Você: limpar whitelist
Bot: Whitelist limpa! Agora responderei em qualquer grupo habilitado.
```
### Via Grupo (quando mencionado)
```
No grupo "Trabalho":
Maria: @Bot adiciona este grupo
Bot: Grupo "Trabalho" adicionado à minha whitelist!
Maria: @Bot remove este grupo
Bot: Grupo "Trabalho" removido da whitelist. Não responderei mais aqui.
```
---
## Configuração no Redis
A config é salva em: `uazapi:config:grupos`
```json
{
"grupos_habilitados": false,
"responder_apenas_mencao": true,
"grupos_whitelist": [
{ "nome": "Trabalho", "id": "120363xxx@g.us" },
{ "nome": "Família", "id": "120363yyy@g.us" }
]
}
```
### Valores Padrão
- `grupos_habilitados`: `false` (grupos desabilitados)
- `responder_apenas_mencao`: `true` (só responde com @)
- `grupos_whitelist`: `[]` (vazio = aceita qualquer grupo se habilitado)
---
## Variáveis de Ambiente
Adicione ao n8n:
```env
# Número do bot para detectar @menção
BOT_PHONE_NUMBER=5511999999999
```
---
## Cenários de Uso
### Cenário 1: Ignorar Todos os Grupos (Padrão)
- Config: `grupos_habilitados: false`
- Resultado: Só responde em chat privado
### Cenário 2: Responder em Qualquer Grupo com @
- Config: `grupos_habilitados: true`, `responder_apenas_mencao: true`, `whitelist: []`
- Resultado: Responde em qualquer grupo quando @mencionado
### Cenário 3: Apenas Grupos Específicos com @
- Config: `grupos_habilitados: true`, `responder_apenas_mencao: true`, `whitelist: [...]`
- Resultado: Só responde em grupos da whitelist quando @mencionado
### Cenário 4: Sempre em Grupos Específicos
- Config: `grupos_habilitados: true`, `responder_apenas_mencao: false`, `whitelist: [...]`
- Resultado: Responde todas mensagens nos grupos da whitelist
---
## Exemplos de Conversa em Grupo
### Com @menção
```
No grupo "Trabalho" (whitelist, @menção habilitada):
João: Alguém sabe o telefone do cliente?
Maria: Não lembro
Pedro: @Bot qual o telefone do João Silva?
Bot: O telefone do João Silva é +55 11 99999-9999
```
### Sem @menção (ignorado)
```
No grupo "Trabalho":
João: Bot, qual o telefone do cliente?
(sem resposta - não foi @mencionado)
João: @Bot qual o telefone do cliente?
Bot: O telefone é +55 11 99999-9999
```
### Grupo fora da whitelist
```
No grupo "Festa" (não está na whitelist):
Maria: @Bot oi
(sem resposta - grupo não está na whitelist)
```
---
## Dicas
1. **Comece com grupos desabilitados** - É o padrão mais seguro
2. **Use whitelist** - Evita responder em grupos indesejados
3. **@menção é recomendado** - Evita spam no grupo
4. **Configure pelo chat privado** - Mais fácil e seguro
5. **Teste antes** - Adicione um grupo de teste primeiro