Como saber quais vendas vieram do WhatsApp (e quem chegou por lá)
Atualizado em
A conversa fecha no WhatsApp e o CRM nunca fica sabendo: a venda aparece como "direto" e o anúncio que trouxe a pessoa não leva o crédito. Isto liga as duas pontas — a chegada pelo WhatsApp, o clique que sai do seu site e, com a extensão do Chrome, a conversa que de fato aconteceu.
O que você ganha
- Ver "WhatsApp" como canal de origem no CRM, separado de social e de direto
- Medir o clique que sai do seu site para o WhatsApp — o salto que hoje some
- Saber que houve conversa com um telefone, sem que o texto das mensagens saia da sua máquina
- A venda fechada no WhatsApp deixa de virar "direto" e volta para a campanha que trouxe a pessoa
Antes de começar
- O r.js do FarejaLeads já instalado no site (guia Rastreamento no site). Sem ele não há visita para ligar à conversa.
- Para a parte da conversa: Google Chrome na máquina de quem atende no WhatsApp Web. Quem atende só pelo celular fica com as duas primeiras partes, que já funcionam sozinhas.
- O WhatsApp é de clientes seus: são dados pessoais sob a LGPD. Quem atende precisa saber que a extensão está ligada e para quê.
Passo a passo
1. A chegada pelo WhatsApp já funciona sozinha
Quem abre o seu site a partir de uma conversa aparece no CRM com o canal WhatsApp, sem você configurar nada. O r.js reconhece três sinais: a referência (web.whatsapp.com, wa.me, chat.whatsapp.com), o utm_source=whatsapp e o link marcado com ?fl_wa=1.
O celular costuma abrir o link sem mandar a referência. Por isso, no link que você cola na conversa, acrescente ?fl_wa=1 (ou ?utm_source=whatsapp): é o que garante a marcação quando o aparelho não ajuda.
WhatsApp é canal próprio, não "social": antes disso a visita caía em direto ou referência e se misturava com o resto.
2. O clique que sai do site para o WhatsApp
Todo botão do seu site que leva para wa.me, api.whatsapp.com/send ou web.whatsapp.com/send passa a mandar o evento whatsapp_clique. Também é automático, só com o r.js no ar.
Vai só o destino e o número do seu negócio. O texto pré-preenchido do link (?text=…) nunca sai.
É este o passo que some em quase todo site: a pessoa clica, vai para o WhatsApp e a medição acaba ali. Com o evento, você vê quantos saíram do site para a conversa — e, com o passo 3, quantos conversaram de verdade.
3. Gere o token da extensão
No FarejaLeads: Leads → Chaves dos sites → WhatsApp → Gerar token. Copie o wx_… na hora: ele aparece uma vez só.
É um token por site, diferente da chave secreta do servidor — ele vive dentro de um navegador, então tem escopo menor e você revoga quando quiser.
Gerar um novo invalida o anterior na mesma hora: a extensão que usava o antigo recebe 401 e para de mandar conversas até você colar o novo.
4. Instale a extensão no Chrome
Na mesma tela (Leads → Chaves dos sites → WhatsApp), clique em Baixar a extensão (.zip) e descompacte a pasta num lugar que você NÃO vá apagar: o Chrome carrega dela toda vez. Em Documentos está bom; na pasta de Downloads, não.
No Chrome: chrome://extensions → ligue Modo do desenvolvedor (canto superior direito) → Carregar sem compactação → escolha a pasta descompactada.
CONFIRME QUE CARREGOU: o cartão "FarejaLeads — WhatsApp no CRM" tem de aparecer na lista, sem um botão vermelho de Erros. Se não aparecer ou aparecer com erro, nada vai funcionar e os passos seguintes não adiantam — fale com a gente antes de continuar.
Ela não está na Chrome Web Store (isso exige conta de desenvolvedor paga e revisão da Google), então o Chrome vai avisar que você está com uma extensão em modo de desenvolvedor. É esperado.
Clique no ícone da extensão, leia o aviso de privacidade, cole o token e Conectar. Ela confere o token com o FarejaLeads e mostra o nome do site — se mostrar o site errado, você colou o token de outro.
Abra o web.whatsapp.com na mesma janela do Chrome e deixe a aba aberta enquanto atende. Com o WhatsApp Web fechado, não há o que ler.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
5. Faça o seu checkout pedir o telefone (é isto que liga a conversa à venda)
ESTE PASSO É O QUE DECIDE SE VOCÊ VAI VER VENDA VINDA DO WHATSAPP. O que amarra a conversa à venda é o TELEFONE: a extensão sabe que houve conversa com um número, e o CRM precisa ver esse mesmo número em alguém que comprou.
No Stripe: ative a coleta de telefone no Checkout (Phone number collection). O FarejaLeads já lê o telefone de quem pagou e casa sozinho.
Nos seus formulários de cadastro e de contato, peça telefone junto com o e-mail. Vale também para importação de contatos por planilha.
Sem telefone em lugar nenhum, a conversa fica guardada como "sem pessoa ainda" e a venda continua aparecendo como direto — tudo o resto funcionando e você sem ver resultado.
Não precisa ser antes: quem conversou no mês passado e só se cadastrou hoje é casado na hora, com a data da CONVERSA. A atribuição não se perde por ordem.
6. Confira que chegou (no mesmo dia)
Em Leads → Chaves dos sites → WhatsApp, a tela lista as últimas conversas. Se aparecer telefone e data, a extensão está mandando. Ela envia no máximo uma vez por minuto, então espere um minuto com o WhatsApp Web aberto antes de concluir que não funcionou.
Conversa marcada "sem pessoa ainda" NÃO é erro: é número que o CRM ainda não conhece, esperando o passo 5. Conversa com nome ou e-mail do lado já está casada.
No popup da extensão você vê quantas estão na fila, o último envio e, se algo falhou, o motivo em português.
Para parar a qualquer momento: Desconectar no popup, ou apague o token no FarejaLeads (a extensão recebe 401, para de tentar e diz por quê).
7. Onde você acompanha as vendas
Anúncios → o seu produto → "Meta × CRM e de onde veio o dinheiro · 30 dias": o WhatsApp é uma fatia própria ali, separada de direto, social e busca. É a resposta para "quanto do meu faturamento passou pelo WhatsApp".
Na ficha da pessoa (Leads → CRM → a pessoa): a conversa vira um evento por dia e um toque de origem, na linha do tempo junto com visitas e pagamento. É onde você vê a história de uma venda específica.
A diferença entre os dois rótulos: "WhatsApp" é quem CHEGOU ao site por lá; "WhatsApp (conversa)" é conversa que de fato aconteceu, que só a extensão enxerga.
Primeiro toque × último toque: se a pessoa veio de um anúncio e só depois conversou, o anúncio continua levando o crédito do primeiro toque — a conversa não rouba a origem, ela entra na história no lugar certo pela data.
Não espere número no primeiro dia. O painel é de 30 dias e só conta venda de gente com telefone casado: o volume aparece conforme o passo 5 for pegando.
Regras que valem sempre
- O QUE SAI DA MÁQUINA: só o telefone do outro lado, quantas mensagens de cada lado (contagem grossa) e as datas. Nunca o texto da mensagem, foto, áudio, documento, nome do contato nem prévia da conversa. O servidor valida com schema estrito: campo a mais é recusado com o motivo, não aceito em silêncio.
- Grupo não entra: um @g.us não tem telefone e é descartado.
- A extensão não clica, não rola a tela e não abre conversa. Ela lê a lista que já está na tela e nada mais.
- ELA NÃO CRIA PESSOA NO CRM. Número que o CRM ainda não conhece tem a conversa guardada sem dono, e ela entra na pessoa no dia em que esse telefone se identificar no seu site (cadastro, checkout ou importação) — com a data da conversa, não a do dia em que casou. Então sua mãe e seu dentista não viram contato do CRM, e a venda de quem conversou antes de se cadastrar continua sendo atribuída ao WhatsApp.
- O preço disso: enquanto a pessoa não se identifica, a conversa aparece na lista de conversas do site, mas não na ficha de ninguém. Se você quer todo número no CRM, importe seus contatos por Leads → importar, que é o caminho em que você escolhe quem entra.
- O WhatsApp Web muda o HTML sem avisar, e quando muda a extensão para de reconhecer as conversas. Ela não quebra a página nem fica tentando: avisa uma vez por aba. Os seletores ficam todos num arquivo só (seletores.js) justamente para o conserto ser rápido.
- O contato que entra só por conversa não vira público de anúncio: o telefone fica na coluna da pessoa e o envio para a Meta não o usa como identificador.
- O número gerenciado da Twilio, se você contratou, continua servindo para ENVIAR. Esta extensão é a outra ponta, a de saber que houve conversa, e as duas convivem.