Conversões Meta: ensine o algoritmo
Envie de volta ao Meta quem virou cliente de verdade e faça os anúncios buscarem mais gente parecida.
O algoritmo do Meta otimiza para aquilo que ele consegue medir. Se ele só enxerga cliques, entrega cliques. A integração de Conversões Meta (a chamada CAPI, API de Conversões) faz o caminho de volta: quando alguém qualifica ou compra no seu CRM, o ScalaCRM avisa a conta de anúncios — e o algoritmo passa a buscar mais gente parecida com quem realmente vira cliente.
Tudo fica em Configurações → Integrações, no card Conversões Meta.
Como funciona no automático (anúncios clique-pra-WhatsApp)
Quando um lead chega pelo WhatsApp vindo de um anúncio clique-pra-WhatsApp (CTWA), a Meta manda junto um identificador do clique. O ScalaCRM guarda esse identificador no contato e, quando acontece algo importante — lead qualificado ou venda concluída — envia o evento de volta usando esse mesmo identificador.
Nesse caminho não há nada para configurar além do switch ligado no card: a conexão da API oficial do WhatsApp já faz o trabalho.
⚠️ A Página do anúncio precisa estar vinculada ao seu WhatsApp Business. A Meta só aceita o evento quando o clique veio de uma Página do Facebook ligada à mesma conta do WhatsApp que recebeu o lead. Se os anúncios rodam por outra Página, o card mostra "o anúncio que trouxe o lead é de uma Página que não está vinculada" — vincule a Página no Gerenciador de Negócios. Enquanto isso, se as conversões offline estiverem configuradas, o CRM manda o mesmo evento por elas, casando por telefone e e-mail.
Modo offline: leads que não chegaram pelo WhatsApp
E o lead que veio de Lead Ads ou de uma landing page? Ele não passa pela conexão do WhatsApp, então precisa de um caminho próprio — a seção Conversões offline do card:
- No Gerenciador de Eventos do Meta, abra o seu conjunto de dados (Pixel) → aba Configurações → seção do guia de integração de CRM → Gerar token de acesso. (O token gerado pelo caminho comum da API de Conversões é o mesmo e também funciona — mas pelo guia de CRM você já emenda o assistente de Conversion Leads, que é obrigatório para destravar a otimização.)
- Cole o ID do dataset e o token no card Conversões Meta. Cole só o token — ele começa com
EAA. Se você colar a URL inteira do endpoint, o CRM tira o token de dentro dela. - Ao salvar, o ScalaCRM manda um evento de teste para a Meta para conferir o token. Se a Meta recusar, o card avisa na hora e nada é salvo — assim a configuração nunca fica "pronta" sem funcionar.
O ScalaCRM não aparece na lista de parceiros da Meta?
É normal, e não é um problema. Quando você clica em Conectar seu CRM (ou em adicionar uma nova fonte de dados) no Gerenciador de Eventos, a Meta mostra uma lista de CRMs parceiros, e o ScalaCRM não está nela. A ligação é feita direto pela API de Conversões: em vez de escolher um parceiro, siga pela opção de configurar manualmente / pela API de Conversões, gere o token e cole no card, como descrito acima. Funciona do mesmo jeito, com o padrão oficial Conversion Leads.
Como saber se já está funcionando: o card Conversões Meta mostra quantos eventos a Meta aceitou nos últimos 30 dias. Se esse número está subindo, a integração está ligada, mesmo que o ScalaCRM não apareça em nenhuma lista dentro da Meta. Lá no Gerenciador de Eventos, os eventos aparecem no seu conjunto de dados como recebidos pela API de Conversões.
Com isso configurado, o ScalaCRM envia os eventos usando os dados do próprio contato (telefone, e-mail), e a Meta cruza com a base dela para atribuir a conversão ao anúncio certo.
E dá para fazer melhor que cruzar por telefone. Se o lead veio de uma landing page sua, mande junto o fbclid — o identificador que a Meta coloca na URL de quem chega de um anúncio. Com ele, a Meta não precisa adivinhar: ela sabe exatamente qual clique gerou aquele lead. Se veio do formulário nativo (Lead Ads), o equivalente é o leadgen_id, que é ainda mais forte. Os dois se enviam pela API de cadastro de leads — o CRM cuida da conversão para o formato que a Meta exige.
Em anúncios clique-pra-WhatsApp você não precisa de nada disso: a Meta manda o identificador próprio do clique junto com a primeira mensagem, e o CRM usa sozinho.
Conversion Leads: o padrão oficial de CRM da Meta
O modo offline segue o padrão Conversion Leads — a integração oficial de CRM da Meta. O ScalaCRM envia o funil completo do lead: Lead (automático, assim que o contato entra no CRM vindo de Lead Ads ou landing page), LeadSubmitted e QualifiedLead (etapas do funil) e Purchase (venda). Com esse histórico, você pode trocar a meta de desempenho das campanhas de cadastro de "mais leads" para Conversion Leads: a Meta para de buscar o lead mais barato e passa a buscar o lead com mais chance de virar venda.
Para ativar, conclua o assistente de Conversion Leads no Gerenciador de Eventos (aba Configurações do dataset): ele pede para mapear os estágios do funil que estão chegando — como o ScalaCRM já envia os quatro estágios acima, é só selecioná-los na ordem.
Qualidade de correspondência (EMQ)
A Meta dá uma nota de qualidade de correspondência (EMQ) para cada evento: quanto mais dados corretos você envia, mais fácil ela encontra a pessoa e atribui a conversão. O ScalaCRM já envia automaticamente o que tem do contato — telefone, e-mail, nome, sobrenome e país (tirado do código do telefone), sempre criptografados (hash) antes de sair do servidor, no formato exato que a Meta pede.
Duas coisas que aumentam a nota, em ordem de impacto:
- O identificador do clique (
fbclidda landing page,leadgen_iddo Lead Ads, ou o do clique-pra-WhatsApp, automático). É o que mais pesa: com ele a Meta encontra a pessoa direto, sem cruzar dado nenhum. - O e-mail preenchido no contato. Vale pedir o e-mail no atendimento.
💡 Dica: o card mostra, nos últimos 30 dias, quantos eventos a Meta aceitou, quantos estão na fila, quantos falharam e quantos expiraram — com links diretos para os conjuntos de dados no Gerenciador de Eventos.
Quando algo dá errado
- Token recusado: o card mostra a etiqueta vermelha Token recusado. Os eventos não se perdem — ficam esperando até 7 dias. Gere um token novo e cole no card: os que estavam esperando saem no minuto seguinte. Você também recebe um aviso no sino.
- Meta instável: o CRM tenta de novo sozinho, com intervalos cada vez maiores.
- Expirado: a Meta não aceita eventos com mais de 7 dias. Evento que ficou esse tempo sem conseguir sair é marcado como expirado, em vez de ser enviado e derrubar os outros.
- Erro permanente: o card mostra o motivo em português e o detalhe técnico que a Meta devolveu, para o suporte.
Código de teste de eventos
Antes de confiar na integração, teste sem sujar os dados reais: no Gerenciador de Eventos, aba Testar eventos, copie o código de teste (algo como TEST12345) e cole no campo Código de teste do card. Enquanto o código vale, os eventos aparecem na tela de teste da Meta em tempo real, separados da produção.
⚠️ O código vale por 24 horas e expira sozinho. Com ele ativo, os eventos vão só para a tela de teste e não contam para as campanhas — por isso o CRM não deixa um código esquecido ficar ligado. O card mostra até quando o modo de teste está ativo.
Quais eventos são enviados
- Lead: assim que o contato entra no CRM vindo de Lead Ads (inclusive quem já conversava com você antes e depois preencheu o formulário) ou de landing page, com as conversões offline configuradas.
- Compra (Purchase): quando uma venda é marcada como concluída no CRM, com o valor em reais.
- LeadSubmitted / QualifiedLead: disparados pelo botão Qualificar na conversa ou ao mover o lead para uma etapa do funil configurada para isso — veja o artigo de qualificação por etapa.
Quando o card (lead) tem valor estimado, esse valor viaja junto — e campanhas com otimização por valor aproveitam.
