Como configurar o rastreamento de leads no WhatsApp

O que permite identificar a origem do lead

O vínculo começa em uma informação recebida: a referência do anúncio na mensagem do WhatsApp ou o código de um link rastreável enviado pelo contato. O Wordy associa essa evidência à conversa e ao contato. A conexão com a Meta permite consultar os detalhes dos anúncios que sua empresa está autorizada a acessar.

Quando esses dados estão disponíveis, a jornada reúne campanha, conjunto, anúncio, criativo e novas entradas do mesmo contato. O relatório relaciona essas origens à qualificação atual e às compras registradas no CRM.

Antes de começar

• Tenha o CRM Wordy disponível no plano da empresa e permissão para acessá-lo.
• Use um perfil com permissão de administrador para configurar contas, criar links ou alterar o rastreamento. A consulta também respeita as permissões do CRM e dos contatos.
• Conecte ao WordChats o WhatsApp que receberá as mensagens. Pode ser a WhatsApp Cloud API ou uma conexão por QR Code.
• Para consultar os detalhes na Meta, tenha acesso à conta de anúncios correta e autorize a leitura de anúncios, com a permissão ads_read.
• Se o anúncio passa por um site, tenha acesso à edição dessa página ou a alguém que possa instalar o código gerado.

Não envie senha da Meta, token ou código de autorização no chat do copiloto. A autorização é feita na janela oficial de login.

Configure a Meta e verifique o WhatsApp

1. Abra o CRM Wordy e entre em Origem dos leads. Essa área reúne as visualizações Resultados e Contatos. Clique em Configurar rastreamento.
2. Na aba Contas da Meta, clique em Conectar com a Meta. Entre na conta que tem acesso aos anúncios da empresa e conclua a autorização apresentada.
3. Selecione as contas de anúncios. Confira o nome e o ID de cada conta e clique em Conectar contas selecionadas. Aguarde a confirmação do WordChats.
4. Abra a aba WhatsApp. Selecione a conexão em Verificar WhatsApp e confira o diagnóstico. O número deve ser o mesmo que recebe as mensagens do anúncio.
5. Faça um teste completo. Abra o caminho usado pelo anúncio com um contato de teste, envie a mensagem e procure esse contato em Contatos. Confira a origem e os detalhes na jornada.

A opção de conectar com token é avançada. Prefira o login guiado quando ele estiver disponível. O diagnóstico indica quando é necessário rever acesso, autorização ou conexão.

Quando o anúncio abre a conversa diretamente

Para anúncios da Meta que levam diretamente ao WhatsApp, configure na Meta o número já conectado ao WordChats como destino. No assistente Criar link, a opção Anúncio da Meta que abre uma conversa diretamente explica esse caminho.

Nesse caso, o Wordy aproveita a referência que o WhatsApp entregar na mensagem. Isso pode ocorrer pela Cloud API ou pela conexão por QR Code, mas a disponibilidade depende da mensagem e da integração. O teste pelo anúncio é necessário para verificar o seu caso.

Se a referência contém um ID de anúncio e a conta autorizada permite consultá-lo, o Wordy pode completar os dados de campanha, conjunto e criativo. Uma referência recebida pode continuar parcialmente identificada quando faltam detalhes ou acesso à conta correspondente.

Crie um link rastreável com UTMs

Esse caminho atende links usados em anúncios, sites, bio e outras fontes. O assistente separa a criação em Caminho → Detalhes → Pronto.

1. Clique em Criar link. Selecione Link no anúncio, site ou outra origem.
2. Escolha onde vai usar. Para um anúncio da Meta com parâmetros dinâmicos, selecione Anúncio da Meta · IDs preenchidos no clique. Para uma bio, parceiro ou fonte definida por você, escolha a identificação fixa.
3. Preencha os detalhes. Dê um nome ao link, selecione a conexão de WhatsApp e escreva a mensagem inicial. Os campos avançados permitem informar dados de origem quando necessário.
4. Copie o link rastreável completo. Use o endereço gerado no local escolhido. Preserve os parâmetros e os campos dinâmicos fornecidos pelo assistente.
5. Envie uma mensagem de teste. O código precisa permanecer na mensagem enviada. Depois, verifique a jornada do contato no CRM.

UTMs descrevem a origem e a campanha de um acesso. Elas ajudam a transportar o contexto até a conversa, mas não identificam o contato por conta própria. No caminho por link, o código que chega na mensagem faz essa ligação.

Configure anúncio → site → WhatsApp

1. No assistente de link, escolha Anúncio da Meta → meu site → WhatsApp. Informe o endereço da página e selecione a conexão de destino.
2. Conclua a criação e copie o código para instalar nas páginas. Instale-o nas páginas utilizadas no caminho até o WhatsApp, conforme a orientação exibida no assistente.
3. Use o endereço do site gerado para o anúncio Meta. Ele contém os parâmetros necessários para transportar o contexto de campanha e anúncio.
4. Troque o destino do botão de WhatsApp pelo link rastreável completo gerado no Wordy. O script preserva os parâmetros nesse link; não transforma automaticamente um botão comum com endereço wa.me. Redirecionamentos e páginas intermediárias também precisam preservar os parâmetros recebidos.
5. Teste o percurso inteiro. Clique pelo anúncio de teste, navegue como um visitante, abra o WhatsApp e envie a mensagem com o código. Só então confira a origem no Wordy.

Gerar o código no Wordy não o instala automaticamente em um site externo. Se a página remover os parâmetros, se o botão não usar o caminho configurado ou se o código for retirado da mensagem, o vínculo pode não acontecer.

Peça a configuração ao copiloto IA

O copiloto pode consultar o estado real do rastreamento, preparar a configuração, criar links e orientar a correção de pendências. Ele também consulta origens, jornadas e compras conforme as permissões do usuário.

• “Quero configurar o rastreamento dos meus anúncios para o WhatsApp.”
• “Meu anúncio passa pelo meu site antes do WhatsApp. Prepare esse rastreamento.”
• “Crie um link rastreável para a bio do Instagram nesta conexão de WhatsApp.”
• “Quais campanhas trouxeram contatos com compras registradas nos últimos 30 dias?”
• “Verifique por que este contato está sem origem.”

Quando precisar da Meta, o copiloto abre a configuração para você concluir o login e selecionar as contas. Preparar esse cartão não significa que a conta já está conectada. Também será necessário instalar no site o código gerado, quando esse for o caminho escolhido.

Para localizar um contato específico, informe o nome ou o ID conhecido. O copiloto consulta a evidência disponível; não inventa uma campanha para preencher uma origem desconhecida.

Confira a origem e a jornada de cada contato

1. Abra Contatos. Escolha o período e use a busca para localizar o contato ou a campanha.
2. Confira campanha, conjunto, anúncio e criativo. Alguns campos podem estar disponíveis antes de outros, conforme a evidência recebida e a consulta à Meta.
3. Veja a coluna Evidência. Ela distingue referência do WhatsApp, código de link e ausência de origem.
4. Abra a jornada do contato. Consulte a origem registrada, outras entradas, qualificação, compras e referências de conversa disponíveis.

Em Filtros, escolha Primeira origem ou Última origem conhecida. A escolha muda a leitura da atribuição; novas entradas não precisam apagar o primeiro vínculo registrado.

Criativo é o registro associado ao anúncio que a Meta disponibiliza. Em anúncios com combinações ou variações dinâmicas, isso não garante identificar a combinação exata de imagem, vídeo e texto exibida para uma pessoa.

Entenda os resultados e as compras por campanha

A visualização Resultados mostra compradores, compras e valores registrados por campanha ou origem. Use Ver compras para consultar os registros e as referências de conversa que sustentam o resultado.

• O período considera a data da compra. Não é necessário que o contato tenha enviado uma nova mensagem no mesmo período.
• A janela de atribuição é de 90 dias antes de cada compra. O modelo selecionado escolhe a primeira ou a última origem conhecida dentro dessa janela. Uma entrada posterior à compra não recebe essa atribuição.
• Cada compra recebe no máximo uma origem nesse relatório. Sem uma origem elegível na janela, ela fica sem atribuição.
• A qualificação é o estado atual do contato. Marcar alguém como quente ou cliente não cria uma compra no relatório.
• Valores são registros do CRM. Não comprovam pagamento recebido. Moedas ficam separadas, e compras sem valor ou com realização inferida são sinalizadas.

Abra Como calculamos no painel para conferir os critérios usados na consulta. Para entender melhor o restante do CRM, veja o Funcionário Inteligente Wordy.

Diagnóstico: quando a origem não aparece

A Meta informa “URL bloqueada”

Consulte o diagnóstico da conexão ou peça ao copiloto: “Qual é a URL de retorno exata usada no login de anúncios?”. O administrador do aplicativo Meta deve conferir o login OAuth do cliente e da Web e cadastrar esse endereço exato entre os redirecionamentos válidos do aplicativo correspondente.

Use o endereço de retorno efetivo informado pela configuração. Ele pode variar conforme o ambiente ou a marca. Não cadastre a URL temporária inteira da janela de autorização, com parâmetros de estado ou código. Depois da correção, inicie uma nova tentativa pelo WordChats.

A janela de login não abre

Permita pop-ups para o endereço do painel e clique novamente em Conectar com a Meta. Se o login guiado estiver indisponível, consulte a mensagem do diagnóstico antes de tentar outras configurações.

A conta está conectada, mas faltam nomes da campanha

Confira se foi autorizada a conta que contém aquele anúncio, se o usuário mantém acesso a ela e se a autorização de leitura continua válida. Atualize a consulta ou refaça a autorização quando o diagnóstico indicar. Ter uma referência não garante acesso a todos os detalhes.

O lead chegou por QR Code e aparece sem origem

Abra a jornada e verifique se a mensagem trouxe a referência do anúncio ou um código de link. A conexão por QR Code, por si só, não identifica a campanha. Sem essas evidências, o contato permanece sem origem; para próximas entradas, confira o caminho do anúncio e teste um link rastreável quando aplicável.

O link abre o WhatsApp, mas a campanha não aparece

Confira se o contato enviou a mensagem inicial com o código, se o link está ativo e se a conexão de destino é a correta. Para parâmetros dinâmicos, teste o clique real do anúncio. Em um site, revise a instalação e se os parâmetros chegam ao botão de WhatsApp.

Há conversas e clientes, mas nenhuma compra no resultado

Confira os registros de compra e o período selecionado. Conversa, qualificação e compra são informações distintas. Um cliente classificado no CRM não se torna automaticamente uma compra registrada por campanha.

Recupere referências do histórico disponível

Em Configurar rastreamento → WhatsApp, abra Histórico dos últimos 90 dias e use Recuperar histórico. A tarefa examina as mensagens já armazenadas no WordChats em busca de evidências que possam ser aproveitadas. Aguarde o estado de conclusão indicado no painel.

A recuperação não recria informações que nunca chegaram ou não foram armazenadas. Também não significa que todo contato antigo poderá ser vinculado a uma campanha.

São dois critérios diferentes: a recuperação examina o histórico disponível dos últimos 90 dias; a atribuição comercial considera os 90 dias anteriores à data de cada compra.

Ao desconectar uma conta de anúncios, o Wordy deixa de consultar novos detalhes por essa conexão. O histórico de origens já registrado é preservado.

Perguntas frequentes

Preciso fazer login com a Meta?

Para autorizar a consulta aos detalhes das contas de anúncios, use a conexão com a Meta. O vínculo inicial vem da referência recebida ou do código do link. O login enriquece os dados acessíveis; não substitui essa evidência.

Funciona com WhatsApp Cloud API e WhatsApp por QR Code?

O Wordy aproveita referências recebidas pelos dois caminhos e oferece links rastreáveis para ambos. A identificação depende dos dados que realmente chegam à mensagem e da configuração usada.

É possível identificar campanha, conjunto, anúncio e criativo?

Sim, quando a evidência e os dados da Meta ou da configuração do link permitem esse detalhamento. Campos sem informação permanecem incompletos. O criativo associado ao anúncio não garante a identificação de uma variação dinâmica exata.

Só colocar UTMs no site resolve?

Não. É preciso levar o contexto até a conversa. No caminho por site e link, o código gerado deve chegar na mensagem enviada para associar o acesso ao contato do WhatsApp.

O Wordy identifica 100% dos leads?

Não. Referências ausentes, parâmetros perdidos, códigos removidos ou falta de acesso aos anúncios podem limitar a identificação. O painel mostra o que tem evidência e o que continua sem origem.

Posso pedir ao copiloto para fazer tudo?

Você pode pedir diagnóstico, preparação da configuração, links e consultas. O login e a autorização da Meta são concluídos por você; alterações em um site externo precisam ser instaladas nesse site. O copiloto respeita as permissões da sua conta.

Próximos passos

Comece por um único caminho de anúncio e verifique uma mensagem completa. Quando a origem estiver comprovada, repita a configuração nos demais caminhos e acompanhe os contatos e as compras no CRM.

Outros guias: configuração da WhatsApp Cloud API, configuração do agente de IA e central de documentação.