Pular para o conteúdo principal

Grupos WhatsApp

Os grupos do WhatsApp ficam separados das conversas diretas no Adonix — em uma aba própria no inbox. Esse desenho evita que dezenas de grupos encham a tela do agente que só atende clientes individuais, e dá controle granular sobre quais grupos cada agente pode ver e atender.

Disponibilidade Grupos só funcionam em canais WhatsApp WAHA (sessão própria via QR Code). O WhatsApp Cloud API (Meta) não suporta grupos.

Visão geral​

O fluxo completo de grupos passa por três camadas:

  1. No canal — habilitar grupos e escolher quais grupos materializar.
  2. Por agente — controlar quais grupos cada um vê.
  3. Na conversa — gerenciar nome, foto, participantes e admins.

Ativar grupos no canal​

Lista de canais

Por padrão, novos canais WhatsApp WAHA não mostram grupos — apenas conversas diretas. Para ativar:

  1. Vá em Canais na barra lateral.
  2. Clique no canal WhatsApp WAHA que você quer ativar grupos.
  3. Na aba Configurações, encontre a chave Mostrar grupos.
  4. Ative — o sistema agora aceita mensagens de grupos nesse canal.

Por que esse toggle existe? Toda sessão WhatsApp já tem grupos antigos (família, faculdade, etc.). Se ativasse grupos automaticamente, o inbox encheria de conversas que não são de atendimento. O toggle deixa o admin escolher quando ativar e o seguinte passo deixa escolher quais grupos.

Escolher quais grupos atender​

Depois de ativar, você decide quais grupos viram conversas no Adonix. Sem essa escolha, só novos grupos (criados depois do toggle ativado) aparecem.

  1. Na mesma página do canal, com Mostrar grupos ativado, aparece o botão Escolher grupos….
  2. Clique — o sistema busca todos os grupos da sessão WhatsApp.
  3. A lista mostra cada grupo com nome, foto e número de participantes.
  4. Marque os grupos que você quer atender no Adonix.
  5. Clique em Importar selecionados.

A partir desse momento, esses grupos passam a aparecer no inbox e mensagens neles disparam atendimento.

Não importe grupos antigos massivamente Cada grupo importado vira uma conversa que conta nas suas métricas. Se você importar 200 grupos antigos, o inbox vira ruído. Importe só grupos que você efetivamente atende como empresa.

Sincronização automática​

A cada 10 minutos, o sistema atualiza nome e foto dos grupos já importados. Mensagens novas dos grupos importados chegam em tempo real (não dependem desse cron).

Grupos novos criados depois do toggle ativado entram automaticamente no inbox sem precisar reabrir o "Escolher grupos…".

Switcher Conversas | Grupos no inbox​

Quando há pelo menos um canal com showGroups=true, o inbox ganha um switcher no topo da sidebar:

  • Conversas — mostra só conversas diretas (1-pra-1).
  • Grupos — mostra só grupos.

Os contadores ficam separados: cada modo tem seu próprio "Abertas / Em atendimento / Resolvidas".

Badge de não lidas Cada modo tem badge próprio de mensagens não lidas (verde quando estão atribuídas a você, vermelho para abertas em geral). Se você está no modo Conversas e chega mensagem em grupo, vê um número no botão Grupos avisando.

Controle de acesso por agente​

Por padrão, todos os agentes do workspace podem ver e atender qualquer grupo importado. Para restringir:

  1. Abra a conversa do grupo no inbox.
  2. No header, clique no menu de ações (3 pontinhos) → Acesso ao grupo.
  3. No diálogo, escolha:
    • Todos os agentes do workspace (padrão).
    • Apenas agentes selecionados — marque quem pode ver. Quem não estiver na lista, não enxerga o grupo no inbox (nem em busca, nem em counts).
  4. Clique em Salvar.

Quem pode mexer no acesso Apenas admin ou superadmin veem essa opção. Agente comum não consegue alterar.

Gerenciar o grupo dentro da conversa​

Quando você abre uma conversa de grupo, o cabeçalho mostra:

  • Foto e nome do grupo (sincronizados a cada 10 min).
  • Número de participantes.
  • Se você é admin do grupo no WhatsApp, aparecem ações de gerenciamento.

Renomear o grupo​

  1. Clique no nome do grupo no header.
  2. No painel lateral que abre, clique no ícone de lápis ao lado do nome.
  3. Edite e salve.

O nome muda no WhatsApp também Renomear pelo Adonix muda o nome do grupo para todos os participantes no WhatsApp. Não é só uma label interna.

Adicionar participantes​

  1. Painel lateral → Adicionar participante.
  2. Digite o telefone (com DDD e código do país) ou escolha de um contato existente.
  3. Confirme.

A pessoa recebe convite no WhatsApp. Se ela bloqueou seu número ou tem privacidade configurada, pode falhar — o sistema avisa.

Remover participantes​

  1. Painel lateral → lista de participantes.
  2. Clique no nome → Remover do grupo.
  3. Confirme.

A pessoa é removida no WhatsApp. Ela continua tendo as mensagens antigas, mas não recebe novas.

Promover / Despromover admin​

  1. Lista de participantes → clique no nome.
  2. Promover a admin (se não é) ou Remover admin (se é).

Você precisa ser admin do grupo no WhatsApp pra fazer isso.

Sair do grupo​

  1. Painel lateral → menu (3 pontinhos) → Sair do grupo.
  2. O sistema remove o número do canal de dentro do grupo no WhatsApp.
  3. A conversa do grupo fica em "leitura" no Adonix — você vê o histórico mas não recebe mensagens novas até alguém te adicionar de volta.

Quem pode editar nome e foto​

  • Adonix bloqueia edição do nome do grupo direto na plataforma para agente comum — só admin/superadmin com permissão de gerenciar canais consegue.
  • A foto sincroniza automaticamente do WhatsApp; não dá pra trocar pela plataforma (limitação do WhatsApp protocol).

Mensagens em grupo​

Algumas diferenças vs. conversa direta:

  • Nome do remetente aparece no card de cada mensagem (vários remetentes diferentes no mesmo chat).
  • Reply (responder mensagem específica) funciona normalmente.
  • Reactions funcionam.
  • Forward funciona.
  • Mensagem privada para um participante — não tem suporte direto pelo Adonix; abra a conversa direta com aquele número.

Sincronização histórica​

Quando você importa um grupo, o Adonix tenta puxar o histórico recente (últimas mensagens) automaticamente. Não chega a 100% sempre — depende do que está no cache do WhatsApp.

Para forçar atualização de nomes:

  1. Configurações → Sincronização → Atualizar nomes da agenda.
  2. Os contatos com nameLocked=false (não renomeados manualmente) recebem o nome da agenda do dispositivo. Útil quando o sync inicial trouxe nomes em formato +5511...@lid em vez do nome da pessoa.

Limitações conhecidas​

  • Não dá pra criar grupo novo pelo Adonix — só importar existentes.
  • Status do WhatsApp (story) não vira atendimento, mesmo em grupos.
  • Grupos arquivados no WhatsApp podem aparecer com nomes em LID até o WAHA resolver.
  • Mensagens efêmeras somem do Adonix junto com o WhatsApp (no tempo configurado).

Próximos passos​