Monitoramento de grupos WhatsApp
Neste guia, você vai entender como o Oráculo monitora seus grupos de WhatsApp e para que isso serve.
Para que serve?
Em lançamentos digitais, é muito comum usar grupos de WhatsApp para reunir os leads antes do evento. Saber quem entrou e quem saiu do grupo é uma informação valiosa para:
- Medir comparecimento — Quantos leads realmente entraram no grupo?
- Identificar desistências — Quem saiu antes do evento começar?
- Cruzar com vendas — Dos que entraram no grupo, quantos compraram?
- Calcular taxa de entrada — Que percentual dos leads entrou no grupo?
Como funciona?
O monitoramento acontece de duas formas:
1. Em tempo real (webhook)
Quando alguém entra ou sai de um grupo monitorado, o Z-API avisa o Oráculo automaticamente. Isso inclui:
- Entrada — Quando alguém é aprovado ou adicionado ao grupo
- Saída — Quando alguém sai por conta própria ou é removido
O Oráculo recebe essa notificação, identifica o telefone da pessoa e registra a movimentação.
2. Sincronização completa (sync)
Além do monitoramento em tempo real, o Oráculo pode fazer uma sincronização completa de todos os membros do grupo. Isso é útil quando:
- Você configurou o monitoramento depois que o grupo já tinha membros
- Quer garantir que os dados estão atualizados
A sincronização busca a lista completa de participantes no WhatsApp e compara com o que está no banco de dados. Quem está no grupo mas não no banco é adicionado. Quem está no banco mas não no grupo é marcado como “saiu”.
O que é sincronizado?
Para cada membro do grupo, o Oráculo registra:
| Dado | Descrição |
|---|---|
| Telefone | Número do membro (normalizado para 11 dígitos) |
| Status | ”Ativo” (está no grupo) ou “Saiu” (não está mais) |
| Data de entrada | Quando entrou no grupo |
| Data de saída | Quando saiu (se aplicável) |
| Lead vinculado | Se esse telefone corresponde a um lead cadastrado, o sistema faz a ligação automaticamente |
Como ver os membros
Os dados de grupo aparecem na página do evento, na seção de métricas. Você pode ver:
- Total de membros ativos — Quantos estão no grupo agora
- Total que saiu — Quantos saíram
- Entradas recentes — Quantos entraram ontem
- Taxa de entrada — Percentual de leads que entraram no grupo
Screenshot: [Seção de métricas do evento mostrando dados do grupo WhatsApp: membros ativos, saídas, entradas recentes e taxa de entrada]
Configurando o monitoramento
Para monitorar um grupo, você precisa:
1. Ter uma instância Z-API de monitoramento
Acesse Configuração > Configurações > aba WhatsApp e crie uma instância com finalidade Monitoramento. Veja o guia “Configurando o Z-API” para detalhes.
2. Vincular o grupo ao evento
O grupo precisa estar associado a um evento no Oráculo. Quando o Z-API envia um evento de entrada ou saída, o sistema verifica se aquele grupo está cadastrado e vinculado a algum evento.
3. Configurar o webhook no Z-API
A URL de webhook precisa estar configurada no painel do Z-API. Sem isso, o Z-API não envia as notificações para o Oráculo.
Como o Oráculo vincula membros a leads?
Quando alguém entra no grupo, o sistema recebe o número de telefone dessa pessoa. Ele então:
- Normaliza o telefone (remove caracteres especiais, ajusta formato)
- Busca no banco de dados um lead com o mesmo telefone e do mesmo expert
- Se encontrar, vincula o membro do grupo ao lead
Isso permite cruzar os dados: você sabe que o lead “João” (que se cadastrou na LP) também entrou no grupo de WhatsApp.
Dica: Para que o vínculo funcione, o lead precisa ter se cadastrado com o mesmo número de telefone que ele usa no WhatsApp.
Perguntas frequentes
O monitoramento funciona em grupos que eu não sou admin?
O Z-API precisa estar presente no grupo (ou seja, o número conectado à instância de monitoramento precisa estar no grupo). Além disso, o grupo precisa estar cadastrado no sistema.
Posso monitorar mais de um grupo por evento?
Sim. Você pode ter vários grupos vinculados ao mesmo evento. O Oráculo rastreia todos eles.
O que acontece se o membro sair e entrar de novo?
O sistema atualiza o status. Se a pessoa saiu e voltou, o registro é atualizado para “ativo” novamente, com a nova data de entrada.
O monitoramento atrasa?
O webhook é praticamente em tempo real (segundos). Pode haver um pequeno atraso dependendo do Z-API, mas geralmente é instantâneo.
Isso pode causar bloqueio no meu WhatsApp?
O monitoramento apenas escuta eventos — não envia mensagens. O risco de bloqueio é muito baixo. Mesmo assim, recomendamos usar um chip dedicado para monitoramento, separado do chip de disparo.