> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/gestao-de-grupos-whatsapp.md). # Gestão de Grupos WhatsApp ### Finalidade **Gestão de Grupos WhatsApp** administra grupos das conexões WhatsApp compatíveis (**Baileys**, **WhatsMeow**, **DigiAPI**): ações em **lote**, edição **manual**, **participantes** e automações (**Ban List**, **Word List**, **saudação**, **despedida**, **ban por votação**). Não confundir com **Grupos (Chat Interno)** na Gestão de Equipe (grupos de usuários Digitalsac). \[\[FOTO]] *** ### Caminho / permissão / licença | Item | Valor | | ----------- | --------------------------------------------- | | **Menu** | Configurações → **Gestão de Grupos WhatsApp** | | **URL** | `/configuracoes/grupos-whatsapp` | | **Perfil** | **Admin** | | **Licença** | **PLUS** | #### Pré-requisitos práticos | Requisito | Por quê | | -------------------------------------- | ------------------------------------------------------------------------------------- | | Conexão WhatsApp / WhatsMeow / DigiAPI | Outros canais (WABA, Telegram etc.) não entram no select | | Preferência: status **CONNECTED** | Operações falham se a sessão estiver indisponível | | Bot **admin do grupo** | Remoção, promote/demote, ban automático e word list “remover” exigem admin | | Configuração do grupo **ativa** | Automação só roda com config ativa; ao **sair do grupo**, a config local fica inativa | \[\[FOTO]] *** ### Seleção de conexão e lista 1. Selecione a **Conexão WhatsApp** (driver + status). 2. Opcional: **Recarregar grupos**. 3. Sem conexão: aviso para selecionar. 4. Com conexão: lista à esquerda (filtro por nome) + painel do grupo à direita. **Cabeçalho do grupo:** foto, nome, JID, quantidade de participantes; badges se “apenas admins enviam” / “apenas admins editam”. \[\[FOTO]] *** ### Abas — visão geral **Gestão** | Aba | Função | | ------------------- | ---------------------------------- | | **Gestão Grupos** | Lotes + histórico | | **Gestão Grupos 2** | Edição manual do grupo selecionado | | **Gestão Usuários** | Participantes | **Automação / moderação** | Aba | Função | | ------------------- | ---------------------------------- | | **Ban List** | Números banidos + auto-remoção | | **Word List** | Moderação por palavras | | **Saudação** | Boas-vindas ao entrar | | **Despedida** | Mensagem ao sair | | **Ban por Votação** | Quorum de votos para remover/banir | \[\[FOTO]] *** ### Aba Gestão Grupos (lote) | Ação | Função | | ---------------------------- | ----------------------------------------------------- | | **Criar grupos em lote** | Criação em massa | | **Atualizar grupos em lote** | Atualização (exige grupos carregados) | | **Participantes em lote** | Add/remove em massa | | **Exportar participantes** | Só o grupo selecionado **ou** todos da conexão (XLSX) | #### Fluxo seguro do lote 1. Preencher o formulário 2. **Pré-visualizar** (contagens / estimativa) 3. **Simular** (dry-run — não chama o WhatsApp de fato) 4. **Confirmar** (execução real na fila) Há **delay** entre itens e **limite** de quantidade por lote (configurável no servidor; padrão na casa de centenas). #### Histórico de lotes | Coluna / ação | Conteúdo | | -------------- | --------------------------------------------------- | | Tipo | Criação · Atualização · Participantes · Exportação | | Status | Pendente · Processando · Concluído · Parcial · Erro | | Itens / resumo | Sucessos e erros | | Download | Arquivo da exportação (quando houver) | | Detalhes | Progresso item a item | | Excluir | Bloqueado enquanto **Processando** | \[\[FOTO]] *** ### Aba Gestão Grupos 2 (manual) | Seção | Campos / ações | | ------------------------- | ------------------------------------------------------------------------------------------------- | | **Identidade** | Nome (máx. 100) · Descrição · Foto | | **Permissões** | Apenas admins enviam (anúncio) · Apenas admins editam infos · Todos podem adicionar participantes | | **Mensagens temporárias** | Desabilitado · 24h · 7 dias · 90 dias → Aplicar | | **Link de convite** | Obter · Copiar · Revogar e gerar novo | | **Zona de risco** | **Sair do grupo** (confirmação; config local permanece, mas fica inativa) | **WhatsMeow:** o toggle “todos podem adicionar” pode **não ser suportado** (a UI avisa; backend ignora). \[\[FOTO]] *** ### Aba Gestão Usuários | Controle | Detalhe | | ------------- | -------------------------------------------------- | | **Adicionar** | Números DDI+DDD+Número (um por linha ou vírgula) | | **Filtro** | Por nome/número na lista | | **Papéis** | Dono · Admin · Membro | | **Seleção** | **Promover** · **Rebaixar** · **Remover do grupo** | \[\[FOTO]] *** ### Aba Ban List | Campo / controle | Detalhe | | ------------------------------------- | ------------------------------------------------------------ | | **Número** | Só dígitos (DDI+DDD+Número) | | **Motivo** | Opcional | | **Tabela** | Número · Motivo · Ativo/Inativo · Ativar/Desativar · Remover | | **Remover automaticamente ao entrar** | Se o banido entrar, o bot remove (precisa ser **admin**) | | **Aviso no grupo** | Toggle + template | | **Variáveis** | `{user}`, `{number}`, `{reason}`, `{groupName}` | | **Template vazio** | Com notify ligado → modo **silencioso** (sem texto) | Quando dispara: evento de **entrada** de participante + ban ativo + `banEnabled`. \[\[FOTO]] *** ### Aba Word List | Campo | Detalhe | | ----------------------- | ---------------------------------------------------------------------- | | **Palavra/Termo** | Texto da regra | | **Tipo** | Contém · Exata · Regex | | **Ação** | **Avisar** · **Remover** (apaga a mensagem + aviso opcional) | | **Tabela** | Ativar/desativar · Remover | | **Habilitar moderação** | Master toggle | | **Aviso no grupo** | Toggle · marcar autor (@) · template | | **Variáveis** | `{user}`, `{number}`, `{term}`, `{action}`, `{removed}`, `{groupName}` | Quando dispara: mensagem de grupo (não enviada pelo bot), body não vazio, moderação ligada e regra **Ativa**. Remoção exige bot admin. \[\[FOTO]] *** ### Aba Saudação | Campo | Detalhe | | ---------------- | ------------------------------------------------------------------------ | | **Habilitar** | Toggle | | **Enviar em** | **No grupo** ou **No privado** | | **Mensagem** | Variáveis `{groupName}`, `{participant}`, `{number}`, `{connectionName}` | | Preview + Salvar | — | Dispara na **entrada** do participante (não saudação do próprio bot). *** ### Aba Despedida Mesmos campos da saudação, para **saída** / remoção do participante. \[\[FOTO]] *** ### Aba Ban por Votação | Campo | Detalhe | | ---------------------------- | ------------------------------------------ | | **Habilitar** | Toggle | | **Comando** | Ex.: `!banir`, `/ban` | | **Votos necessários** | Mínimo 2 na UI | | **Janela (segundos)** | Mínimo 30s | | **Ação ao quorum** | Remover · Adicionar ao Ban · Remover + Ban | | **Proteger administradores** | Toggle (recomendado ligado) | | **Feedback no grupo** | Toggle + templates de eventos/resultado | | **Consulta** | Número alvo · Consultar · Cancelar votação | **Variáveis de feedback:** `{event}`, `{user}`, `{target}`, `{command}`, `{count}`, `{threshold}`, `{remaining}`, `{minutes}`, `{windowSeconds}`, `{groupName}`. **Eventos típicos:** abertura, voto, voto duplicado, rejeições (sem alvo, alvo não é membro, alvo é o bot, auto-voto, alvo admin). **Resultado `{action}`:** removido / banido / removido+ban / falhou. Quando dispara: mensagem de grupo cujo texto **começa** com o comando configurado. \[\[FOTO]] *** ### Quando a automação roda (resumo) | Evento | Recursos | | ------------------------------- | ---------------------------------- | | Participante **entra** | Saudação · Ban List (auto-remoção) | | Participante **sai/é removido** | Despedida | | Mensagem no grupo | Word List · Ban por Votação | Drivers: Baileys (eventos nativos), WhatsMeow e DigiAPI (webhooks/adapters). Config precisa estar **ativa** para o trio conexão + grupo. \[\[FOTO]] *** ### Baileys vs WhatsMeow vs DigiAPI | Capacidade | Observação | | ---------------------------------------- | ----------------------------------------------- | | Listar / editar / participantes | Os três | | Saudação / despedida / ban / word / voto | Os três (via gateway) | | “Membros podem adicionar” | WhatsMeow pode **não** aplicar | | Sessão | Meow depende de token/URL; DigiAPI da instância | \[\[FOTO]] *** ### Erros comuns | Sintoma | Causa provável | | ---------------------------------- | ------------------------------ | | Menu não aparece | Sem PLUS ou não é admin | | Lista vazia / falha | Conexão errada ou desconectada | | Ban/word/voto não remove | Bot **não é admin** | | Lote não exclui | Status **Processando** | | Regex inválida | Palavra tipo Regex malformada | | Automação parou após sair do grupo | Config ficou **inativa** | | Notify sem texto | Template vazio = silencioso | \[\[FOTO]] *** ### Dicas 1. Conexão **CONNECTED** → recarregar grupos. 2. Sempre **Simular** lotes grandes antes de confirmar. 3. Torne o bot **admin** antes de ligar Ban / Word remove / Vote ban. 4. Padronize templates com as variáveis documentadas. 5. WhatsMeow: não dependa do toggle “membros podem adicionar”. 6. Exportar “todos os grupos” pode demorar (fila + delay). 7. Vote ban: quorum ≥ 2 e janela ≥ 30s; proteja admins.