Conectando o Meta (Facebook)

A integração com o Meta Conversions API (CAPI) está disponível. Depois de conectada, o True Conversions envia os marcos do CRM (lead qualificado, proposta, venda) direto para o dataset da Meta, server-side — funciona tanto no modo Jornada de conversão quanto no modo Otimização de valor.

O True Conversions envia eventos de conversão. Ele não cria, edita nem gerencia campanhas ou anúncios.


O que você precisa antes de começar

  • Uma conta Meta Business com acesso à conta de anúncios do anunciante.
  • Um Pixel / Dataset configurado no Gerenciador de Eventos.
  • Uma conta já criada no True Conversions.

Passo a passo

  1. Abra a conta (cliente) em Dashboard → Contas → [sua conta].
  2. Clique em Integrações de anúncios.
  3. Clique em Conectar Meta.
  4. Na tela da Meta (Login do Facebook para Empresas), autorize o negócio, a conta de anúncios e o dataset/pixel corretos. Confira os nomes antes de aprovar — é o que define para onde as conversões vão.
  5. Volte ao True Conversions. O status do card do Meta passa a Ativa.
  6. Informe (ou confirme) o Dataset / Pixel ID. Ele está no Gerenciador de Eventos; Pixel ID e Dataset ID são o mesmo identificador — a Meta unificou os dois termos.
  7. Só para conversões de mensagens vindas de anúncios de clique para WhatsApp: informe o ID da conta do WhatsApp Business (WABA). Você mesmo cola esse ID (Configurações do negócio → Contas → Contas do WhatsApp). O True Conversions nunca busca esse ID por API. Se você não anuncia clique para WhatsApp, deixe o campo em branco — os demais leads seguem normalmente.
  8. Clique em Salvar configuração.
  9. Configure o evento do Meta para as etapas relevantes do CRM:
    • Jornada de conversão: escolha o evento por etapa na página Jornada de conversão.
    • Otimização de valor: use a coluna Evento Meta na página de Otimização de valor.
  10. Verifique a entrega nos dois lados: em Eventos recentes no True Conversions (o envio aparece com status enviado) e no Gerenciador de Eventos da Meta, no dataset conectado.

O card "Saúde da conta"

Depois de conectar, a página de Integrações de anúncios mostra o card Saúde da conta — últimos 7 dias, com impressões, cliques, alcance, gasto e conversões da conta de anúncios conectada, além do nome e do ID dela.

Ele serve principalmente para confirmar qual conta foi conectada. Os números refletem os últimos 7 dias daquela conta: se não houve veiculação nesse período, zeros são um resultado válido — não indicam falha na conexão nem na integração.

O que é enviado

Depois de conectado, o True Conversions envia o PII com hash (SHA-256), o fbclid (se mapeado — veja Mapeamento de campos) e os detalhes da conversão (evento, timestamp e, quando aplicável, valor) via Conversions API. Isso melhora o Event Match Quality (EMQ) no Gerenciador de Eventos.

Para aproveitar melhor a integração, garanta que a tag GTM do True Conversions está instalada (veja Configuração e rastreamento) — ela captura fbclid além de gclid — e inclua email, telefone, nome e fbclid no mapeamento de campos da conta.

Anúncios de clique para WhatsApp

Conversões de conversas iniciadas por anúncios de clique para WhatsApp são enviadas à Meta pela API de Conversões. O fluxo é: a sua plataforma de atendimento repassa o ctwa_clid do clique no webhook da primeira mensagem → o True Conversions guarda esse identificador e o junta ao lead do CRM pelo telefone → quando o negócio avança, a conversão vai para a Meta com o ctwa_clid e o ID da WABA.

O que a sua operação precisa ter configurado:

  • Uma plataforma de atendimento/chatbot que repasse o ctwa_clid no webhook da primeira mensagem. O ManyChat tem esse caminho suportado; a Wati, até onde a documentação pública mostra, não expõe esse campo. Sem o ctwa_clid não há o que atribuir — confirme esse ponto na sua plataforma antes de configurar.
  • O ID da WABA preenchido no card do Meta.
  • O aplicativo WhatsApp Business comum, sem webhooks, não é suportado.

Para verificar, dispare uma conversa a partir de um anúncio real de clique para WhatsApp e acompanhe a captura no painel e o evento no Gerenciador de Eventos da Meta.

Problemas na conexão?

Veja Solução de problemas.