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

Selecione a Conexão WhatsApp (driver + status).
Opcional: Recarregar grupos.
Sem conexão: aviso para selecionar.
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

Preencher o formulário
Pré-visualizar (contagens / estimativa)
Simular (dry-run — não chama o WhatsApp de fato)
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

Conexão CONNECTED → recarregar grupos.
Sempre Simular lotes grandes antes de confirmar.
Torne o bot admin antes de ligar Ban / Word remove / Vote ban.
Padronize templates com as variáveis documentadas.
WhatsMeow: não dependa do toggle “membros podem adicionar”.
Exportar “todos os grupos” pode demorar (fila + delay).
Vote ban: quorum ≥ 2 e janela ≥ 30s; proteja admins.

AnteriorAuditoria

PróximoCadastro de Templates