Clienx CRM Logo
API de Conversões Oficial da Meta (CAPI)

Rastreie Vendas do WhatsApp no Meta Ads e Treine o Algoritmo com Receita Real

Elimine o ponto cego entre seus anúncios do Meta Ads e o fechamento no WhatsApp. Rastreie vendas vindas de anúncios Click-to-WhatsApp (via ctwa_clid), formulários nativos (Meta Lead Ads com lead_id) e landing pages ou sites (via Correspondência Avançada SHA-256). Envie conversões de Venda Ganha em R$ diretamente de servidor para servidor via CAPI oficial.

Sem necessidade de cartão Setup em menos de 2 minutos Homologado junto à Meta

Pixel de Mensagens Meta

Status: Conexão CAPI Ativa

Tempo Real
1
LeadSubmitted
Primeira mensagem enviada no WhatsApp
ctwa_clid salvo
2
InitiateCheckout
Proposta comercial ou link gerado
Em negociação
3
Purchase (Venda Ganha)
Disparo CAPI com valor em R$
R$ 2.450,00
O valor fechado no Kanban alimenta o algoritmo do Meta Ads para otimizar ROAS e reduzir o custo por aquisição.
CONTRASTE DE ARQUITETURA

Por que links de redirecionamento queimam o seu orçamento de tráfego

Muitas ferramentas de mercado prometem rastreamento, mas usam uma tecnologia arcaica que prejudica suas campanhas. Veja a comparação direta:

Ferramentas de Rastreio Comuns Pixel Web Lento
  • Fuga de 30% a 40% dos leads: O usuário clica no anúncio e fica preso em uma página intermediária em branco esperando carregar.
  • Bloqueio no iOS e Navegadores: O Safari e bloqueadores de anúncios barram os cookies e o disparo do pixel web.
  • Cobrança de mensalidade adicional: Exigem pagamentos extras de R$ 100 a R$ 250 por mês apenas para intermediar o clique.
  • Sem visão do vendedor: O atendente não sabe qual criativo gerou a conversa no momento em que responde.
Resultado: Custo por lead alto e descarte massivo de pessoas interessadas.
Tecnologia Nativa ClienX CRM API Oficial Meta (CAPI)
  • Abertura Imediata no WhatsApp: O lead clica no anúncio e abre o aplicativo em menos de 1 segundo sem páginas intermediárias.
  • Conexão de Servidor para Servidor: A mensuração não depende de cookies do navegador e possui 100% de blindagem contra bloqueadores.
  • Incluso em todos os planos: Sem cobranças surpresa e sem limites abusivos de conversão no seu painel.
  • Inteligência no Chat: O vendedor vê a campanha, anúncio e valor estimado antes mesmo de enviar o primeiro oi.
Resultado: 100% dos cliques aproveitados e algoritmo treinado para buscar receita real.
COBERTURA TOTAL DE TRÁFEGO

3 Origens no Meta Ads Rastreadas com Precisão de Servidor

Não importa por onde o lead entra na sua empresa, o ClienX CRM unifica o atendimento no WhatsApp e retroalimenta o algoritmo da Meta com a venda fechada.

Direto no App

Anúncios Click-to-WhatsApp (CTWA)

O lead clica no anúncio do feed ou stories e abre o WhatsApp instantaneamente. O ClienX captura o parâmetro oficial ctwa_clid na primeira mensagem sem perda de cliques.

  • Zero links intermediários ou redirecionadores lentos
  • Vínculo nativo ao Pixel de Mensagens (Messaging Dataset)
  • Disparo automático do evento LeadSubmitted
Ideal para campanhas de mensagens diretas
Alta Qualificação
Meta Lead Ads

Formulários Nativos do Facebook e Instagram

Integração via Webhook oficial em menos de 5 segundos. O lead preenche o formulário nativo sem sair da rede social, entra no Funil Kanban com o lead_id oficial de 16 dígitos e é atendido imediatamente pela equipe no WhatsApp.

  • Captura imediata de nome, telefone, e-mail e respostas personalizadas
  • Sincronização de etapas com lead_stage na Conversions API da Meta
  • Ativação da Otimização de Leads de Conversão (Conversion Leads)
  • Disparo de Purchase com lead_id quando a venda fecha no WhatsApp
Reduz o custo por venda em até 23% segundo dados oficiais da Meta
Web & Sites

Landing Pages e Formulários em Sites Externos

Capture contatos em páginas de vendas WordPress, Elementor, Framer ou formulários institucionais. Preservamos as UTMs de campanha e associamos a conversa do WhatsApp ao lead que converteu no site.

  • Correspondência Avançada oficial da Meta (Advanced Matching)
  • Criptografia SHA-256 de telefone com DDI (ph), e-mail (em) e nome (fn, ln)
  • Rastreamento geográfico: envio de cidade (ct), estado (st) e país (country)
  • Captura de fbc, fbp e parâmetros UTM (source, medium, campaign)
  • Disparo via CAPI de servidor para servidor quando a venda fecha
Perfeito para funis híbridos: captura no site e fechamento no WhatsApp

Como funciona o rastreamento em Formulários Nativos

Conversion Leads

O maior problema das campanhas de Lead Ads é receber cadastros desqualificados de quem clicou no formulário por engano. O ClienX CRM resolve isso conectando a venda fechada no WhatsApp de volta à Meta:

1

Preenchimento Nativo e Webhook Instantâneo

O usuário preenche o Instant Form no feed ou stories. O Webhook oficial da Meta entrega nome, telefone, e-mail e o identificador único lead_id no ClienX CRM em milissegundos.

2

Atendimento no WhatsApp e Qualificação (lead_stage)

O contato entra no Kanban e a equipe inicia a conversa no WhatsApp. Conforme o card avança de coluna, o ClienX envia o status de maturação (lead_stage: "Contacted" ou "Qualified") para a Meta.

3

Venda Ganha e Disparo de Purchase com lead_id

Ao fechar a venda no WhatsApp, o card vai para Venda Ganha. O ClienX dispara o evento Purchase via CAPI vinculando o lead_id e o valor exato em R$, ensinando o algoritmo a priorizar compradores reais.

Tecnologia: Webhook Graph API v26.0 Zero perda de leads

Como funciona o rastreamento de Landing Pages e Sites

Advanced Matching

Muitas empresas preferem filtrar clientes em páginas de vendas antes de atender no WhatsApp. O ClienX preserva a trilha completa de tráfego do clique original até a compra:

1

Clique no Anúncio e Captura na Landing Page

O visitante clica no anúncio do Meta Ads e acessa seu site ou landing page. O formulário (WordPress, Elementor, Framer ou formulários nativos do site) coleta nome, WhatsApp, e-mail, cidade, estado e país, preservando as UTMs de campanha e identificadores de navegador (fbp e fbc).

2

Entrada Unificada no WhatsApp e Kanban

O lead é integrado ao ClienX CRM. O atendente vê na tela exatamente de qual campanha, anúncio e cidade o lead veio antes de iniciar a conversa no WhatsApp, com todo o contexto preservado.

3

Fechamento no WhatsApp e Disparo CAPI com SHA-256

Quando a negociação é fechada, o ClienX dispara o evento Purchase via Conversions API utilizando Correspondência Avançada (hash SHA-256 de telefone com DDI, e-mail, nome, cidade ct, estado st e país country). A Meta cruza os dados com o clique que levou ao site e atribui o ROAS à campanha com pontuação máxima de Event Match Quality.

Correspondência Avançada SHA-256 (Contato + Cidade, Estado e País) 100% em conformidade com a LGPD
ESPECIFICAÇÃO DE MENSAGENS E CAPI

Eventos Oficiais Enviados para o Pixel de Mensagens

A Meta homologou eventos estritos para mensageria comercial e conversões de CRM. O ClienX CRM implementa a taxonomia oficial recomendada pela documentação de desenvolvedor:

LeadSubmitted Recepção

Primeiro Contato no WhatsApp

Disparado na primeira mensagem do usuário no WhatsApp vinda do anúncio. Registra o ctwa_clid para estabelecer a janela de atribuição determinística da Meta.

action_source: business_messaging
LeadQualified Qualificação

Lead Qualificado no Atendimento

Disparado quando o atendente ou bot valida o perfil do contato (ex: orçamento confirmado, perfil ideal). Sinaliza à Meta para buscar contatos com real intenção de compra.

user_data: ctwa_clid, ph, em
InitiateCheckout Proposta

Proposta ou Link de Checkout

Disparado quando a proposta comercial, orçamento formal ou link de pagamento é enviado na conversa. Alimenta a inteligência de intenção avançada de compra.

custom_data: value, currency: BRL
Principal
Purchase Venda Ganha

Receita Fechada no Kanban

Disparado instantaneamente ao mover para Venda Ganha. Envia o valor em R$, moeda BRL, order_id e dados criptografados, treinando o algoritmo para otimizar ROAS.

value: 2450.00, currency: BRL
Lead + lead_stage Formulário

Estágio de Formulários Nativos

Utilizado para campanhas de Meta Lead Ads. Conforme o lead avança nas etapas do Kanban, o CRM envia o status de maturação, ativando a Otimização de Leads de Conversão.

user_data: lead_id, lead_stage
AppointmentBooked Reunião

Reunião ou Consulta Agendada

Disparado quando uma reunião de demonstração, consulta ou visita é agendada e sincronizada com o Google Calendar. Essencial para vendas consultivas de alto ticket.

data/hora e agenda vinculada
ViewContent / AddToCart Catálogo

Interação com Catálogo

Rastreia produtos visualizados ou itens selecionados a partir do catálogo oficial do WhatsApp nas negociações de varejo, atacado e comércio conversacional.

content_ids, content_type
LeadConverted Conversão

Conversão Intermediária de Funil

Utilizado para registrar marcos decisivos no funil (ex: assinatura de contrato, aprovação de crédito) antes da liquidação financeira definitiva.

action_source: business_messaging

Tabela Resumo dos Eventos Enviados ao Pixel de Mensagens e CAPI

Mapeamento estrito em conformidade com as diretrizes da Meta Graph API v26.0

Taxonomia Oficial Homologada
Evento Oficial Origem do Lead Gatilho no ClienX CRM Parâmetros Enviados Benefício no Meta Ads
LeadSubmitted Click-to-WhatsApp (CTWA) Primeira mensagem recebida ctwa_clid, ph (hash) Abre janela de atribuição de 72h a 7 dias
LeadQualified CTWA ou Web Forms Card movido para Qualificado ctwa_clid, ph, em, ct, st Filtra contatos com real poder de compra
InitiateCheckout CTWA / Lead Ads / Web Proposta ou link enviado no chat value estimado, currency: BRL Alimenta o público de alta intenção comercial
Purchase Todas (CTWA, Lead Ads, Sites) Card movido para Venda Ganha value em R$, currency: BRL, order_id, user_data (ph, em, ct, st, country) Otimiza ROAS real e Lances baseados em Valor
Lead (lead_stage) Formulários Nativos (Lead Ads) Avanço de etapas no Kanban lead_id, lead_stage, crm Reduz o custo por venda em até 23% (Conversion Leads)
AppointmentBooked CTWA / Lead Ads Agendamento Google Calendar ctwa_clid / lead_id, timestamp Treina o algoritmo para gerar reuniões qualificadas
O que diz a Documentação Oficial da Meta (Meta for Developers)
Graph API v26.0 · Conversions API for Business Messaging
Validação Estrita de Eventos

A Meta rejeita eventos com nomes customizados sob business_messaging (subcódigo de erro 2804066). O ClienX implementa estritamente os eventos homologados pela documentação oficial.

Conversion Leads Optimization

Dados divulgados no Meta Business Help Center comprovam redução média de até 23% no Custo por Venda ao enviar os estágios de maturação de formulários nativos do CRM de volta à Meta.

Advanced Matching (SHA-256)

Telefone, e-mail, nome, cidade (ct), estado (st) e país (country) passam por criptografia irreversível SHA-256 antes da transmissão, garantindo pontuação máxima de Event Match Quality na Meta e conformidade com a LGPD.

Janela de Atribuição

O ctwa_clid mantém a janela de atribuição determinística da Meta ativa por 72 horas para cliques diretos no WhatsApp e até 7 dias para conversões offline pós-contato.

PASSO A PASSO

Como funciona a integração da CAPI na prática

Em três passos simples, sua operação ganha inteligência de ponta a ponta sem necessidade de programadores.

01

Conecte sua Conta Meta

Faça o login oficial da Meta no painel do ClienX CRM e selecione o Pixel de Mensagens da sua empresa em poucos cliques.

Conexão oficial homologada
02

Atenda com Histórico de Origem

Quando o cliente enviar mensagem, o CRM captura o ctwa_clid e exibe na tela qual anúncio e oferta chamou a atenção daquele contato.

Disparo de LeadSubmitted
03

Feche no Kanban e Envie a Venda

Arraste o cartão para Venda Ganha informando o valor recebido. O ClienX dispara o evento Purchase de volta para a Meta instantaneamente.

Otimização de ROAS no leilão
Perguntas Frequentes

Dúvidas sobre o Rastreamento Meta Ads no ClienX CRM

Respostas diretas sobre tecnologia, eventos e período de teste.

O rastreamento funciona tanto no WhatsApp Oficial quanto no Não Oficial?
Sim. O rastreamento funciona perfeitamente tanto com a API Oficial quanto com a API Não Oficial do WhatsApp. Em ambos os modelos de conexão, o ClienX CRM captura os parâmetros de anúncio (ctwa_clid para Click-to-WhatsApp, lead_id para formulários nativos ou parâmetros UTM para landing pages) e dispara os eventos de conversão de vendas de servidor para servidor diretamente para a API de Conversões da Meta (CAPI).
O ClienX CRM rastreia vendas vindas de formulários nativos (Meta Lead Ads)?
Sim. O ClienX CRM possui integração direta via Webhook oficial com o Meta Lead Ads. No instante em que o lead submete o formulário instantâneo no Instagram ou Facebook, o CRM captura o contato com o identificador único lead_id. Conforme o vendedor avança o lead no Kanban e finaliza o pedido pelo WhatsApp, o ClienX envia os eventos de qualificação com lead_stage e a conversão de Purchase com a receita em R$. Isso ativa a Otimização de Leads de Conversão (Conversion Leads) da Meta, reduzindo o custo por venda em até 23% e filtrando contatos desqualificados.
Como funciona o rastreamento para quem veio de landing pages ou sites externos e comprou no WhatsApp?
Muitas empresas captam leads em sites WordPress, Elementor, Framer ou formulários web e finalizam a negociação pelo WhatsApp. Quando o lead preenche seu formulário externo, o ClienX preserva as UTMs de campanha, identificadores de clique da Meta (fbp e fbc) e dados de localização como cidade, estado e país. Quando o atendente fecha o negócio no WhatsApp e marca o card como Venda Ganha, o ClienX dispara o evento Purchase via Conversions API utilizando Correspondência Avançada (Advanced Matching) com hash criptográfico SHA-256 de telefone com DDI, e-mail, nome, cidade (ct), estado (st) e país (country). A Meta correlaciona determinísticamente a compra ao anúncio que gerou a visita na landing page, calculando o ROAS exato.
Quais eventos oficiais o ClienX CRM envia para o Pixel de Mensagens?
O ClienX segue 100% da taxonomia oficial da Meta para o canal de mensagens (action_source: "business_messaging"). Os eventos homologados enviados incluem: LeadSubmitted (primeira mensagem/contato), LeadQualified (qualificação comercial), InitiateCheckout (envio de proposta ou link), Purchase (venda concluída em R$ com order_id), AppointmentBooked (reuniões via Google Calendar), Lead com lead_stage (para formulários nativos), ViewContent e AddToCart (interações com catálogo de produtos) e LeadConverted.
O que acontece se uma ferramenta enviar nomes de eventos inventados para a Meta?
A documentação de desenvolvedor da Meta rejeita eventos customizados ou com ortografia incorreta sob o canal de Business Messaging com o Erro 2804066: Invalid event type for messaging event. O ClienX CRM foi projetado sob as regras oficiais da Graph API v26.0, garantindo que 100% dos eventos sejam aceitos e computados no Gerenciador de Eventos da Meta com pontuação máxima de Event Quality Match.
Preciso de conhecimento técnico ou programador para configurar a CAPI?
Não. A integração é realizada através do fluxo de login oficial da Meta. Você apenas clica em conectar, concede permissão ao seu gerenciador de negócios e escolhe o Pixel de Mensagens. O sistema cuida de toda a comunicação de servidor para servidor automaticamente.
Há custo extra por evento enviado para a Meta?
Não. Diferente de outros softwares que cobram R$ 150 a R$ 250 adicionais por mês para liberar o rastreamento, no ClienX CRM a API de Conversões está 100% inclusa nos planos sem custos adicionais por evento.
Posso testar gratuitamente antes de contratar?
Sim. Você tem 7 dias de acesso completo a todos os recursos da plataforma, incluindo a CAPI do Meta Ads, sem precisar cadastrar cartão de crédito.
PARE DE ANUNCIAR NO ESCURO

Pronto para transformar o WhatsApp da sua empresa em uma máquina de vendas mensurável?

Crie sua conta em menos de 2 minutos. Conecte sua campanha do Meta Ads e teste todos os recursos por 7 dias grátis sem cartão.

Testar 7 Dias Grátis
Não pede cartão Ativação em 2 minutos Atendentes ilimitados