Meta CAPI: Conversion API do Facebook/Instagram

A Conversion API (CAPI) da Meta é o canal server-side oficial pra enviar eventos de conversão pro Facebook e Instagram Ads. Diferente do Pixel (que roda no navegador e depende de cookies), o CAPI sai direto do servidor SiteUp pra Meta — imune a bloqueadores, ITP, ATT do iOS e fim dos cookies de terceiros. Esta página mostra como configurar.

Por que usar CAPI

Cenário típico: você anuncia no Instagram, o lead clica no anúncio, conversa pelo WhatsApp e fecha venda dias depois. Sem CAPI, a Meta nunca sabe que aquela conversa virou venda — e a otimização da campanha fica cega.

Com CAPI, o SiteUp envia o evento Purchase no momento em que o card é fechado no Kanban, com os identificadores certos (leadgen_id, fbclid, ctwa_clid) pra Meta cruzar com o anúncio original.

Pré-requisitos

• Conta do Gerenciador de Negócios da Meta com acesso ao Pixel
• Token de acesso CAPI (gerado em Eventos → Configurações → Conversions API)
• ID do Pixel
• Permissão de Administrador no SiteUp

Passo 1 — Gerar o token na Meta

No Gerenciador de Eventos da Meta:

1. Selecione o Pixel desejado
2. Aba Configurações → Conversions API
3. Clique em Gerar token de acesso
4. Copie o token (ele não aparece de novo — guarde em local seguro)

Passo 2 — Configurar no SiteUp

No painel:

1. Configurações → Integrações → Meta CAPI
2. Cole o Pixel ID e o Access Token
3. (Opcional) Defina o Test Event Code durante a configuração inicial — permite ver eventos chegando em tempo real no Gerenciador
4. Mapeie quais eventos do Kanban viram quais eventos da Meta

Mapeamento de eventos

Recomendamos este mapeamento mínimo:

O value da conversão vem do campo valor do card. A currency é configurada por padrão como BRL (ajustável).

Identificadores de atribuição

A qualidade da atribuição depende do match — quanto mais sinais, melhor o EMQ (Event Match Quality) reportado pela Meta.

leadgen_id

Quando o lead vem de Anúncio de Lead Form da Meta. O SiteUp armazena o leadgen_id como custom_attribute na conversa automaticamente quando integrado via webhook do Lead Ads.

fbclid

Quando o lead clica num anúncio comum e cai num formulário/landing antes do WhatsApp. Capture o fbclid da URL do formulário e envie pro SiteUp via API REST como custom_attribute na criação do contato.

ctwa_clid (Click-to-WhatsApp)

Identificador específico de anúncios Click-to-WhatsApp. O SiteUp captura automaticamente quando o WhatsApp Business API entrega o referral.ctwa_clid na primeira mensagem do contato.

Exemplo do payload enviado

{
  "event_name": "Purchase",
  "event_time": 1761662531,
  "action_source": "business_messaging",
  "user_data": {
    "ph": ["a3f5..."],
    "em": ["8c0d..."],
    "ctwa_clid": "ARxxxxxxxxxxxxxxx"
  },
  "custom_data": {
    "currency": "BRL",
    "value": 2400.00
  },
  "messaging_channel": "whatsapp"
}

Note que telefone (ph) e e-mail (em) vão hasheados em SHA-256 — o SiteUp faz isso automaticamente antes de enviar.

Validando

No Gerenciador de Eventos, aba Test Events, configure o Test Event Code que você definiu no SiteUp. Mova um card de teste pra coluna de ganho e o evento deve aparecer em segundos. Confira:

• Status: Processed
• EMQ: ideal acima de 6.0
• Parâmetros: pelo menos ph, em ou ctwa_clid presentes

Quando estiver tudo verde, remova o Test Event Code para os eventos serem contabilizados em produção.

Boas práticas

• Não desligue o Pixel — CAPI e Pixel funcionam juntos. A Meta deduplica via event_id
• Padronize valores — sempre envie value e currency, mesmo em eventos Lead
• Capture o fbclid no formulário — é o identificador mais confiável fora do Lead Ads

Próximos passos

• Google Offline Conversion — equivalente para Google Ads
• Webhooks customizados — pra capturar fbclid de formulários externos