Como enviar as vendas do CRM para a Meta com a API de Conversões (HubSpot, Pipedrive, Kommo, Zapier)
Na maioria dos negócios de geração de leads, os anúncios da Meta otimizam para a coisa errada. A Meta vê formulários enviados. Não vê quem atendeu o telefone, quem foi à reunião ou quem pagou. Então continua encontrando mais gente que preenche formulário — e não mais gente que compra.
Enviar as etapas do CRM para a Meta pela API de Conversões resolve isso. Este artigo mostra o que você precisa, como funciona a correspondência e os jeitos práticos de conectar o seu CRM.
O que muda quando a Meta vê os dados do CRM
- Otimização: você pode otimizar as campanhas para reuniões agendadas ou negócios pagos, em vez de leads brutos.
- Relatórios: o Gerenciador de Anúncios mostra compras e receita por campanha e por anúncio, e você calcula o ROAS real — não o "custo por formulário".
- Controle de qualidade: enviar os resultados negativos (spam, não atende, desqualificado) mostra quais campanhas trazem lixo.
Como a Meta liga um negócio do CRM a um clique no anúncio
A Meta não conhece o ID do negócio no seu CRM. Ela liga eventos a pessoas usando identificadores. Quanto mais você enviar, melhor:
- E-mail e telefone (com hash SHA-256 antes do envio) — os mais importantes.
- Identificador de clique — o
fbcliddo link do anúncio, enviado comofbc. Ele liga o negócio ao clique exato. - Identificador do navegador — o cookie
_fbp. - Nome, cidade, país e o seu próprio
external_id— sinais extras. - Lead ID — se o lead veio de um formulário instantâneo da Meta, o
lead_idliga o negócio diretamente àquele envio.
O detalhe: o identificador de clique só existe no navegador no momento da visita. Se o formulário não salvar, ele se perde. Por isso as integrações com CRM funcionam melhor junto com um pequeno script no site, que guarda o fbclid e os cookies em campos ocultos do formulário e passa tudo para o CRM.
A regra que derruba a maioria das configurações caseiras: 7 dias
A Meta só aceita um evento se o event_time dele tiver no máximo 7 dias no momento do envio. Se um único evento do lote for mais antigo, a requisição inteira é rejeitada.
Então não dá para exportar as vendas do mês passado do CRM e subir. Você precisa enviar cada evento quando o negócio chega à etapa — com o horário da mudança. Um negócio que fecha 40 dias depois do clique não é problema; o que importa é informá-lo em até 7 dias depois do fechamento.
Quais etapas enviar
| Etapa do CRM | Evento |
|---|---|
| Lead novo | Lead (pule se o pixel já envia pelo formulário) |
| Reunião / consulta agendada | Schedule |
| Contrato / proposta enviada | InitiateCheckout (opcional) |
| Pago | Purchase + value + currency |
| Spam / não atende / desqualificado | Eventos personalizados, para relatórios |
Use nomes de evento diferentes dos que o pixel envia, a não ser que você desduplique de propósito com um event_id compartilhado. Mais em API de Conversões vs Pixel da Meta.
Formas de conectar o seu CRM
Recursos nativos do CRM
Alguns CRMs têm sincronização própria com a Meta em certos planos — o HubSpot, por exemplo, consegue sincronizar etapas do ciclo de vida como eventos de conversão de anúncios. Se o seu tem e cobre as etapas e os campos de que você precisa, comece por aí. Confira se ele envia identificadores de clique e valores dos negócios, e se respeita a regra dos 7 dias.
Zapier ou Make
Os dois têm módulos para a API de Conversões da Meta. Você monta um cenário: "quando um negócio for para a etapa X → enviar o evento Y". Funciona, mas o hash, os formatos dos campos, a desduplicação e os erros ficam por sua conta, e cada etapa nova é mais um cenário para manter. Serve para um funil simples.
Uma integração dedicada
O LeadMe foi feito exatamente para isso. Você conecta o CRM — Kommo (AmoCRM), Bitrix24, HubSpot, Pipedrive, Google Planilhas — ou qualquer outro sistema via webhook, Make ou Zapier, e marca quais etapas viram quais eventos. O LeadMe:
- normaliza e aplica hash ao e-mail e ao telefone;
- mantém os identificadores de clique capturados pelo script do site ou pelo plugin para WordPress;
- envia o
lead_iddos leads vindos de formulários instantâneos da Meta; - envia cada evento assim que a etapa muda, dentro da janela de 7 dias;
- envia os mesmos dados do CRM para TikTok, Google Ads e outras plataformas, se você também anuncia lá.
Ele também tem um relatório de "vendas por criativo", para você ver quais anúncios trouxeram clientes pagantes, e não só leads.
Código próprio
O seu desenvolvedor escuta os webhooks do CRM e chama a API de Conversões. Controle máximo, mas planeje a manutenção: novas versões da API, novas tentativas, renovação de tokens.
Checklist antes de trocar a otimização das campanhas
- Os eventos do CRM chegam ao Gerenciador de Eventos com origem Servidor.
- A qualidade da correspondência de eventos está em "OK" ou melhor.
- Há volume suficiente: o aprendizado da Meta funciona melhor com dezenas de conversões por semana em cada conjunto de anúncios. Se
Purchasefor raro, otimize primeiro paraSchedule. - Os eventos
Purchaselevam o valor do negócio, para o ROAS aparecer no Gerenciador de Anúncios.
Respostas rápidas
É a mesma coisa que as "conversões offline" da Meta?
É a versão moderna. Hoje a Meta recomenda a API de Conversões para eventos offline e de CRM; a antiga API de Conversões Offline é o caminho legado.
Meu CRM não aparece em nenhuma lista de integrações. Ainda dá?
Sim, se ele enviar webhook ou exportar para o Google Planilhas. Quase todo CRM faz uma das duas coisas.
E se o cliente usou um e-mail diferente do da conta do Facebook?
Por isso você envia vários identificadores. Telefone e identificador de clique muitas vezes batem mesmo quando o e-mail não bate.
Relacionados: O que é a API de Conversões da Meta · Configurar a API de Conversões sem programador · API de Conversões para WhatsApp