Manual do wacrm

1. O que é este sistema

Um CRM que vive em volta das conversas. Ele junta numa tela só o WhatsApp, o Instagram e o Facebook, guarda quem é cada pessoa que escreveu, acompanha o negócio até fechar e mostra quanto disso veio de anúncio.

O que ele faz, em uma linha cada:

Clique para ampliar

Como a tela é organizada

A barra lateral da esquerda tem as áreas. No rodapé dela ficam Configurações, Manual, Suporte e o seu nome, que abre o menu da conta. A seta no canto recolhe a barra para sobrar espaço, e as áreas viram só ícones com o nome aparecendo ao passar o mouse.

Área que você não usa pode sumir da barra. Isso é em Configurações, Modo da conta.

2. Primeiro acesso e a sua equipe

Entre em wa.ikoeh.com e clique em Criar conta. A primeira conta criada vira a dona do espaço de trabalho. Confirme o e-mail, que chega em seguida, e pronto.

Na primeira entrada o sistema abre um assistente que pergunta o básico da empresa e leva você por um tour das áreas. Dá para pular e voltar depois: o tour fica no menu do seu nome, no rodapé da barra lateral.

Convidar quem vai trabalhar com você

Configurações, Membros da equipe, convidar por link. O convite vale por tempo limitado e já leva o papel definido.

A escolha do papel não é burocracia. Ela decide quem consegue cadastrar chave de API, apagar contato, disparar transmissão e ver faturamento. Atendente que precisa mexer em configuração todo dia é sinal de que o papel está errado, não de que a regra está apertada.

Horário de funcionamento

Configurações, Empresa. Você marca os dias e as faixas de horário em que a equipe atende.

Isso não é enfeite: a automação de "fora do horário" usa essa tabela para saber quando responder que ninguém está na mesa, e o painel usa para calcular tempo de resposta sem contar a madrugada como demora.

3. Idioma e aparência

Idioma. Clique no seu nome, no rodapé da barra lateral, e escolha Idioma. Português, inglês e espanhol. A escolha vale para você, não para a equipe inteira: cada pessoa usa no idioma que quiser, na mesma conta, olhando os mesmos dados.

Aparência. Configurações, Aparência. Cinco modos (Light, Dark, Pro, Pro II e Pro II Dark) e cinco cores de destaque.

Clique para ampliar

A troca é imediata, sem recarregar a página:

Clique para ampliar

A aparência fica salva neste navegador, por pessoa. Trocar de máquina volta ao padrão.

4. Conectar as plataformas

Tudo acontece em Configurações, Canais. É aqui que o CRM deixa de ser uma tela bonita e passa a receber mensagem de verdade.

4.1 WhatsApp: dois caminhos, e eles são bem diferentes

Existem duas formas de ligar um número, e a escolha tem consequência.

API oficial (recomendado). O caminho do Meta. Vários atendentes no mesmo número, transmissão por template aprovado, nenhum risco de banimento. Exige conta comercial no Meta, e o número não pode estar em uso no aplicativo comum do WhatsApp.

QR Code (não oficial). Conecta lendo o QR, como o WhatsApp Web. Serve para número comum, sem burocracia e sem custo por conversa. O próprio CRM lista os riscos antes de você aceitar, e eles são reais:

1. É contra os termos do WhatsApp. O número pode ser banido, sem aviso e sem recurso.
2. Não tem template nem transmissão. Fora da conversa aberta, não dá para iniciar contato em massa.
3. Precisa de um servidor ligado 24 horas. Se ele cair, o número desconecta até alguém reconectar.
4. Pode parar quando o WhatsApp mudar o protocolo, sem aviso.

A recomendação honesta: número por QR para o celular que já era pessoal e continua sendo, e API oficial para o número que sustenta o negócio.

4.2 Conectar pela API oficial

O caminho tem duas metades, uma na Meta e outra aqui.

Na Meta (developers.facebook.com):

1. Crie um app do tipo Business.
2. Adicione o produto WhatsApp.
3. Em API Setup, anote o Phone number ID e o WhatsApp Business Account ID (WABA ID).
4. Gere um token de acesso permanente (System User token, com as permissões whatsapp_business_messaging e whatsapp_business_management). O token temporário de teste expira em 24 horas e vai te dar dor de cabeça no dia seguinte.

No CRM (Configurações, Canais, WhatsApp, opções avançadas):

1. Cole o Phone number ID, o WABA ID e o token.
2. Invente um token de verificação (qualquer texto secreto, por exemplo meu-crm-2026) e salve.

De volta na Meta, em WhatsApp, Configuration, Webhook:

• URL de callback: https://wa.ikoeh.com/api/whatsapp/webhook
• Verify token: exatamente o texto que você inventou acima.
• Clique em Verify and save e assine o campo messages.

Se a verificação falhar, é quase sempre uma destas duas: o token de verificação está diferente dos dois lados, ou a configuração no CRM ainda não foi salva.

4.3 O que cada número pode fazer

Abrindo um número conectado, aparece o bloco O que este número pode fazer, com três chaves. Elas valem por número, não pela conta inteira.

Isso existe por um motivo concreto. Quem liga o número pessoal por QR Code costuma não querer que a conversa com a sogra vire lead no funil e entre na contagem do mês. Desligando "Entrar no funil", as mensagens continuam chegando na caixa de entrada, mas param de virar negócio.

Se o número já criou negócios antes de você desligar a chave, tem um botão Tirar do funil os negócios deste número que limpa o passado. Os contatos e as conversas ficam, só os cartões do Kanban saem.

4.4 Instagram e Facebook

Precisa de uma página do Facebook e de uma conta do Instagram profissional vinculada a ela.

Em Configurações, Canais, clique em conectar no cartão do Instagram ou do Facebook e faça o login com a conta que administra a página. O sistema pede as permissões de mensagens e de publicação.

As mensagens diretas dessas duas redes caem na mesma caixa de entrada do WhatsApp, com a marca da rede no avatar. Os comentários em publicações ficam separados, em Social, Comentários. Comentário não é conversa, e misturar os dois faz o atendente perder a conversa de verdade no meio de trinta "top demais".

4.5 Google Meu Negócio

Em Canais, Google Meu Negócio, Conectar. Entre com a conta que administra a ficha, não a conta pessoal de quem só tem acesso de leitura. O detalhe do que dá para fazer depois está em Google Meu Negócio.

4.6 Google Agenda

Configurações, Canais, Google Calendar. Serve para marcar reunião direto da conversa: o evento entra na sua agenda e o convite sai para o cliente, sem você trocar de aba.

4.7 TikTok

Configurações, Canais, TikTok, para publicar vídeos pela área Social.

5. Caixa de entrada

É onde o atendente vive. Uma lista à esquerda, a conversa no meio, a ficha do contato à direita.

A lista da esquerda

Ela mostra as conversas em ordem de quem falou por último. Cada linha traz o avatar com a marca da rede, a última mensagem, a hora, e o contador de não lidas.

Em cima da lista tem busca e filtros: por atendente, por status do lead, por etiqueta, por canal, e o filtro de não lidas. Atendente com cem conversas abertas usa esses filtros o dia inteiro, e quem nunca mexeu neles costuma estar rolando a lista à mão sem precisar.

A conversa

O corpo da conversa trava sempre na última mensagem. Clicar em outra conversa e voltar não faz a tela pular para o meio: você volta onde a conversa está agora.

Dá para responder com texto, emoji, áudio gravado na hora, imagem, vídeo, documento e localização. Mensagem enviada mostra os dois traços de entregue e de lido, do mesmo jeito que no aplicativo.

O que dá para fazer sem sair da conversa

• Mudar o status do lead (qualificado, desqualificado, reunião marcada, orçamento enviado, cliente). Isso alimenta a CRC e, se o Meta CAPI estiver ligado, avisa a Meta para melhorar as campanhas.
• Atribuir a conversa a alguém da equipe. A partir daí ela aparece filtrada para essa pessoa.
• Ligar e desligar o bot naquela conversa específica.
• Marcar reunião, com o evento indo para a Google Agenda.
• Enviar orçamento, que gera o PDF e registra o valor.
• Agendar mensagem para sair depois.
• Ver de qual anúncio a pessoa veio, no meio das mensagens, no ponto exato em que ela chegou.
• Anotar na ficha ao lado, coisa que o cliente não vê.

A janela de 24 horas

WhatsApp, Instagram e Facebook têm a mesma regra: depois de 24 horas sem mensagem da pessoa, você não pode mandar texto livre. O cabeçalho da conversa mostra quanto tempo resta.

Passada a janela, só um template aprovado reabre a conversa. Não é limitação do CRM, é regra da Meta, e vale para qualquer ferramenta.

O bot, e como calar ele

Se um fluxo ou uma automação estiver ligada, ela responde sozinha.

Assim que você manda uma mensagem pelo CRM, a automação se cala naquela conversa por 24 horas. É de propósito: humano entrou, robô sai. Dá para calar antes pelo botão Bot no cabeçalho, e devolver com o mesmo botão.

O sistema também se cala sozinho quando a mensagem recebida tem cara de robô de outra empresa, para dois automáticos não ficarem conversando entre si a noite toda.

6. Contatos

Cada pessoa que escreve vira um contato automaticamente. Você também pode criar à mão ou importar uma planilha.

Importar uma lista

Contatos, Importar. O arquivo precisa de uma coluna de telefone; nome, e-mail e empresa são opcionais.

O sistema não duplica: telefone que já existe é atualizado, não recriado. Isso vale também para a importação repetida da mesma planilha corrigida, que é o caso normal.

A ficha do contato

Abrindo um contato você vê os dados, as etiquetas, os campos personalizados, os negócios dele, e o histórico completo: toda conversa de todos os canais, em ordem, mais as anotações da equipe.

É a tela para abrir antes de ligar para alguém.

Etiquetas

Agrupamento rápido e colorido. Servem para segmentar transmissão depois, e para filtrar a caixa de entrada.

O conselho que economiza retrabalho: poucas etiquetas, com nome que a equipe inteira entende igual. Vinte etiquetas parecidas viram zero etiqueta em dois meses.

Campos personalizados

Quando você precisa guardar algo que o sistema não tem de fábrica: CEP, nacionalidade, número do processo, modelo do carro, o que for.

Crie em Configurações, Campos e tags. Eles aparecem na ficha de todo contato, viram variável nas mensagens e podem ser condição nas automações.

Clique para ampliar

7. Vendas: funil e orçamentos

O funil

Vendas, Funil, é um Kanban. Cada cartão é um negócio, com valor e etapa, ligado a um contato e à conversa dele. Arraste para mudar de etapa.

As etapas são configuráveis: Configurações, Negócios. Quem tem ciclo curto costuma viver melhor com quatro etapas do que com nove.

Quando o negócio termina, marque ganho ou perdido, e no caso de perdido, o motivo. É esse motivo que vira o relatório "por que perdemos" na CRC. Sem ele, o relatório fica vazio e ninguém aprende nada com o mês que passou.

Orçamentos

Saem de dentro da conversa. O CRM gera um PDF, registra o valor e marca o contato como "orçamento enviado".

O valor do negócio é preenchido sozinho a partir da proposta, e dá para editar à mão depois.

Uma regra do sistema que vale conhecer: quando o PDF leva mais de uma opção de proposta, o CRM usa sempre o menor valor para calcular o que ficou na mesa. Somar as opções inventaria um número que ninguém propôs. Quando a proposta é de itens somados, aí sim ele usa o total.

8. CRC: os números do mês

A Central de Relacionamento com o Cliente responde três perguntas: quem chegou, o que aconteceu com essas pessoas, e o que trouxe elas.

Clique para ampliar

O funil do mês

Cada etapa conta quem chegou até ela, em qualquer ordem, e a porcentagem é sempre sobre o total de leads. Ou seja: quem virou cliente conta também como qualificado, mesmo que ninguém tenha clicado em "qualificado" no caminho. Isso evita o funil furado, onde a etapa do meio tem menos gente que a etapa do fim.

Os dois recortes

No canto superior direito tem dois recortes, e eles dão números diferentes de propósito:

• Quem chegou. Os leads que entraram no mês, e o que aconteceu com eles depois, mesmo que tenha sido no mês seguinte.
• O que aconteceu. O que se moveu dentro do mês, independentemente de quando a pessoa chegou.

A primeira pergunta serve para avaliar a origem: o anúncio de março trouxe gente que fechou? A segunda serve para avaliar o time: o que a equipe moveu em março?

Confundir as duas é a fonte mais comum de discussão improdutiva em reunião de resultado.

Por que saímos do funil

Desqualificados com o motivo, perdidos com o motivo, e quem ainda não foi triado. Se esses blocos estiverem vazios, não é porque está tudo bem: é porque ninguém está marcando motivo ao fechar o negócio.

Anúncios

A aba ao lado mostra investimento, custo por lead, custo por lead qualificado, CAC e ROAS por criativo.

Precisa da conexão com o Meta Ads. Canais sem integração (Google, indicação, panfleto) entram com custo informado à mão, e continuam aparecendo na comparação.

9. Transmissões

Envio em massa, em quatro passos.

Clique para ampliar

1. Template. Só templates aprovados pela Meta. Fora da janela de 24 horas, é a única forma de falar com alguém. Criar template é em Configurações, Templates; a aprovação leva de minutos a algumas horas.
2. Público. Quem recebe. Filtre por etiqueta, status do lead, origem ou campo personalizado. O número de pessoas aparece antes de você confirmar.
3. Personalizar. Preencha as variáveis do template ({{1}}, {{2}}) com o nome, a empresa ou qualquer campo do contato.
4. Enviar. Agora ou agendado.

Depois de enviar, a tela do envio acompanha destinatário por destinatário: entregue, lido, respondido, falhou e por quê. Quem respondeu já está na caixa de entrada, com a conversa aberta.

Cuidado que economiza dinheiro e reputação: transmissão para quem nunca falou com você é o caminho mais rápido para o número ser bloqueado. Mande para quem pediu, com conteúdo que a pessoa espera receber. Uma denúncia custa mais caro que dez envios bem feitos rendem.

10. Automações

Regras simples do tipo "quando isso acontecer, faça aquilo".

Clique para ampliar

Gatilhos: mensagem recebida, contato novo, palavra-chave, primeira mensagem, horário.

Ações: responder com mensagem ou template, aplicar etiqueta, mudar status ou campo do contato, criar negócio, notificar a equipe, chamar um webhook.

Quatro modelos prontos: boas-vindas, fora do horário, qualificador de lead e lembrete de acompanhamento. Comece por um deles e edite, que é mais rápido que montar do zero e ensina a lógica no caminho.

Cada automação tem uma tela de logs: o que ela fez, quando, e para quem. É por onde se descobre por que aquela mensagem saiu, e é a primeira tela para abrir quando alguém reclama que o robô falou besteira.

11. Fluxos

Quando a automação de uma regra só não basta, o fluxo monta uma conversa inteira: menu com botões, perguntas, ramificação por resposta, espera, entrega de arquivo e passagem para o humano.

Clique para ampliar

Cada fluxo é uma sequência de nós: início, enviar mensagem, enviar botões, enviar lista, coletar resposta, condição, etiqueta, marcar reunião, resposta com IA, transferir para atendente, fim.

Um fluxo nasce como rascunho e só roda depois de Ativo. Isso evita o clássico de publicar um menu pela metade em cima da hora do almoço.

A tela de execuções mostra cada conversa que passou pelo fluxo, nó a nó. É onde se depura: dá para ver exatamente em qual pergunta a pessoa desistiu, o que costuma ser mais útil que qualquer suposição.

12. Social

• Publicações. Calendário e lista do que foi ou vai ser publicado no Instagram, Facebook e TikTok. Dá para agendar e publicar nas três redes de uma vez.
• Desempenho. Números de cada publicação.
• Comentários. Os comentários das publicações, separados das conversas.
• Respostas automáticas. Responder comentário e mandar DM sozinho quando alguém comenta uma palavra-chave. É o "comente ABC que eu te mando o link" feito direito, com a DM saindo na hora em vez de no dia seguinte.

13. Google Meu Negócio

A ficha do Google é onde a maioria dos clientes de negócio local descobre que a empresa existe. Esta área faz três coisas: audita a ficha, conserta o que está faltando sem sair do CRM, e mede a posição no mapa bairro a bairro.

Cada aba tem endereço próprio (/google-meu-negocio/auditoria, /google-meu-negocio/mapa, e assim por diante), então dá para mandar o link direto de uma aba para alguém.

13.1 Conectar

Configurações, Canais, Google Meu Negócio, Conectar.

Entre com a conta Google que administra a ficha. O Google vai pedir a permissão business.manage, que é a que deixa o CRM ler e escrever.

Depois de conectar, escolha o perfil. Se a conta administra várias fichas, o seletor no alto da tela troca entre elas, e cada cliente do CRM pode ter a ficha dele amarrada ao contato.

A permissão de escrita é real: o que você salvar aqui muda a ficha pública no Google. Não é rascunho.

13.2 As abas

13.3 A auditoria

São 33 verificações com peso somando exatamente 100. O peso não é opinião: vem de quanto cada item pesa no ranking local de verdade. Categoria principal vale 8, verificação do perfil vale 5, uma foto de logo vale 2.

Três detalhes que mudam como ler a nota:

• O que o Google não respondeu não vira zero. Se a API não devolveu as avaliações, o item sai da conta em vez de virar "falta". Nota baixa aqui significa ficha ruim, nunca API com soluço.
• "Atenção" vale metade. Descrição de 71 caracteres num limite de 750 não é "tem" nem "não tem".
• A lista de prioridades é ordenada por ganho, não por gravidade. O primeiro item da lista é o que sobe mais pontos com menos trabalho, que quase nunca é o mais dramático.

Cada item tem o botão Corrigir, que leva direto para a aba e o campo daquele problema.

13.4 A IA que preenche o que falta

Nos campos de texto longo (descrição, serviços, FAQ e postagem) tem o botão de escrever com IA. Ele lê a ficha (categoria, cidade, serviços cadastrados, atributos) e escreve a partir só disso.

Ele não inventa tempo de mercado, número de clientes, prêmio nem certificação. Faltando informação, o texto sai mais curto em vez de sair mentiroso. Isso é regra escrita no prompt, não sorte.

Qual IA responde é escolha sua, em Configurações, IA. A conta pode cadastrar quantos provedores quiser.

Leia antes de salvar. O texto é bom, mas quem responde pela ficha é você.

13.5 O mapa de posições

A auditoria diz como a ficha parece. O mapa diz onde ela aparece.

Escolha a palavra que o cliente digitaria ("vidraçaria", "dentista 24 horas"), o tamanho da grade e o raio. O CRM faz uma busca do Google em cada ponto da grade, como se fosse alguém parado ali com o celular na mão, e pinta o ponto com a posição em que a ficha saiu: verde é topo, vermelho é longe, cinza é fora dos vinte primeiros.

Além da mancha colorida, a tela traz:

• Posição média e quantos pontos ficaram no topo.
• Os concorrentes que apareceram na varredura, em ordem de quem domina mais pontos. Clicar em um deles mostra a grade dele.
• O plano por região. A grade vira nove regiões a partir do endereço (centro, norte, sul, leste, oeste e as diagonais), cada uma classificada e com o que fazer ali. Ele abre sozinho na região onde há mais a ganhar, que é quem está perto do pódio, não quem está mais longe: tirar a ficha do quinto para o terceiro faz o telefone tocar; tirar do "não aparece" para o décimo quinto ainda não muda nada.
• O histórico, com as grades lado a lado para ver a mancha vermelha virando verde depois de uma correção.

13.6 A chave do Google Maps e os créditos

A varredura usa a Places API do Google, que é paga depois da cota gratuita. Por isso ela tem chave e tem medidor.

A chave. Em /google-meu-negocio/mapa, o painel "Falta a chave da Google Maps Platform" tem o campo para colar a sua. Crie em console.cloud.google.com com Places API (New) e Maps Static API ativadas. Ela é testada antes de ser gravada e fica criptografada no banco: uma chave errada dá erro na hora, em vez de virar um mapa vazio uma semana depois.

O projeto precisa de faturamento ativo. As APIs do Google Maps exigem cartão cadastrado no projeto do Cloud, mesmo com cota gratuita mensal. Sem isso a chave é aceita aqui e recusada lá, e o sintoma é o mesmo de chave errada. É o motivo mais comum de "coloquei a chave e não funcionou".

Esta chave é de servidor. Não a restrinja por domínio. No console do Google, a restrição por "Referenciadores HTTP" confere de qual página o pedido veio — e quem chama o Google aqui é o nosso servidor, que não tem página de origem. Uma chave restrita por domínio passa a recusar a varredura e o mapa de posições. Se quiser restringir, use endereço IP ou deixe só a restrição de API (Places e Maps Static).

Não confunda com o mapa dos contatos, no painel: aquele não usa chave nenhuma — nem a sua, nem a nossa. Ele é desenhado no navegador sobre dados abertos do OpenStreetMap, então não consome cota de ninguém e não precisa de configuração.

Os créditos. Sem chave própria, a conta varre na chave do sistema, com um medidor no alto da aba. Um crédito equivale a uma varredura 5×5. Grade maior custa proporcional: a 7×7 custa 2 créditos, a 9×9 custa 4. O preço aparece antes de você clicar em rodar.

Cadastrando a chave da empresa, o medidor some: a conta é sua, o limite é seu.

13.7 Limites que vale saber antes de reclamar

• Chat do Google acabou. O Google desligou as mensagens da ficha em 31 de julho de 2024 e não existe API para isso. Avaliação, pergunta e ligação continuam; conversa pela ficha, não.
• O Google demora para refletir. Mudança de horário e descrição costuma aparecer em minutos. Nome e categoria podem passar por revisão e levar dias.
• Nem toda ficha traz coordenada. Negócio que atende em domicílio costuma vir sem, e aí a coordenada vem da Places na primeira varredura.
• Grade grande custa. 9×9 são 81 buscas numa varredura só. Use quando a pergunta for de região; para conferir uma correção, 3×3 resolve.

14. Configurações da conta

O que está em Configurações, e quando você precisa de cada um:

IA

Configurações, IA. Você cadastra a chave do provedor que quiser, e pode cadastrar mais de um. A chave fica criptografada no banco da sua conta.

Serve para sugerir resposta na conversa, para o nó de resposta com IA nos fluxos, e para escrever os textos da ficha do Google.

Integrações

API pública (/api/v1), para ligar o CRM a outros sistemas. Crie uma chave em Configurações, Integrações, com escopo e validade.

MCP, que deixa operar o CRM de dentro do Claude, do Cursor e de outros assistentes.

Meta Conversions API. Com ela ligada, cada mudança de status vira um evento de conversão na Meta, com o valor do orçamento e do fechamento junto. É provavelmente a integração que mais muda resultado de quem investe em anúncio, e tem capítulo próprio: veja Conversões no Meta.

15. Marketing: medir o que o anúncio trouxe

Este capítulo é para quem cuida de tráfego. Ele explica as duas peças independentes que fazem a campanha aprender, por que elas são diferentes, e o que acontece quando uma das duas falta.

Se você só quiser a resposta curta: são dois sistemas, e os dois precisam estar ligados para a medição fechar em 100%.

Resumindo em uma frase: o pixel conta que alguém chegou; o CRM conta quanto essa pessoa valeu. O Meta precisa dos dois para otimizar direito, e eles falham por motivos independentes — dá para ter um sem o outro, e é justamente aí que a conta não fecha.

Clique para ampliar

15.0 O pixel no site: sem ele, metade do funil é anônima

O problema que ele resolve. A pessoa vê o anúncio, clica, cai na página do cliente, lê, e só então toca no botão de WhatsApp. Quando a mensagem chega no CRM, não há nada nela dizendo de onde aquilo começou. O Meta tem um campo próprio que resolveria isso, mas ele só existe quando o anúncio aponta direto para o WhatsApp — com uma página no meio, ele não vem.

Como o pixel resolve. Ele lê, na chegada da visita, a campanha (utm_*) e o identificador do clique (fbclid no Meta, gclid no Google). Guarda por 90 dias, e quando a pessoa toca no botão de WhatsApp, escreve isso num marcador dentro da mensagem. O CRM lê o marcador e apaga antes de qualquer atendente ver — ninguém nunca enxerga aquilo na conversa.

A primeira visita é a que vale. Quem chegou pelo anúncio, saiu, e voltou dias depois digitando o endereço veio do anúncio. Se o pixel sobrescrevesse com a segunda visita, o crédito iria para "direto" e toda campanha pareceria pior do que é.

Campanha e clique vencem em prazos diferentes, e isso é de propósito. A campanha vale 90 dias, porque continua sendo verdade. O identificador do clique vale 7 dias, que é a janela em que o Meta ainda credita a conversão — passada ela, ele é descartado, porque mandar um clique velho não melhora nada e faria o relatório parecer mais preciso do que é.

Como instalar. Uma linha antes do </body> de cada página:

<script src="/rastreio-whatsapp.js" defer></script>

Mais o arquivo rastreio-whatsapp.js na raiz do site. Quem fez o site com a gente já tem os dois. Para conferir se está no ar, abra https://seusite.com.br/rastreio-whatsapp.js — se o arquivo aparecer, está instalado.

O que ele não faz: não coleta nome, telefone, e-mail, nem acompanha a pessoa pela internet. Ele lê o que já está na barra de endereço daquela visita e nada mais.

15.1 As conversões no CRM

Esta é a parte que muda o resultado de quem investe em anúncio, e é a que mais gente deixa desligada por achar que é complicada.

O problema que ela resolve: sem isto, o Meta só sabe que alguém clicou no anúncio e mandou mensagem. Ele não sabe se aquela pessoa virou orçamento de R$ 8.000 ou sumiu depois de perguntar o preço. Aprendendo só com "mandou mensagem", a campanha busca mais gente que manda mensagem, o que é barato e não paga conta. Com isto ligado, o Meta recebe cada etapa do funil com o valor em reais, e passa a procurar gente parecida com quem comprou.

Não existe pixel para instalar em site nenhum. Este é o ponto que mais confunde. O pixel é uma etiqueta de site, e aqui não há site: a conversa acontece dentro do WhatsApp. O que existe é um conjunto de dados de mensagens (dataset) no Meta, que mora dentro da sua conta do WhatsApp Business, e o CRM fala direto com ele pela Conversions API. Você não copia código, não mexe em tema, não chama programador.

E preste atenção nesta parte, porque ela derruba muita medição: o conjunto das mensagens não é o pixel do site. São dois identificadores diferentes, cada um com a sua caixa no Meta. Conversa que nasceu de anúncio clique-para-WhatsApp só é contada no conjunto; mandada para o pixel, ela some da campanha. O CRM busca esse número sozinho quando você conecta o número oficial, então não há o que copiar.

Clique para ampliar

15.2 Os dois caminhos do lead, e a chave de cada um

Toda conversão precisa de uma chave para o Meta saber a qual anúncio creditá-la. Existem duas, e cada uma vem de um caminho diferente. O CRM escolhe sozinho qual usar; você só precisa saber que existem, porque elas falham por motivos diferentes.

Caminho 1 — o anúncio aponta direto para o WhatsApp. É o anúncio Click-to-WhatsApp. A conversa chega com o código do clique junto (o ctwa_clid), de graça, e o CRM guarda sozinho. Não há nada a instalar.

Caminho 2 — o anúncio aponta para o site, e o site tem o botão. Aqui o Meta não manda código nenhum: quem carrega a chave até o CRM é o pixel do site, aquele da seção anterior. Sem o pixel instalado, este caminho inteiro é invisível — e ele costuma ser o da maioria de quem investe sério, porque quem tem landing page é quem faz campanha grande.

Um número conectado pela API oficial, para o caminho 1. Canais, número conectado pelo caminho oficial da Meta, com a conta empresarial do WhatsApp (WABA). Número conectado por leitura de QR code não serve para reportar conversão de mensagem — serve para atender. O caminho 2 não depende disso.

Lead sem nenhuma das duas chaves não vira conversão. Quem achou pelo Google orgânico, foi indicado por um amigo ou digitou o número não tem clique nenhum para citar. Ele continua no funil aqui, com status, valor e relatório normais — só não tem o que reportar lá. Isso não é defeito, e o diagnóstico do CRM conta essa diferença separada justamente para você não ler "nada está saindo" quando a resposta é "ninguém veio de anúncio este mês".

15.3 Ligar, em quatro passos

1. Ligue a chave. Configurações, Integrações, Meta Conversions API.

2. Confira o conjunto de dados das mensagens. Na mesma tela, logo abaixo dos campos, cada número oficial aparece com o seu conjunto: é uma sequência de números parecida com 123456789012345, que o CRM buscou sozinho no Meta quando o número foi conectado. Se o lugar estiver vazio, clique em Buscar no Meta. Se ainda assim não vier, o motivo aparece ali, e quase sempre é o mesmo: o token daquele número precisa das permissões whatsapp_business_management e whatsapp_business_manage_events.

3. Só se você anuncia para o site: preencha o pixel do site e o token do Conversions API, os dois campos de cima. Eles servem ao caminho 2 da seção anterior, o de quem clicou no anúncio, passou pela landing page e só então chamou no WhatsApp. Quem só anuncia clique-para-WhatsApp pode deixar os dois vazios. O token fica guardado criptografado, e a tela nunca mostra ele de volta.

4. Confira na mesma tela. Mais abaixo há o quadro Está chegando?, que olha os últimos 30 dias e diz em português o que está acontecendo. É ali que você descobre se o token venceu, se falta o conjunto de dados de algum número, se falta conectar a conta empresarial do WhatsApp, ou se está tudo certo e ninguém veio de anúncio.

15.4 O que cada etapa do funil vira lá

O nome do evento é fixo. O Meta aceita uma lista fechada nas conversões de mensagem — nome próprio não existe ali, e por isso "reunião marcada" viaja com o nome AddToCart: não há evento de agendamento na lista, e AddToCart é como o Meta entende "avançou um passo antes de comprar".

Clique para ampliar

Repare na coluna da direita, que é o ponto inteiro: orçamento e venda levam dinheiro junto. Os outros dois não levam de propósito. Um lead qualificado ainda não pediu nada, e pendurar o valor do orçamento nele contaria o mesmo dinheiro duas vezes no painel do Meta.

15.5 De onde sai o valor

Quando o status vira Orçamento Enviado, o CRM procura o valor nesta ordem e manda o primeiro que encontrar:

1. O total do orçamento que foi enviado, quando a proposta saiu pelo construtor de orçamentos.
2. O valor do negócio no funil, quando a proposta saiu como PDF pela conversa — este é o caminho mais usado, e o valor é o que o próprio documento dizia.
3. O valor estimado na ficha do contato, como último recurso.

Quando o status vira Cliente, a ordem começa pelo valor do negócio ganho, que é o que entrou de verdade. Pagamento recebido por Pix, boleto ou cartão fecha o negócio sozinho e manda a venda para o Meta com o valor pago, sem ninguém digitar nada.

Se o orçamento tem mais de uma opção, vale a menor: somar as opções inventaria um valor que ninguém pediu. Negócios ganhos, ao contrário, somam — dois contratos com a mesma pessoa são duas receitas.

E quando não há valor nenhum confiável, o evento sai sem valor, nunca com zero. Zero é uma afirmação sobre o negócio: ensina o algoritmo que aquela conversão não vale nada.

15.6 Quando não sai nada, e por quê

Lead desqualificado não manda nada. O Meta não tem sinal negativo neste canal. A ausência de progressão já treina o algoritmo sozinha.

Fornecedor, funcionário, Shopee e currículo também não. São conversas reais, que o CRM guarda, mas não são leads. Um evento de lead qualificado disparado por um fornecedor ensina a campanha a procurar mais fornecedores, com o dinheiro do anúncio.

Falta o conjunto de dados das mensagens. A conversa veio de anúncio, o número está conectado, e mesmo assim nada sai: é porque o CRM não tem para onde mandar aquele evento. Ele não usa o pixel do site como substituto de propósito, já que ali a conversão não chegaria à campanha e o painel ainda daria a impressão de estar funcionando. O quadro Está chegando? conta esses casos numa coluna própria, e a solução é o botão Buscar no Meta, na mesma tela.

A mesma mudança não conta duas vezes. Mudar o status, desfazer e refazer em seguida não gera duas conversões: o CRM segura o reenvio, e o próprio Meta descarta a repetição pelo identificador do evento.

16. Pagamentos e plano

Configurações, Plano. Ali ficam o plano atual, o histórico de cobrança e a troca de plano.

Conta em teste mostra quantos dias faltam no alto da tela. O vencimento não apaga nada: o acesso fica limitado até a regularização, e os dados continuam onde estavam.

17. Problemas comuns

Não recebo mensagem nenhuma. Confira, nesta ordem: o número está conectado em Canais, o webhook foi verificado na Meta, e o campo messages está assinado. Nove em cada dez casos param no terceiro.

A automação não responde. Veja se ela está Ativa, se o número tem a chave Responder sozinho ligada, e se você mandou mensagem na conversa nas últimas 24 horas, o que cala o bot de propósito.

Não consigo mandar mensagem para um contato. Provavelmente passou das 24 horas desde a última mensagem dele. Use um template aprovado.

O template foi recusado. A Meta recusa por promessa exagerada, texto de venda em template de utilidade, e variável no começo ou no fim da mensagem. O motivo aparece em Configurações, Templates.

Número pessoal criando lead no funil. Canais, abra o número, desligue Entrar no funil. Para limpar o que já entrou, use Tirar do funil os negócios deste número.

Meço menos leads do que o Google Analytics mostra de visitas. É esperado: nem toda visita vira conversa. Mas se a diferença for grande e os leads chegarem sem campanha nenhuma, confira se o pixel está no site: abra https://seusite.com.br/rastreio-whatsapp.js. Se der erro, ele não está instalado, e todo lead que passa pela página chega anônimo.

O Meta não mostra minhas conversões. Configurações, Integrações, Meta Conversions API: o quadro Está chegando? responde em português. As três causas, em ordem de frequência: nenhum lead do período veio de anúncio Click-to-WhatsApp, o número não está conectado pela API oficial com a conta empresarial do WhatsApp, ou o token venceu.

O Meta mostra conversão, mas sem valor. O valor só vai junto no orçamento enviado e na venda. Se o orçamento saiu sem número — PDF que o sistema não conseguiu ler, negócio sem valor no funil — a conversão chega sem valor de propósito, porque mandar zero seria pior. Preencha o valor do negócio na ficha e a próxima mudança de status leva o número.

A CRC está vazia. Ninguém está marcando status de lead nem motivo de perda. A CRC não inventa dado: ela mostra o que a equipe registrou.

O mapa do Google não roda. Ou falta a chave da Google Maps Platform, ou os créditos do mês acabaram. A mensagem na tela diz qual dos dois.

A varredura parou de funcionar depois que mexi na chave. Quase sempre é restrição por "Referenciadores HTTP" no console do Google. Ela serve para chave usada em página, e a varredura é chamada pelo nosso servidor, que não tem página de origem — então o Google recusa. Troque por restrição de endereço IP, ou deixe só a restrição de API. Ver 13.6.

O mapa dos contatos, no painel, ficou em branco. Ele não usa chave, então não é configuração. As causas possíveis são rede: o provedor dos ladrilhos fora do ar, ou algum bloqueio de rede da empresa impedindo o navegador de buscar as imagens do mapa. Os pontos verdes aparecem mesmo assim, porque são desenhados por nós — mapa sem fundo mas com pontos no lugar certo é sinal de ladrilho bloqueado.

Nada do que eu esperava aparece na barra lateral. Configurações, Modo da conta, com módulos desligados. Ou o seu papel é Agent ou Viewer, e a área é de administrador.