Integrar CRM com Meta CAPI | Kognos

Integração CRM + CAPI fecha o loop que conectores nativos não completam: lead entra com origem, estágios comerciais voltam ao Meta como conversões server-side, algoritmo otimiza para receita — não só formulário.

Passo 1: propriedades de origem no CRM

Crie campos: utm_source, utm_campaign, fbclid, ctwa_clid, landing_page, gclid (Google). Preencha no create — obrigatório antes de workflow.

Hidden fields + API server-side redundancy. Valide: 95%+ leads pagos com utm_campaign preenchido.

Passo 2: middleware e webhooks

HubSpot/RD/Pipedrive webhook on deal stage change → função que monta payload CAPI: event_name, event_time, event_id (novo UUID por transição), user_data hash, custom_data valor.

Nunca reutilize event_id de Lead para Purchase — IDs únicos por evento; external_id CRM constante por contato.

Passo 3: mapeamento estágios → eventos Meta

Exemplo: Lead (form) → Lead. MQL → QualifiedLead. Demo agendada → Schedule. Won → Purchase com value.

Documente tabela interna marketing+vendas. Máximo 5 eventos — volume por evento importa para algoritmo.

Passo 4: QA e monitoramento

Test Events com deal teste. Produção: dashboard Meta leads vs CRM por campanha semanal. Alert se match rate cair >10pp.

Spoke /integracao-crm-meta-ads · Implementação Kognos end-to-end em 2–6 semanas.

Perguntas frequentes

Integração nativa HubSpot basta? Raramente para dedup, CTWA multi-filial e multi-touch. CAPI custom complementa.

RD Station funciona? Sim — webhooks e campos custom suportam arquitetura idêntica.