Agileads — Manual do usuário

Como operar o Agileads no dia a dia: do primeiro acesso ao envio de conversões para a Meta.

Este manual cobre o uso do aplicativo.

1. Primeiros passos

O Agileads conecta o WhatsApp do seu negócio (ou dos seus clientes, se você é agência), registra todas as conversas, usa IA para inferir em que estágio do funil cada lead está e se a conversa virou venda, e devolve as conversões confirmadas para a Meta (e para o Google Ads) — para que as campanhas otimizem por venda real, e não por "conversa iniciada".

Do pagamento ao painel

1. Compra — você escolhe o plano na página de preços e paga pelo checkout. No checkout há um campo "Nome da empresa ou agência": o que você digitar aí vira o nome da sua conta no Agileads.
2. Página de boas-vindas — depois do pagamento você cai em /bem-vindo, que lista os próximos passos. Sua conta já foi criada nesse momento.
3. E-mail de convite — chega no e-mail usado na compra, com um link para definir a senha.
4. Definir senha — o link abre /definir-senha. A senha precisa ter no mínimo 8 caracteres. Ao salvar, você entra no painel.
5. Configuração inicial — no Dashboard, enquanto não houver nenhum cliente cadastrado, aparece o botão "Complete a configuração (~3 min)". Ele abre um assistente de 4 passos (ver seção 3).

Login

Entrar em /login com e-mail e senha. Não há cadastro por essa tela: a conta nasce na compra do plano ou no convite de um admin da sua conta. Se depois de entrar aparecer Sem acesso, seu login não está ligado a nenhuma conta: peça um novo convite ao admin.

2. Perfis de acesso

Existem dois papéis dentro de uma conta:

O agente vê métricas, análises e conversões somente dos clientes marcados para ele em Equipe → Alocar clientes. Isso vale em todas as telas.

O menu reflete o papel. À esquerda, o que um admin enxerga; à direita, o mesmo menu para um agente — sem Segmentos, Equipe e Assinatura.

Admin	Agente

Barra do topo

• Busca — digite nome ou telefone e o app abre a lista de Leads já filtrada.
• Conta ativa — quem participa de mais de uma conta troca pelo seletor ao lado do avatar.
• Alterar senha — no menu que abre ao clicar no seu e-mail, no canto direito. Também é onde fica Sair.

3. Clientes

Um cliente é a conta cujo WhatsApp será rastreado. Se você contratou um plano Empresas, o "cliente" é o seu próprio negócio (o app usa o termo "Negócio" nesse caso). Se é agência, cada cliente atendido é um registro.

Assistente de configuração (/setup)

Atalho para colocar o primeiro cliente no ar. Aparece como botão no Dashboard enquanto não houver clientes, e tem 4 passos:

1. Negócio / Cliente — nome.
2. Segmento — escolha o ramo (define os estágios do funil e o que conta como conversão). Dá para pular com "Continuar sem segmento".
3. WhatsApp — o assistente já cria o canal e mostra o QR Code na própria tela, além de um link que pode ser copiado e enviado para quem tem o celular em mãos.
4. Meta Ads (opcional) — Dataset ID, token e Page ID. Pode ser feito depois.

Ao final, uma tela de checklist mostra o que ficou pendente e para onde ir.

Página de Clientes (/clients)

Mostra, por cliente: segmento, situação do WhatsApp (Conectado / Desconectado / Sem canal), se a Meta CAPI e o Google Ads estão configurados, quantidade de leads e status (Ativo / Arquivado).

O que dá para fazer:

• Novo cliente (admin) — botão no topo, só o nome é obrigatório. Quando a conta chega ao limite de clientes do plano, o botão fica desabilitado e a tela explica o que fazer (arquivar um cliente ou trocar de plano). No plano Master o botão continua liberado: cliente acima do limite vira excedente na fatura (seção 12).
• Trocar o segmento (admin) — pelo seletor na própria linha.
• Configurar Meta CAPI / Google Ads — botões na linha do cliente (ver seção 7).
• Horário de atendimento — ícone de relógio na linha do cliente. Marque os dias em que a operação atende e a faixa de horas de cada um; dia desmarcado é dia fechado. O padrão é segunda a sexta, 08:00 às 18:00. É o que separa "contato fora do expediente" de "demora para responder" no relatório de Atendimento (seção 10) — sem isso, o varejo que abre sábado e a clínica que atende à noite aparecem com números errados.
• Arquivar — desconecta o WhatsApp e pausa as análises; o histórico é preservado. Use quando o cliente sai.
• Reativar — volta o cliente para ativo. Atenção: o WhatsApp não reconecta sozinho — é preciso gerar um novo link de pareamento.
• Excluir (admin) — apaga o cliente e todos os leads, conversas, mensagens e análises. É irreversível: o app pede que você digite o nome exato do cliente para confirmar.

As ações de cada linha (Arquivar / Reativar / Excluir) ficam à direita da tabela — role a tabela na horizontal para alcançá-las.

Segmentos (/segments, admin)

O segmento define, para a IA e para a Meta:

• os estágios do funil daquele ramo (ex.: Saudação → Descoberta → Apresentação → Negociação → Fechamento);
• a definição de conversão em texto livre — é o que a IA lê para decidir se a conversa converteu ("o cliente confirmou a compra e combinou o pagamento", "o paciente agendou a consulta"…);
• o evento enviado à Meta (Purchase ou LeadSubmitted);
• se a conversão tem valor monetário;
• qual etapa (ou quais etapas) é a etapa de conversão: marque a caixa "Etapa de conversão" no estágio correspondente. O relatório de atendimento destaca essa etapa e usa o nome dela para explicar ao cliente o que conta como conversão;
• qual é a etapa de qualificação: a caixa "Etapa de qualificação" (uma por segmento). O relatório conta como lead qualificado quem chegou a essa etapa ou passou dela;
• quais etapas ficam fora do funil: a caixa "Fora do funil", para as etapas de saída, como "Abandonado", "Perda" ou "Não qualificado". Elas não contam como avanço e uma etapa fora do funil não pode ser de conversão nem de qualificação.

Nenhuma dessas três marcações muda a análise da IA. Os segmentos que já existiam vieram com "Fora do funil" marcado nas etapas de saída mais comuns (Abandonado, Desconhecido, Perda, Não qualificado, Não compareceu, Sem resposta); confira e ajuste se preciso.

Toda agência nova já nasce com três segmentos prontos (vestuário, clínica, automotivo). Você pode editá-los, criar outros e reordenar os estágios.

Frases-chave por estágio. Embaixo de cada estágio há um campo "Frases-chave (uma por linha)". Quando uma mensagem da conversa — enviada ou recebida — contiver uma dessas frases, o lead passa para aquele estágio na hora, sem depender da IA. Serve para combinar com a equipe uma frase padrão em momentos decisivos ("agendamento confirmado", "pedido fechado"): fica preciso e auditável. Maiúsculas e acentos não importam e cada estágio aceita várias frases.

A frase-chave só avança o lead: uma frase de etapa anterior não puxa o lead de volta, e frase em etapa fora do funil não move ninguém. Depois dela a IA continua reconhecendo pelo contexto os avanços seguintes, mesmo sem nenhuma frase, mas nunca leva o lead para trás da etapa que a frase marcou. A correção manual feita na página do lead sempre prevalece sobre as duas.

Cuidado: excluir um segmento (ícone de lixeira na tabela de performance) não pede confirmação.

4. Canais de WhatsApp

Um canal é um número de WhatsApp conectado a um cliente. Tudo em /channels.

Conectar um número

1. Adicionar canal — escolha o cliente e, se quiser, um nome de exibição.
2. Clique em Parear. O app gera um link de pareamento.
3. Abra o link (ou envie para quem está com o celular). Ele mostra o QR Code.
4. No celular: WhatsApp → Aparelhos conectados → Conectar aparelho → aponte para o QR. Quando houver, também aparece um código numérico como alternativa ao QR.
5. Quando conectar, a página confirma "Conectado com sucesso" e o status do canal vira Conectado.

O link de pareamento:

• vale 24 horas;
• é de uso único;
• gerar um novo link revoga o anterior — só um link fica ativo por canal;
• cada conta pode gerar no máximo 3 links a cada 15 minutos. É proposital: conecte um canal antes de pedir o próximo. Ao estourar, o app diz em quantos minutos libera.

Cada plano também limita quantos canais um mesmo cliente pode ter — 2 na maioria dos planos, 3 no PRO. Ao atingir o limite, a tela de Canais avisa antes de você tentar parear.

Estados possíveis do canal

Para reconectar um número que caiu há duas formas. A mais simples é o link de reconexão: cada canal tem um link fixo (botão "Copiar link de reconexão" na linha do canal) que não expira e não é de uso único — quando o canal está conectado, o link só confirma isso; quando cai, mostra o QR para escanear de novo. Deixe esse link salvo com quem tem o celular em mãos. A outra forma é gerar um novo link de pareamento de 24h, como no primeiro pareamento. Nos dois casos o histórico do cliente é mantido. Admin pode trocar o link de reconexão, o que invalida o anterior.

Meu WhatsApp desconectou

Todo dia às 8h (horário de Brasília), se algum número que vinha recebendo conversas estiver desconectado, cada pessoa da equipe recebe um único e-mail: os admins recebem todos os números parados da agência, e os demais membros recebem só os dos clientes que cuidam. Para cada número vão o cliente, o motivo, há quanto tempo e o link de reconexão, e no fim o passo a passo para escanear o QR. Quem não tem nenhum cliente com número parado não recebe nada. Antes de enviar, o Agileads confere na hora se cada conexão está mesmo fora, então reconexões rápidas de rotina não entram. O resumo se repete todo dia enquanto houver número desconectado; quando todos voltam, ele para.

Enquanto houver número parado, o Dashboard mostra uma faixa vermelha no topo com os clientes afetados e há quanto tempo, e a tela de Canais mostra o motivo na linha do canal, com o botão Ver passo a passo. O resumo e a tela dizem qual destas três situações aconteceu em cada número:

Para escanear o QR: abra o link de reconexão no computador; no celular do cliente, abra o WhatsApp; no Android toque em ⋮ (canto superior direito) → Aparelhos conectados → Conectar aparelho, no iPhone vá em Configurações → Aparelhos conectados → Conectar aparelho; aponte a câmera para o QR. A página do link mostra esses mesmos passos ao lado do QR, então dá para mandar o link direto para o cliente.

Enquanto o número estiver desconectado, as conversas dele não entram no relatório e as vendas não são enviadas para a Meta. O histórico de antes da queda continua lá.

Apagar canal (admin) desconecta o WhatsApp e remove a conexão — as conversas já coletadas continuam no histórico do cliente.

O Agileads apenas observa as conversas. Ele não envia mensagens, não marca como lida e não altera nada na operação de quem atende.

5. Leads e conversas

Cada pessoa que manda mensagem para o número conectado vira um lead (identificado pelo telefone). Não há cadastro manual: leads aparecem sozinhos a partir das mensagens.

Lista de leads (/leads)

Filtros: busca por nome/telefone, cliente, origem, estágio, tipo (todos / só leads / só não-leads) e período. Os quatro indicadores do topo (Leads, Conversões confirmadas, Tráfego pago, Origem desconhecida) respondem ao cliente e ao período — não aos demais filtros.

Os indicadores contam como o relatório de atendimento: não-leads ficam fora (o card de Leads mostra quantos foram deixados de fora) e conversão confirmada é lead que entrou no período e teve conversão confirmada no período, pela IA ou por alguém da equipe. Para o mesmo cliente e período, Leads, Funil, Dashboard e Atendimento mostram os mesmos números. A tabela, com o tipo em "Todos", lista também os não-leads.

Origem é como o lead chegou:

Se um lead antigo, sem origem, clicar depois num anúncio, o Agileads promove a origem dele para "pago". Mas se ele já tinha uma origem paga, a primeira permanece (primeiro toque).

Nome da campanha. Lead que veio de anúncio da Meta chega só com o número do anúncio. O Agileads consulta a Meta com um token de leitura de anúncios e grava o nome da campanha, do conjunto e do anúncio; a partir daí a coluna Origem mostra a campanha e a página do lead traz os três nomes. O lugar certo para esse token é Integrações → Meta Ads (seção 13): um token do seu Business Manager, com a permissão ads_read e as contas de anúncios dos clientes como ativos, cobre todos os clientes da agência. Cliente cuja conta de anúncios está fora do seu Business Manager recebe um token próprio no bloco 2 da janela Meta, em Clientes (o token de CAPI, do bloco 1, só envia conversões e não enxerga a conta de anúncios). Ao salvar o token, o Agileads consulta a Meta na hora e mostra o resultado: quantos anúncios ganharam nome ou o motivo da recusa. Anúncios novos ganham nome de hora em hora. Enquanto não houver token nem na agência nem no cliente, a coluna Meta da tela de Clientes mostra "Nomes de campanha: falta o token de anúncios"; se o token da agência não enxergar a conta daquele cliente, mostra "token da agência não enxerga esta conta" — clique para abrir a janela no lugar certo.

Exportar CSV. O botão no topo da lista baixa todos os leads dos filtros atuais (até 5.000), com telefone, origem, plataforma, campanha, conjunto e anúncio (nomes e ids), estágio, conversão e valor. Abre direto no Excel em português.

Detalhe do lead (/leads/:id)

• Linha do tempo da jornada: captura, primeira mensagem, análise da IA, conversão registrada.
• Análise do Claude IA: estágio, desfecho, confiança, qualidade do atendimento (nota de 0 a 100), valor provável e o raciocínio da IA em texto. O valor provável só aparece quando o segmento trabalha com valor e alguém disse um número na conversa — a IA não estima.
• Transcrição da conversa completa, incluindo a transcrição dos áudios (quando o plano cobre; o texto do áudio aparece em até cerca de 40 minutos).
• Informações do lead: telefone, campanha, anúncio, origem, se há gclid capturado.
• Status Meta CAPI: o que foi enviado para a plataforma e em que situação está.
• Botão "Abrir no WhatsApp", que leva para a conversa real.

Ações disponíveis:

• Corrigir análise — ajusta estágio, desfecho e valor. ⚠️ Corrigir para "Convertido" gera a conversão automaticamente (e ela vai para a fila de envio à Meta).
• Marcar como "não é lead" — com motivo (spam, fornecedor, engano, cliente existente, interno, outro). O lead sai das métricas, deixa de ser analisado pela IA e eventuais conversões pendentes dele são canceladas. É reversível ("É um lead").

"Não é lead" é diferente de "lead desqualificado". Use apenas para contatos que nunca foram prospectos.

6. Análises de IA e revisões

Quando as análises rodam

Não é em tempo real. A análise é agendada:

• todo dia de manhã, para conversas que tiveram movimento nas últimas 24 horas;
• uma varredura semanal completa (segunda-feira).

Cada análise lê as últimas 40 mensagens da conversa e devolve: estágio do funil, desfecho (converteu / provavelmente converteu / não converteu / indefinido), confiança, nota de atendimento, valor provável e se aquilo é ou não um lead.

Não são reanalisadas: conversas já marcadas como convertidas, leads marcados como "não é lead", clientes arquivados e conversas sem mensagem nova desde a última análise.

Quota mensal

Cada plano tem uma quota de análises por mês (ver seção 12). Ao estourar a quota, novas conversas param de ser enfileiradas até o mês virar — as conversas continuam sendo registradas normalmente, só a análise pausa.

Áudios

Áudios são transcritos automaticamente nos planos que incluem transcrição (Agência, PRO, Growth e Master), em até cerca de 40 minutos depois de chegarem, sem esperar a análise do dia. Áudio de contato marcado como "não é lead" não é transcrito. Nos planos sem transcrição, o conteúdo do áudio simplesmente não entra na análise.

Fila de revisão (/reviews)

A IA confirma sozinha as análises em que a confiança é alta o bastante: desfecho "Convertido" ou "Provável" com confiança acima do patamar de segurança do sistema. Essas viram conversão direto.

O que fica abaixo desse patamar cai na fila de revisão — é onde entra o humano. (Análises "não converteu" e "indefinido" não entram na fila: não há o que confirmar.)

Para cada card da fila você pode:

Filtros: cliente, período e "Ocultar não-leads".

7. Conversões e Meta CAPI

O que dispara uma conversão

Uma conversão nasce de três formas:

1. IA com alta confiança — automática;
2. Confirmação na fila de revisão;
3. Correção manual da análise na página do lead, marcando "Convertido".

Assim que a conversão é confirmada, ela entra numa fila de envio e é despachada para a Meta CAPI (e, se o lead tiver gclid e o cliente tiver Google Ads configurado, também para o Google Ads).

Acompanhar os envios (/conversions)

A página tem três abas:

• Enviáveis (padrão) — conversões de leads que vieram de um clique rastreado (CTWA ou link rastreado). São as únicas que têm o que enviar.
• Não enviáveis — conversões reais, mas sem clique para atribuir. Não há como enviá-las: sem o identificador do clique, a Meta não tem a que atribuir. Aparecem no log como Ignorado, e isso é o comportamento correto — não é erro.
• Todas.

Cada linha traz um selo dizendo de onde veio o clique:

Indicadores: conversões confirmadas da aba aberta (o nome do card muda com a aba: na padrão é Confirmadas enviáveis), taxa de match CAPI (enviadas ÷ tentativas), eventos pendentes de decisão e a evolução dos últimos 7 dias.

Esta tela é o registro dos envios e conta cada conversão pela data em que ela aconteceu. O relatório de atendimento e as telas de Leads, Funil e Dashboard contam os leads que entraram no período. Por isso, mesmo na aba Todas, o número pode diferir um pouco: uma conversão de hoje de um lead que chegou no mês passado aparece aqui, mas não no relatório deste período.

No log de despacho você vê, por conversão: lead, cliente, se a origem foi IA ou humano, valor, o resultado do envio (Sucesso / Pendente / Falha / Ignorado) e a mensagem de erro quando falha. Envios com falha podem ser reenviados pelo botão na linha. Conversões ainda candidatas podem ser confirmadas ou rejeitadas aqui também.

Uma conversão é marcada como Ignorado quando: o lead não tem clique de anúncio, o lead foi marcado como "não é lead", ou a conversão é mais antiga que 7 dias (a Meta não aceita eventos fora dessa janela).

Configurar a Meta CAPI de um cliente

A configuração fica em Clientes → botão "Configurar" na coluna Meta CAPI (também disponível no passo 4 do assistente). São três dados da conta de anúncios do cliente — Page ID, Dataset ID e o número de WhatsApp — mais um token de acesso gerado no Events Manager. O token é gravado cifrado e nunca é exibido de volta: ao editar, o campo abre vazio e é preciso colar de novo.

Escolher o dataset certo é a parte que engana — não é o pixel do site, e um dataset errado faz a Meta recusar todas as conversões em silêncio. A ativação de cada cliente é acompanhada pela equipe Agileads: fale com a gente em contato@agileads.com.br que configuramos junto com você e validamos o primeiro evento ponta a ponta.

Configurar o Google Ads de um cliente

Em Clientes → botão na coluna Google Ads. É preciso informar:

• Customer ID da conta que roda os anúncios;
• Conversion Action ID — de uma ação de conversão do tipo importação, criada no Google Ads;
• MCC (opcional, se a conta é gerenciada por uma central);
• Moeda (padrão BRL).

Depois, clique em "Conectar com Google": abre a janela de consentimento do Google. Autorize com a conta que tem acesso ao Google Ads do cliente. A autorização fica guardada cifrada — você não precisa lidar com tokens.

Conversões só vão para o Google quando o lead tem gclid, o que só acontece se ele veio por um link rastreado (próxima seção).

8. Links rastreados

O Google Ads (e TikTok, LinkedIn, bio do Instagram, QR code…) não têm o equivalente do CTWA: o clique não carrega os dados do anúncio até o WhatsApp. O link rastreado resolve isso.

Como funciona

1. Você cria um link em /tracking-links e recebe uma URL curta: www.agileads.com.br/l/<slug>.
2. Coloque essa URL onde estaria o link do WhatsApp: na URL final do anúncio, no botão de WhatsApp do site, na bio, no QR code ou no e-mail.
3. Quem clica é redirecionado para o WhatsApp do cliente com a mensagem pré-preenchida que você definiu. No fim da mensagem vai um código de rastreio (#ag:c:…). O código fica visível: se a pessoa apagar antes de enviar, o lead entra sem origem.
4. Quando a mensagem chega, o Agileads casa o clique com o lead e grava plataforma, campanha, anúncio e o gclid.

Origem e campanha

• A plataforma é a escolhida no link. Com uma plataforma fixa (Google Ads, Meta, TikTok…), todo lead que passa pelo link recebe essa origem, venha de onde vier.
• Com a plataforma Automático, a origem sai de cada clique: gclid é Google; fbclid é Meta; sem eles, vale o utm_source (e o utm_medium diz se é anúncio, como cpc ou paid); sem nada disso, o lead entra como orgânico. Use Automático quando o mesmo link estiver num site que recebe tráfego de várias origens.
• A campanha é a preenchida no link. Com o campo vazio, o Agileads usa o utm_campaign que chegar na URL do clique. No Google Ads, o sufixo de URL final utm_campaign={campaignid} faz isso sozinho: cada clique leva o ID da campanha, e um link só atende todas as campanhas do cliente.
• O nome e o custo das campanhas do Google não são lidos da conta do Google Ads.

Google Ads: anúncio direto ou pelo site

• Anúncio direto para o WhatsApp: use o link como URL final do anúncio. Com a codificação automática ligada na conta do Google Ads, o Google acrescenta o gclid ao link sozinho. O Google pode reprovar anúncio cuja URL final redireciona para outro domínio; se acontecer, use o caminho pelo site.
• Anúncio para o site: o anúncio continua levando para o site, e o botão de WhatsApp do site aponta para o link. O Google coloca o gclid (e as UTMs) na URL do site, não na do link, então o site precisa repassar esses parâmetros para o link do botão. Sem esse repasse, o lead entra com a origem do link, mas sem gclid, e a conversão não volta para o Google. O código que faz o repasse fica em Links rastreados → Seu anúncio leva para um site?: clique em Copiar código e cole no site, antes do </body> ou numa tag de HTML personalizado do Google Tag Manager. Para conferir, abra o site com ?gclid=teste no fim do endereço e passe o mouse no botão de WhatsApp: o endereço do botão deve terminar com gclid=teste.

Criar um link

Campos: cliente, plataforma (Google Ads, Meta orgânico/bio, TikTok, LinkedIn, Outro), slug (aparece na URL), WhatsApp de destino, mensagem pré-preenchida e, opcionalmente, campanha e anúncio.

Depois é só Copiar URL. Links podem ser desativados (o redirecionamento para de funcionar) e reativados.

Métricas

A página mostra, por link: cliques, leads atribuídos e a taxa clique → lead. Essa taxa nunca é 100%: parte de quem clica não chega a mandar a mensagem.

9. Dashboard, funil e métricas

Dashboard (/)

Filtros de cliente e período valem para os indicadores, o gráfico e a lista de leads recentes.

O gráfico "Fluxo de Conversões" compara leads e conversões (7 ou 30 dias). Nele cada conversão aparece no dia em que foi confirmada, então a soma do gráfico pode diferir um pouco do indicador, que conta só leads que entraram no período.

Funil (/funnel)

Mostra quantos leads alcançaram cada estágio — a barra é cumulativa — e a taxa de passagem entre eles ("X% passam · queda Y%").

Indicadores do topo: Leads no recorte (sem os não-leads), No funil (leads com estágio classificado), Conversões confirmadas e Taxa de conversão (conversões confirmadas ÷ leads), com a mesma conta da tela de Leads e do relatório de atendimento. O estágio mostra em que ponto a conversa parou; quem chegou ao último estágio não necessariamente comprou, então para resultado use as conversões confirmadas.

⚠️ Cada segmento tem estágios próprios. Se você atende ramos diferentes, selecione um segmento no filtro para ver o funil exato dele. Sem segmento selecionado, o funil usa uma escala genérica.

Abaixo do funil, "Fora do funil": abandonados, sem classificação e outros.

10. Relatório de atendimento

Tela /attendance, no menu Atendimento. Mostra, por cliente e período, quantos leads chegaram, quantos converteram, quanto a equipe demora para responder e o que ficou parado. Tem duas versões com os mesmos números e os mesmos nomes: esta, completa, para a equipe da agência, e o portal do cliente, enxuto, para o dono do negócio (ver o fim desta seção).

No topo escolha o cliente e o período (padrão: últimos 30 dias). Ao lado ficam Portal do cliente, Exportar PDF (impressão do navegador: escolha "Salvar como PDF"; o PDF sai com todas as seções) e, quando disponível, o vídeo Como ler os resultados.

Comparar períodos

A opção Comparar com…, ligada por padrão, compara o período escolhido com o período imediatamente anterior, de mesma duração. Exemplo: 1 a 15 de setembro é comparado com 17 a 31 de agosto. Cada indicador mostra o valor anterior e a variação:

• leads, conversões e tempo de resposta variam em porcentagem;
• a taxa de conversão varia em pontos percentuais (de 25% para 30% é +5 p.p.);
• no tempo de resposta, cair é melhorar: a etiqueta fica verde quando o tempo diminui.

Diferenças muito pequenas aparecem como estáveis.

Abas

As abas são recortes da mesma tela:

• Diagnóstico mostra tudo;
• Conversas mostra as prioridades de revisão, a lista de conversas e a revisão de conversões;
• Origens mostra de onde vieram os leads;
• Metodologia reúne definições, critérios e o volume por horário.

A aba escolhida fica no endereço da página, então dá para enviar o link já na aba certa.

WhatsApp desconectado

Enquanto o WhatsApp do cliente estiver desconectado, uma barra vermelha aparece no topo, com dia e hora da queda. Ela some quando o canal volta. Isso é o estado de agora. Se o canal caiu durante o período analisado, aparece um aviso amarelo à parte, com quanto tempo ele ficou fora.

Com o canal fora, a equipe continua atendendo pelo celular; o Agileads é que não enxerga. Por isso as conversas desse intervalo ficam como Canal fora do ar, e nunca como "sem resposta".

Indicadores

• Novos leads: leads que entraram no período. Contatos marcados como "não é lead" ficam de fora.
• Leads qualificados: leads do período que chegaram à etapa de qualificação do segmento, ou passaram dela. Se o segmento não tem etapa de qualificação marcada, o card avisa.
• Conversões confirmadas: leads do período com conversão confirmada. Embaixo aparece qual etapa conta como conversão para este cliente (definida no segmento).
• Taxa de conversão: conversões confirmadas ÷ leads.
• Tempo típico da primeira resposta humana: metade dos leads foi atendida por uma pessoa em até esse tempo. Resposta automática não conta.

O card mostra o tempo típico, e não a média, de propósito: poucos leads que chegam de madrugada ou no fim de semana e só são atendidos no dia seguinte puxam a média para horas, mesmo quando a equipe responde em minutos. A média aparece em Apoio à análise, explicada.

Em poucas palavras

Logo abaixo dos indicadores, as mesmas informações em frases prontas para repassar ao cliente, por exemplo:

• 200 leads entraram no período. Subiu: de 160 para 200 (+25%) em relação a 17/08 a 31/08.
• 60 de 200 leads chegaram a "Venda confirmada" (30%).
• Metade dos leads foi atendida por uma pessoa em até 4 min; 9 em cada 10, em até 20 min.
• 10 leads ainda esperam a primeira resposta de uma pessoa.

Prioridades de revisão

Três grupos, que podem se sobrepor (não some os números):

• Sem resposta: o lead ainda não recebeu resposta de uma pessoa da equipe. Ver contatos abre a lista filtrada.
• Sem continuidade: a última mensagem é do lead e ninguém respondeu há 3 dias ou mais. Conversas que de fato terminaram (o lead agradeceu, desistiu) também podem aparecer aqui.
• Conversões prováveis: a IA sinalizou conversão, mas falta alguém confirmar. Elas não entram nas confirmadas. Validar evidências abre a fila de revisão já filtrada pelo cliente.

Tempo até a primeira resposta humana

Faixas Até 5 min · Mais de 5 até 15 min · Mais de 15 até 30 min · Acima de 30 min · Sem resposta humana, com quantidade e porcentagem. A conversa que recebeu só a mensagem automática conta como sem resposta humana. Embaixo: em quanto tempo a resposta automática chega, a mediana humana (metade respondida até ali) e o P90 humano (9 em cada 10 respondidas até ali).

Etapas do atendimento

Em que etapa cada lead do período está agora, na ordem do segmento do cliente, com quantidade e porcentagem do total. Cada lead aparece uma única vez, na etapa atual: é uma fotografia, não um funil acumulado. A passagem de uma etapa para outra está no bloco seguinte. A etapa de conversão aparece em verde.

Avanço pelo funil

Quantos leads do período chegaram a cada etapa e quantos passaram para a seguinte, com três números por linha: os leads, a porcentagem do total e o avanço (quantos da etapa anterior chegaram a esta). A etapa com o menor avanço aparece em vermelho e é citada embaixo como a maior perda. Os botões no topo filtram por origem: todas, Meta Ads, Google Ads, orgânica ou sem rastreio.

Cada lead conta em todas as etapas até a mais avançada que alcançou: a etapa atual, a maior etapa já registrada no histórico (o histórico começou em 30/10/2026; antes disso vale só a etapa atual) e, se teve conversão confirmada, a etapa de conversão. Quem está numa etapa fora do funil, como "Abandonado", conta só no primeiro contato. Etapas de conversão vizinhas, como "Compra online" e "Compra presencial", aparecem juntas numa linha só.

Na origem, Google Ads só aparece para quem chegou pelo link rastreado; lead de Google sem link rastreado entra em "orgânica ou sem rastreio".

Conversas para revisar

Lista dos leads que pedem atenção, com a situação (sem resposta, sem continuidade, conversão provável) e a data da última interação. Abrir conversa e Ver evidências levam à página do lead, onde estão a conversa inteira e a análise da IA. Na aba Diagnóstico aparecem as primeiras; Ver todas abre a aba Conversas com a lista completa.

Origem dos leads

Três gráficos de pizza: tráfego pago contra orgânico ou sem rastreio, o tráfego pago dividido por plataforma e os leads por campanha. A legenda traz, para cada fatia, os leads, a parte do total e a taxa de conversão; as fatias menores se juntam em "Outros". A origem é confiável para anúncios da Meta com clique para o WhatsApp e para links rastreados; o resto aparece como orgânico ou sem rastreio. Essa divisão não aparece no portal do cliente.

Revisão de conversões

Confirmadas contra pendentes de validação. Só as confirmadas entram na taxa de conversão e são enviadas à Meta.

Apoio à análise

Definições de mediana, P90 e média, cada uma com o valor do período e o que ela quer dizer. Também ficam aqui: o que conta como sem resposta, sem continuidade e canal fora do ar; a diferença entre conversão confirmada (a IA concluiu com confiança de 85% ou mais, ou alguém da equipe confirmou na revisão) e conversão provável (a IA viu sinal com confiança menor e falta alguém confirmar); o que é lead qualificado e como o avanço pelo funil é contado; o escopo dos dados (só as conversas dos números conectados, com a origem vinda do clique em anúncio da Meta e dos links rastreados); o horário de atendimento do cliente; a base medida (quantas conversas entraram e quantas ficaram de fora); as respostas automáticas detectadas; e o mapa de volume por horário e dia, para conferir se a escala da equipe bate com o horário em que os leads procuram.

Respostas automáticas detectadas: o app identifica sozinho as mensagens usadas como resposta automática (o mesmo texto repetido como primeira resposta, em menos de 60 segundos). Elas não contam como atendimento humano: um robô que responde em segundos esconderia uma equipe que só aparece horas depois.

Portal do cliente

Versão do relatório para o cliente final ver sozinho, sem login. É um link fixo por cliente, no formato app.agileads.com.br/p/<código>, com filtro de período (padrão: últimos 30 dias, máximo 180) e a opção Comparar períodos.

Para gerar: em Atendimento, escolha o cliente e clique em Portal do cliente. Na primeira vez o link é criado na hora. Copie e envie por WhatsApp, e-mail ou onde preferir. O mesmo link continua valendo; não precisa reenviar a cada relatório.

O cliente vê:

• a barra vermelha enquanto o WhatsApp estiver desconectado;
• os quatro indicadores, com a comparação;
• o resumo em frases;
• O que merece atenção: quantos leads aguardam a primeira resposta e quantos estão sem continuidade (só os números, sem nomes nem telefones);
• O que aconteceu com os leads: a etapa atual dos leads e o que conta como conversão.

Não aparecem a lista de contatos, a origem dos leads, as respostas automáticas, a fila de revisão nem termos de estatística: isso fica na tela de Atendimento, para a equipe.

Gerar novo link (só admin) invalida o anterior na hora. Use se o link vazou ou o cliente trocou de mãos. Cliente arquivado deixa de responder no link.

11. Equipe (/team, admin)

• Convidar membro — e-mail + papel. A pessoa recebe um e-mail para definir a senha.
• Papel — Admin vê tudo da agência; Agente vê apenas os clientes alocados a ele.
• Alocar clientes — no botão da coluna "Clientes", marque quais clientes aquele agente pode ver. Só vale para agentes: admin vê todos.
• Remover membro.

Duas travas de segurança: não é possível remover nem rebaixar o último admin da agência.

12. Assinatura e planos (/billing, admin)

Plano Agência (por faixa)

O plano de agência é cobrado pela faixa de clientes ativos contratada:

A primeira fatura inclui a implementação.

Mudar de faixa

Na página Assinatura, a tabela de faixas mostra a sua faixa atual e o preço de cada uma. Toque na faixa desejada e confirme: a página mostra o novo valor mensal e quanto da diferença deste mês entra na próxima fatura (o valor é proporcional aos dias que faltam). O novo limite de clientes vale na hora.

Quando você bate o limite, a página Clientes avisa e o botão Aumentar faixa leva direto para a Assinatura com a próxima faixa selecionada.

Descer de faixa também é feito ali, desde que a faixa nova comporte os clientes ativos. Se não comportar, arquive clientes antes. Arquivar cliente não muda a faixa sozinho: a troca é sempre feita por você.

Planos anteriores

Assinaturas feitas antes da tabela por faixa continuam nos planos abaixo.

Cada plano também tem uma quota mensal de análises de IA, dimensionada para o volume de conversas do porte do plano. A sua aparece na própria página de Assinatura, junto com o consumo do mês. Há ainda um limite de canais de WhatsApp por cliente: 2 na maioria dos planos, 3 no PRO.

Não há período de teste gratuito.

No plano Master, clientes ativos acima de 30 são cobrados como excedente: R$ 49 por cliente extra por mês, lançado na fatura seguinte. A página de Assinatura mostra a estimativa do excedente do ciclo atual.

O que a página mostra

Plano, status da assinatura, preço, limite de clientes, quota de análises, se a transcrição de áudio está incluída, até quando vai o período atual, e o uso de clientes contra o limite.

Gerenciar

O botão "Gerenciar assinatura" leva ao portal do Stripe, onde ficam cartão, faturas e cancelamento. A troca de faixa do plano Agência é feita na própria página de Assinatura (veja acima).

Pagamento pendente (past_due)

Se o pagamento falhar, o app continua funcionando, mas exibe um aviso fixo no topo: "Pagamento pendente — atualize seu cartão para não perder o acesso." Atualize o cartão pelo portal do Stripe. Se a assinatura for cancelada, o acesso ao painel é bloqueado.

13. Integrações (/integrations)

Meta Ads — nomes de campanha

Lead que vem de anúncio da Meta chega só com o número do anúncio. Com um token de leitura de anúncios, o Agileads busca na Meta o nome da campanha, do conjunto e do anúncio de cada lead. Um token só, gerado no Business Manager da agência, cobre todos os clientes cujas contas de anúncios estão nesse Business Manager. Só admin do Agileads cadastra. O que muda nas telas está na seção 5.

O token é só de leitura: com a permissão ads_read, ele consulta os anúncios e não consegue criar, pausar nem editar nada.

Os nomes de menu abaixo são os do Facebook em português, com o nome em inglês entre parênteses. A Meta muda as telas de lugar de tempos em tempos; se um botão não estiver onde o passo diz, procure pelo nome.

Antes de começar

Confira três coisas. Na primeira vez, o processo todo leva uns 15 minutos.

1. Você é administrador do Business Manager da agência (a Meta também chama de portfólio empresarial). Quem é só funcionário não consegue criar usuário do sistema nem gerar token.
2. As contas de anúncios dos clientes estão no seu Business Manager, como da agência ou compartilhadas com ela como parceira. Normalmente já estão, porque é por ali que você roda os anúncios. Confira em Configurações do negócio → Contas → Contas de anúncios (Business settings → Accounts → Ad accounts). Se a conta de algum cliente não aparecer, veja "Conta do cliente fora do seu Business Manager", mais abaixo.
3. Existe um app da Meta no seu Business Manager. Confira em Configurações do negócio → Contas → Apps (Accounts → Apps). Se a lista estiver vazia, comece pelo passo 1. Se já houver um app, pule para o passo 2 e use esse app.

Passo 1. Criar um app (só se não houver nenhum)

O token precisa estar ligado a um app da Meta. Esse app não fica público e não precisa passar por análise da Meta para isso.

1. Em Configurações do negócio → Contas → Apps, clique em Adicionar e escolha Criar um novo identificador do app (Create a new app ID). Abre o painel de desenvolvedores da Meta.
2. Dê um nome ao app (por exemplo, "Agileads leitura"), confirme o e-mail de contato e avance.
3. No caso de uso, escolha Avaliar dados de desempenho de anúncios com a API de Marketing (Measure ad performance data with Marketing API), no grupo de anúncios. Avance.
4. Selecione o Business Manager da agência e avance até Criar app.

Passo 2. Criar o usuário do sistema

O usuário do sistema é um usuário "robô" do Business Manager. Ele não depende da conta pessoal de ninguém, então o token continua funcionando quando alguém sai da agência ou troca a senha do Facebook.

1. Abra Configurações do negócio → Usuários → Usuários do sistema (Users → System users). Atalho: business.facebook.com/settings/system-users.
2. Clique em Adicionar.
3. Nome: "Agileads". Função: Funcionário (Employee).
4. Clique em Criar usuário do sistema.

Passo 3. Dar ao usuário do sistema o app e as contas de anúncios

Ainda na tela de Usuários do sistema, com o usuário "Agileads" selecionado:

1. Clique em Atribuir ativos (Assign assets).
2. Em tipo de ativo, escolha Apps, marque o app (o do passo 1 ou o que já existia), ative Gerenciar app (Manage app) e clique em Atribuir ativos.
3. Clique de novo em Atribuir ativos, escolha Contas de anúncios e marque as contas de todos os clientes que você acompanha no Agileads. Em permissões, ative Gerenciar contas de anúncios (Manage ad accounts) e clique em Atribuir ativos.

Dar controle total às contas de anúncios parece muito, mas o que o Agileads consegue fazer é decidido pelo token do passo 4, que só terá permissão de leitura.

Passo 4. Gerar o token

1. Com o usuário "Agileads" selecionado, clique em Gerar token (Generate token; em algumas contas aparece como Gerar novo token).
2. Escolha o app do passo 3 e avance.
3. Na validade do token (Token expiration), escolha Nunca (Never) e avance.
4. Nas permissões, marque só ads_read. Nenhuma outra é necessária. Clique em Gerar token.
5. Copie o token antes de fechar a janela. Ele começa com EAA. A Meta mostra o token uma única vez; se fechar sem copiar, gere outro, sem problema.

Não mande o token por WhatsApp nem por e-mail. Cole direto no Agileads, no passo seguinte: lá ele fica guardado cifrado e nunca é exibido de volta.

Passo 5. Colar no Agileads

1. No Agileads, abra Integrações no menu lateral.
2. No quadro Meta Ads — nomes de campanha, cole o token e clique em Salvar token.
3. O Agileads consulta a Meta na hora e responde embaixo do campo. A resposta pode juntar mais de uma frase: alguns clientes certos e outros com erro.

Depois disso, a tela Clientes mostra na coluna Meta CAPI, cliente a cliente, se está tudo certo ("Nomes de campanha (token da agência)") ou se há algum problema ("token da agência não enxerga esta conta", "token da agência inválido"). Anúncios novos ganham nome de hora em hora, sem você fazer nada.

Corrigi no Business Manager e o erro continua

Quando a Meta recusa uma conta por falta de permissão, o Agileads para de consultar aquela conta até o token ser salvo de novo, para não insistir em algo que vai falhar. Então, sempre que mexer nas atribuições do Business Manager, cole o mesmo token de novo em Integrações e clique em Trocar token. O Agileads refaz a consulta na hora e mostra o resultado.

Se você não tem mais o token copiado, gere outro (passo 4). O anterior continua válido até ser revogado, mas o Agileads passa a usar só o novo.

Cliente novo

Ao cadastrar um cliente novo no Agileads, atribua a conta de anúncios dele ao mesmo usuário do sistema (passo 3, item 3) e cole o mesmo token de novo em Trocar token. Não precisa gerar outro token.

Conta do cliente fora do seu Business Manager

Há duas saídas:

• Trazer a conta para o seu Business Manager (recomendado). Peça ao cliente que compartilhe a conta de anúncios com a agência como parceira. Ele vai precisar do ID do seu Business Manager, que fica em Configurações do negócio → Informações da empresa (Business info). Quando a conta aparecer na sua lista de contas de anúncios, siga o passo 3, item 3.
• Token próprio do cliente. O cliente (ou você, com acesso de admin ao Business Manager dele) faz os passos 1 a 4 no Business Manager do cliente, e o token vai em Clientes → botão "Configurar" na coluna Meta CAPI, no bloco 2 da janela, só para aquele cliente. Esse token tem prioridade sobre o da agência. O bloco 2 só abre depois que a Meta CAPI do cliente (bloco 1) estiver salva.

Outros problemas na Meta

• Não aparecem os botões "Adicionar", "Atribuir ativos" ou "Gerar token". Você não é administrador do Business Manager. Peça a um administrador para fazer os passos ou para mudar a sua função.
• O app não aparece na lista ao gerar o token. O app não foi atribuído ao usuário do sistema (passo 3, item 2) ou não está no seu Business Manager (Contas → Apps).
• A permissão ads_read não aparece na lista. O app foi criado sem o caso de uso de anúncios. Crie um app novo pelo passo 1, atribua ao usuário do sistema (passo 3, item 2) e gere o token com ele.
• Não existe a opção "Nunca" na validade do token. Alguns Business Managers exigem token com prazo. Escolha 60 dias e anote a data: quando vencer, a tela Clientes passa a mostrar "token da agência inválido". Gere outro token (passo 4) e cole em Trocar token.
• A Meta não deixa criar outro usuário do sistema. Use um que já exista no seu Business Manager e faça os passos 3 e 4 com ele. O token gerado continua só com ads_read.

14. Problemas comuns

O QR expirou / o link não abre mais. Links de pareamento valem 24 horas e são de uso único. Gere um novo em Canais → Novo link. Gerar um link novo invalida o anterior — se você gerou dois, use o último.

O canal caiu (Desconectado). Igual ao WhatsApp Web: acontece quando o celular fica muito tempo offline, quando alguém desconecta o aparelho no WhatsApp, ou depois de arquivar o cliente. Abra o link de reconexão do canal e escaneie o QR de novo; o passo a passo está em "Meu WhatsApp desconectou", na seção 4. Nenhum histórico é perdido.

A análise do lead não apareceu. A análise não é em tempo real — roda uma vez por dia (e uma varredura semanal). Além disso, ela não roda se: a conversa não teve mensagem nova, o lead já está marcado como convertido, o lead foi marcado como "não é lead", o cliente está arquivado, ou a quota mensal do plano acabou.

O áudio não foi transcrito. A transcrição leva até cerca de 40 minutos depois que o áudio chega: recarregue a página do lead depois disso. Ela é um recurso dos planos Agência, PRO, Growth e Master; nos demais, o áudio aparece na conversa mas não entra na análise. Áudio de contato marcado como "não é lead" também não é transcrito. Se o prazo passou num plano com transcrição, mande o print para contato@agileads.com.br.

A conversão apareceu como "Ignorado". Não é erro. Significa que não havia clique de anúncio para atribuir (lead orgânico), que o lead foi marcado como "não é lead", ou que a conversão tem mais de 7 dias — nesse caso, a Meta não a aceitaria.

A conversão foi enviada mas não aparece no Events Manager. A atribuição à campanha pode levar até ~24h para aparecer. Se depois disso continuar sem aparecer, quase sempre é a configuração da Meta daquele cliente (Page ID ou Dataset ID apontando para o lugar errado) — o log de despacho mostra o erro devolvido pela Meta. Mande o print para contato@agileads.com.br que resolvemos com você.

"Origem desconhecida" está muito alta. Esperado em números que já atendiam antes do Agileads: quem já era contato do WhatsApp volta a mandar mensagem sem passar por anúncio. Tende a cair conforme o volume novo entra. Para tráfego de Google/TikTok/LinkedIn/bio, use links rastreados.

Não consigo criar mais clientes — o botão está desabilitado. Você chegou ao limite de clientes ativos do plano. Arquive um cliente que saiu (o histórico é preservado) ou faça upgrade na página Assinatura. No plano Master não há bloqueio: cliente acima de 30 é cobrado como excedente.

Gerei vários links de pareamento e o app recusou. São no máximo 3 links a cada 15 minutos por conta. A mensagem diz em quantos minutos libera. Antes de pedir o próximo, confirme se os canais anteriores conectaram.

O relatório de atendimento diz que o canal ficou fora do ar. O WhatsApp caiu durante aquele período e as mensagens não chegaram até nós — o atendimento pode ter acontecido normalmente pelo celular. Essas conversas ficam num balde separado e não contam como "sem resposta". Reconecte o canal (seção 4) e refaça o relatório depois.

A nota de qualidade do atendimento parece baixa. A escala da IA é estreita: quase toda a base fica entre 66 e 79. Leia o texto embaixo do número (acima da base, na média, abaixo) e compare períodos e clientes — não compare com 100.

Não vejo Segmentos / Equipe / Assinatura no menu. Essas telas são exclusivas do papel Admin.

Dúvidas: contato@agileads.com.br.