Como enviar as vendas do CRM ao Meta Ads

Com a integração do Meta Ads, cada pedido que fica Pago no CRM é enviado ao Meta como uma conversão de compra (evento Purchase). Assim, as campanhas do Facebook e do Instagram aprendem quem de fato se matriculou, e não só quem preencheu o formulário.

O envio é feito pelo servidor (API de Conversões do Meta) e leva:

• o valor do pedido, já com o desconto aprovado;
• a data do pagamento;
• os dados de rastreamento guardados no lead (clique do anúncio e cookies do Meta, quando o site os capturou);
• o e-mail, o telefone, o nome e a cidade do aluno, criptografados antes do envio.

Antes de começar

• Acesso ao Gerenciador de Eventos do Meta (https://business.facebook.com/events_manager), na conta da sua instituição.
• O Pixel ID (também chamado de ID do conjunto de dados): só números, aparece no Gerenciador de Eventos.
• Um Access Token da API de Conversões. No Gerenciador de Eventos, abra o pixel → Configurações → API de Conversões → Gerar token de acesso. Copie e guarde: o Meta mostra o token uma vez só.
• Normalmente essas informações estão com o gestor de tráfego ou com a agência.

Quem pode fazer

Só o Administrador do CRM. O gestor de tráfego passa o Pixel ID e o token ao administrador.

Passo a passo

1. Acesse Configurações → Integrações e abra a aba Meta Ads.
2. Clique em Adicionar Meta Ads.
3. Preencha:
   • Pixel ID (obrigatório);
   • Access Token (obrigatório no cadastro);
   • Test Event Code (opcional): deixe em branco na integração de uso diário (veja "Dúvidas comuns").
4. Em Times com acesso, escolha os times que usam este pixel. Deixe em branco para valer para a empresa toda.
5. Marque Ativa e Padrão.
6. Clique em Adicionar. A mensagem "Integração Meta Ads criada com sucesso." confirma.
7. Na lista, clique no botão Testar envio (ícone de play) da integração.

Para entender como os times e a opção Padrão escolhem a integração de cada venda, veja Qual integração recebe cada venda.

Como conferir se funcionou

• O Testar envio mostra "Teste concluído com sucesso." quando o Meta aceita o Access Token. Ele confere o token, mas não envia uma venda.
• A confirmação real vem com o primeiro pedido pago depois do cadastro: ele aparece como Enviado na aba Logs de Conversão (veja Como conferir se as vendas chegaram).
• No Gerenciador de Eventos do Meta, o evento Purchase passa a aparecer com a origem "Servidor".

Problemas comuns

O que aparece	Causa provável	Como resolver
"Teste falhou. Verifique as credenciais."	Access Token inválido, expirado ou de outro usuário sem acesso ao pixel	Gere um token novo no Gerenciador de Eventos e troque na integração (botão Editar)
"Pixel ID é obrigatório."	Campo vazio	Preencha só os números do Pixel ID
Venda com Falhou nos logs	O Meta recusou o envio (token revogado, pixel errado ou venda antiga demais)	Abra o envio nos logs e leia o Erro. Corrija e peça o reenvio ao suporte
Nenhuma venda aparece nos logs	Integração desativada, ou ligada só a times que não são o time do lead	Marque Ativa e confira os Times com acesso
As vendas aparecem só em "Testar eventos" no Meta	A integração está com um Test Event Code	Veja a primeira dúvida abaixo

Dúvidas comuns

Para que serve o Test Event Code? Ele faz o Meta mostrar os envios na aba Testar eventos do Gerenciador de Eventos. Enquanto ele estiver na integração, todas as vendas vão como teste. Use só durante a implantação. Para tirar o código depois, exclua a integração e cadastre de novo sem ele.

O CRM envia o evento de Lead ao Meta? Não. O CRM envia só a compra (pedido pago). O lead continua sendo medido pelo pixel do site ou da landing page.

Ao editar, os campos de token aparecem vazios. Perdi o token? Não. O Access Token não volta para a tela depois de salvo. Deixe o campo em branco para manter o atual e preencha só se for trocar.

Até quando uma venda pode ser enviada ao Meta? O Meta aceita vendas de até 7 dias. Se um envio falhou, corrija a integração logo e peça o reenvio ao suporte dentro desse prazo.

Pedido de valor zero é enviado? Não. Ele aparece como Ignorado nos logs.