Meta Ads

A integração via Meta Conversions API (CAPI) conecta diretamente o Funil do CRM aos servidores da Meta (Facebook e Instagram Ads).

Com a Integração de Meta Ads da Bolten, seus eventos e conversões (como compras, leads e cadastros) são enviados de forma confiável.

Caso a integração esteja ativada, sempre que um Lead for enviado para a etapa de Ganho em um dado funil de vendas, seus dados serão automaticamente enviados à Meta.

Por que usar essa integração?

Caso seu cliente possua veiculação de anúncios via Meta, o uso da integração da CAPI via Bolten faz com que essa veiculação seja otimizada para públicos com perfis de consumo semelhantes. Essa otimização é feita identificando padrões de acesso de um usuário da Meta a partir dos dados enviados pela Bolten (e-mail, telefone, etc.)

Isso permite:

• Rastreamento mais preciso de conversões.

• Melhor desempenho das campanhas (otimização de anúncios).

• Dados mais completos para análise de ROI.

Como configurar

Veja como você pode configurar sua primeira integração com Meta Ads em apenas alguns passos.

1. Acessando as Integrações com Meta Ads

Você pode encontrar as configurações de Integrações com Meta Ads dentro de um projeto na Bolten em Configurações > Integrações > Meta Ads.

2. Criando uma nova integração com Meta Ads

1. Na página de Meta Ads, clique no botão "+ Novo".

2. Você verá uma tela de configuração em que precisará preencher alguns campos:

• Pixel ID: este é o dado atrelado à campanha do Meta Ads. Veja como recuperar o Pixel ID.

• Token de Acesso: dado de autenticação da Meta. Veja como obtê-lo aqui.

• Tipo de Evento do Meta Ads: tipo de evento que será sinalizado ao Pixel da Meta. Entenda mais aqui.

• Ativo: indica que a integração está ativa para se comunicar com a Meta.

• Funil de vendas: mostra todos os funis do projeto que possuem o status "Ganho" definido nas suas configurações.

• Propriedades enviadas ao Meta Ads: ao selecionar um funil, as propriedades disponíveis nele serão mostradas aqui. Selecione as que deseja enviar para a Meta quando uma conversão ocorrer. Os campos e-mail, telefone e nome são enviados automaticamente, caso existam.

Pixel da Meta

Leia: O que é o Pixel da Meta?

Para acessar o Pixel da Meta, é necessário que você possua uma conta Facebook Business.

• Autentique-se na sua conta do Facebook Business

• No canto inferior esquerdo, clique em Configurações

• Na página seguinte, entre em Fontes de Dados > Conjunto de Dados e Pixels. O Pixel ID estará localizado do lado direito da tela, ao lado de Identificação

Payload

Todos os atributos selecionados na configuração da integração serão enviados no nó custom_data

Os dados usados para identificar o Lead são o e-mail (em) e o telefone (ph) do contato ou da oportunidade em questão.

Também é enviado o nome da pessoa, caso ela esteja identificada (fn e ln )

O payload segue o formato descrito na documentação oficial da Conversions API da Meta.

Exemplo:

{
  "data": [
    {
      "event_id": "187cecc1-2b10-4ea6-a0cd-efa3aa1ff3ae",
      "user_data": {
        "em": "73eecced1ab3205e181a62742aa190da6c67b5c3589da75133c11936df3143cc",
        "ph": "2eb045dd514c459215c51b20dea69ac23c8de1380e3de5a55e3a489a9124b6ff"
      },
      "event_name": "Lead",
      "event_time": 1755097408,
      "custom_data": {
        "Status": "Finalizado",
        "Contato": {
          "Nome": "John Doe",
          "E-mail": "[e-mail]",
          "WhatsApp": "1199999999",
          "created_at": "2025-08-07T10:08:57.955-03:00",
          "updated_at": "2025-08-07T10:08:58.396-03:00",
          "component_id": "d447a6e5-7842-4059-a0eb-9aef5b5db6fc"
        },
        "Tarefas": [],
        "Prioridade": "High",
        "created_at": "2025-07-31T11:16:41.555-03:00",
        "updated_at": "2025-08-08T16:36:49.231-03:00",
        "component_id": "f4d195ef-4f98-4402-a8e2-3124252b53f8"
      },
      "action_source": "crm"
    }
  ],
  "access_token": "<MEU_TOKEN_DE_ACESSO>"
}

Tratamento de erros

Visualizando entregas

Você pode ver um registro das requsições feitas à Meta na aba de Execuções.

Nessa página é exibida a resposta mais recente para cada requisição da integração.