# Conectar o CRM à API de Conversões da Meta: o que enviar, quando e com qual identificador

> A API de Conversões da Meta com CRM serve para devolver à Meta o que aconteceu depois do lead: reunião, proposta, venda. Cada etapa do funil vira um evento enviado do servidor, com o identificador do lead e os dados do contato. Assim o anúncio otimiza por quem compra, não só por quem cadastra. A AD PRO monta o envio via webhook, API e n8n.

Página original: https://www.adprotecnologia.com.br/crm/blog/api-de-conversoes-da-meta-com-crm
Autor: AD PRO Tecnologia. Publicado em 2026-10-31.

O Pixel da Meta registra o que acontece no navegador. A venda, em muitos negócios, acontece fora dele: numa conversa de WhatsApp, numa reunião, num contrato assinado. A API de Conversões existe para fechar essa lacuna, e o CRM é a fonte natural dos eventos, porque é onde cada etapa fica registrada.

O guia está organizado por cenário, porque a Meta documenta caminhos diferentes para lead de formulário, para site e para anúncio que abre o WhatsApp, cada um com seus identificadores e requisitos. Para trazer o lead do formulário até o CRM, veja antes [leads do Facebook Ads no CRM](https://www.adprotecnologia.com.br/crm/leads-do-facebook-ads-no-crm); o retorno equivalente para o Google está em [leads do Google Ads no CRM](https://www.adprotecnologia.com.br/crm/blog/leads-do-google-ads-no-crm). Documentação conferida em 31 de outubro de 2026.

## Qual cenário da API de Conversões se aplica ao seu caso?

Depende de onde nasce o lead. Formulário instantâneo, site com Pixel e anúncio que abre o WhatsApp usam identificadores diferentes e pedem eventos diferentes. Escolher o cenário errado é o motivo mais comum de a integração rodar sem melhorar a campanha.

**Três cenários documentados pela Meta e o que cada um exige**

| Cenário | Identificador principal | O que o CRM envia | Ponto de atenção |
| --- | --- | --- | --- |
| Formulário instantâneo (Lead Ads) com Conversion Leads | Lead ID de 15 a 17 dígitos, guardado no CRM | Mudanças de etapa do lead | Volume mínimo, envio diário e janela de 28 dias, vistos abaixo |
| Site com Pixel e API | Cookies fbc e fbp, mais e-mail e telefone com hash | Eventos do site e eventos de CRM do mesmo lead | Deduplicar com o mesmo event_id |
| Anúncio que abre o WhatsApp | ctwa_clid, vindo da mensagem recebida | Eventos da conversa, como compra ou lead qualificado | Permissões e integração com a plataforma do WhatsApp |

## O que a Meta exige para o Conversion Leads funcionar?

O Conversion Leads é a meta de desempenho que otimiza o anúncio por qualidade do lead, e a documentação da Meta o limita aos formulários instantâneos. Ele funciona quando o CRM devolve as etapas do lead e o volume é suficiente para a Meta aprender.

- Usar Lead Ads (formulários instantâneos) do Facebook ou do Instagram.
- Guardar no CRM o Lead ID de 15 a 17 dígitos e enviá-lo com cada evento. Sem ele, enviar parâmetros do cliente, como telefone ou e-mail.
- Gerar ao menos 200 leads por mês.
- Enviar os dados pelo menos uma vez por dia.
- A etapa que você quer otimizar deve acontecer em até 28 dias depois da geração do lead.
- Essa etapa deve ocorrer em uma faixa de 1 a 40 em cada 100 leads; fora disso, a Meta tem pouco sinal para aprender.

A Meta estima cerca de 3 a 4 semanas até o ganho aparecer, somando a verificação dos dados e o período de aprendizado. Quem anuncia com pouco volume por mês não deve forçar essa integração: ainda vale gravar a origem e medir no BI, como em [rastrear a origem do lead](https://www.adprotecnologia.com.br/crm/rastrear-origem-do-lead-no-crm). A conta de quanto cada canal vendeu está em [como medir vendas do tráfego pago](https://www.adprotecnologia.com.br/crm/blog/como-medir-vendas-do-trafego-pago).

## Como transformar as etapas do funil em eventos?

Escolha duas ou três etapas que indiquem qualidade, nunca todas. Cada uma vira um evento com nome fixo. O erro mais comum é mandar dez eventos; a Meta aprende melhor com poucos sinais que realmente separam o lead bom do ruim.

**Exemplo de mapa entre etapas do CRM e eventos enviados**

| Etapa no CRM | Evento enviado | Serve para |
| --- | --- | --- |
| Novo lead | Nenhum (já foi contado pelo formulário) | Evita contar o cadastro duas vezes |
| Qualificado | Lead qualificado | Sinal de qualidade logo no início |
| Reunião ou proposta | Evento personalizado, como proposta enviada | Sinal intermediário |
| Venda fechada | Compra, com valor | Sinal final de resultado |

## Que campos o evento precisa levar?

Pela referência da Meta, todo evento do servidor leva nome do evento, horário, origem da ação e dados do cliente. O horário é um carimbo Unix em segundos, e a Meta aceita evento de até 7 dias atrás; se um evento do lote passar disso, a requisição inteira falha.

- **event_name:** nome padrão ou personalizado do evento.
- **event_time:** quando o evento aconteceu, em segundos Unix, no máximo 7 dias antes do envio.
- **action_source:** de onde veio a ação. Os valores aceitos incluem site, e-mail, chat, sistema gerado e mensagens de negócio.
- **user_data:** dados do cliente. E-mail e telefone exigem hash SHA-256 depois de normalizados (e-mail em minúsculas e sem espaços; telefone só com números, incluindo o código do país). O Lead ID, os cookies fbc e fbp e o endereço IP não levam hash.
- **event_id:** recomendado para evitar contagem em dobro quando o mesmo evento vem do Pixel e do servidor.

## Como evitar que o mesmo evento seja contado duas vezes?

Enviando o mesmo nome de evento e o mesmo event_id pelo Pixel e pela API. A Meta descarta o segundo evento que chegar em até 48 horas depois do primeiro. Sem esse casamento, a conversão de site aparece em dobro e a campanha aprende com número inflado.

A regra vale para eventos que existem nas duas pontas, como uma compra no site. Eventos que só existem no CRM, como uma proposta enviada, não têm par no navegador e seguem apenas pelo servidor. A deduplicação, aliás, não atua quando só uma das origens envia o evento.

## E quando o lead chega por um anúncio que abre o WhatsApp?

Nesse caso a Meta tem uma versão própria, para mensagens de negócio. O identificador é o ctwa_clid, que chega na mensagem recebida, e o evento só deve representar algo que aconteceu na conversa. O desenho do anúncio e da leitura da campanha está em [anúncio de clique para o WhatsApp](https://www.adprotecnologia.com.br/crm/blog/anuncio-de-clique-para-o-whatsapp).

- O ctwa_clid vem do objeto de referência no aviso de mensagem da plataforma do WhatsApp; o CRM guarda esse valor junto com a conversa.
- O envio usa action_source de mensagens de negócio e canal WhatsApp, com a conta de WhatsApp Business no pedido.
- A documentação exige um app de desenvolvedor, permissões avançadas de gestão do WhatsApp e de eventos, e uma integração com a plataforma do WhatsApp. Por isso a AD PRO costuma montar esse caso junto com a estrutura da [API oficial do WhatsApp](https://www.adprotecnologia.com.br/crm/api-oficial-do-whatsapp).

## Como a AD PRO monta isso com o DataCrazy?

Na implementação, a AD PRO, parceira Premier e implementadora do DataCrazy, liga o CRM a um fluxo no n8n: quando o lead chega a uma etapa-chave, o fluxo monta o evento com o identificador e os dados do contato, aplica o hash, envia à Meta e registra a resposta. O desenho exato depende do plano do DataCrazy e dos webhooks disponíveis.

1. **Grave o identificador na entrada.** O Lead ID, o ctwa_clid ou o clique do site entram em campo próprio do contato, no momento da criação, e nunca são editados.
2. **Escolha as duas ou três etapas-sinal.** Converse com a equipe comercial sobre qual etapa separa o lead bom do ruim. Use a etapa de venda com valor quando existir.
3. **Monte o fluxo de envio.** Webhook da mudança de etapa, normalização, hash, chamada à API de Conversões, registro do resultado. Veja [integração do DataCrazy com o n8n](https://www.adprotecnologia.com.br/crm/integracao-datacrazy-n8n).
4. **Verifique no Gerenciador de Eventos.** Confirme que os eventos aparecem, com os campos corretos e sem duplicidade, antes de mudar a meta da campanha.
5. **Compare com o BI.** O número de vendas por campanha no BI do DataCrazy precisa bater com o que a Meta recebeu. Se divergir, o problema está no envio.

**Planilha de mapeamento CRM para Meta (copie e preencha)**

```text
Cenário: [ ] formulário instantâneo  [ ] site com Pixel  [ ] anúncio que abre o WhatsApp
Identificador gravado no lead: [ ] Lead ID  [ ] ctwa_clid  [ ] fbc/fbp

Etapa do CRM | Evento enviado | Valor (sim/não) | Quem decide a etapa
------------ | ------------- | ---------------- | -------------------
[etapa 1]    | [nome do evento] | [ ]            | [responsável]
[etapa 2]    | [nome do evento] | [ ]            | [responsável]
[venda]      | Compra           | [ ] sim        | [responsável]

Conferências antes de ligar:
[ ] E-mail em minúsculas e telefone só com números e código do país, ambos com hash
[ ] Lead ID, fbc, fbp e IP sem hash
[ ] event_time com no máximo 7 dias
[ ] Mesmo event_id no Pixel e no servidor, quando o evento existe nos dois
[ ] Envio pelo menos uma vez por dia
[ ] Eventos apareceram no Gerenciador de Eventos sem duplicidade
```

> **Antes de integrar, arrume o funil:** A API de Conversões amplifica o que o funil já registra. Se as etapas do CRM são usadas de qualquer jeito, o sinal enviado também será. Revise as etapas com a [gestão de leads](https://www.adprotecnologia.com.br/crm/blog/gestao-de-leads) e só depois ligue o retorno.

## Perguntas frequentes

### O que é a API de Conversões da Meta?

É a forma de enviar eventos do seu servidor ou do seu CRM direto à Meta, sem depender do navegador. Serve para informar compras, leads qualificados e outras etapas que acontecem fora do site, para o anúncio otimizar por resultado.

### Como integrar a API de Conversões da Meta com o CRM?

Grave o identificador do lead na entrada, escolha duas ou três etapas-sinal, monte um fluxo que envie o evento quando a etapa mudar e confira no Gerenciador de Eventos. A AD PRO monta isso para o DataCrazy via webhook, API e n8n.

### Preciso do Pixel se uso a API de Conversões?

Para eventos de site, a Meta recomenda enviar pelos dois caminhos e deduplicar com o mesmo nome e event_id. Para eventos que só existem no CRM, como proposta enviada, o envio é apenas pelo servidor.

### Quantos leads preciso para usar o Conversion Leads?

A documentação da Meta pede ao menos 200 leads por mês, envio de dados pelo menos uma vez por dia, uma etapa que ocorra em até 28 dias do lead e que atinja de 1 a 40 em cada 100 leads. Abaixo disso, vale medir pelo BI do CRM.

### O e-mail e o telefone precisam de hash na API de Conversões?

Sim, e-mail e telefone exigem hash SHA-256 depois de normalizados: e-mail em minúsculas, sem espaços, e telefone só com números, incluindo o código do país. O Lead ID, os cookies fbc e fbp e o IP não levam hash.

### Qual o prazo máximo para enviar um evento à Meta?

O horário do evento pode ser de até 7 dias antes do envio. Se um evento do lote for mais antigo, a requisição inteira falha, por isso o envio deve ser automático e diário, não feito em lote de fim de mês.

## Fontes

- [Meta para desenvolvedores: integração de CRM com a API de Conversões](https://developers.facebook.com/docs/marketing-api/conversions-api/guides/crm-integration), conferido em 2026-10-31
- [Meta para desenvolvedores: parâmetros do evento do servidor](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event), conferido em 2026-10-31
- [Meta para desenvolvedores: deduplicação de eventos do Pixel e do servidor](https://developers.facebook.com/docs/marketing-api/conversions-api/deduplicate-pixel-and-server-events), conferido em 2026-10-31
- [Meta para desenvolvedores: parâmetros de informações do cliente](https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/customer-information-parameters), conferido em 2026-10-31
- [Meta para desenvolvedores: API de Conversões para mensagens de negócio](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging), conferido em 2026-10-31

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos