> For the complete documentation index, see [llms.txt](https://bolten.gitbook.io/bolten-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bolten.gitbook.io/bolten-docs/manual-de-uso-da-plataforma/conexao-com-anuncios.md).

# Conexão com Anúncios

Aqui você aprenderá, de forma resumida e rápida, como integrar a plataforma com o Gerenciador de Anúncios da Meta

***

## 🔗 Integração Meta Ads (CAPI)

Conecte o funil do seu CRM diretamente à Meta. Com a Conversions API (CAPI), a Bolten envia automaticamente eventos de conversão (leads, compras, cadastros) para otimizar suas campanhas.

#### ⚠️ Requisito de Visibilidade

Para que um componente apareça na lista de integração do Meta Ads, ele precisa seguir uma dessas regras:

1. Kanban: Deve ter um status de "Ganho" configurado em *Campos especiais*.
2. Conversões: O componente de Gestão de Conversões já fica habilitado por padrão.

***

#### 🛠️ Como Configurar em 4 Passos

**1. Preparar o Gatilho (Status ou Fonte)**

Antes de integrar, garanta que seus componentes estão prontos para enviar dados:

* No Kanban: Vá em *Configurar > Campos especiais* e defina qual coluna é o status "Ganho".
* Nas Conversões: Certifique-se de que as Fontes de Conversão (ex: WhatsApp, Formulário) já estão cadastradas.

**2. Acessar as Integrações**

No menu lateral do seu projeto, vá em:

* Configurações > Integrações > Meta Ads.

**3. Dados Técnicos da Meta**

Clique em "+ Novo" e preencha as chaves da sua conta de anúncios:

* Pixel ID: Identificação do seu Pixel na Meta.
* Token de Acesso: Gerado no Gerenciador de Negócios da Meta.
* Tipo de Evento: Como a Meta deve ler essa conversão (ex: *Lead* ou *Purchase*).

**4. Seleção e Ativação**

Escolha o componente que enviará os dados:

* Se escolher Kanban: Selecione as propriedades que quer enviar (E-mail e Telefone são automáticos).
* Se escolher Conversões: Você deve marcar as Fontes de Conversão que serão mapeadas. Se deixar em branco, o sistema considerará todas as fontes.
* Marque como "Ativo" e clique em Salvar.

***

#### 🔍 Como validar se está funcionando?

Não precisa esperar as campanhas rodarem. Na página da integração na Bolten, use a aba Execuções. Lá você verá em tempo real se os dados foram enviados e se a Meta retornou algum erro de autenticação ou formato.

***

#### 📍 Onde encontrar os dados na Meta?

1. Acesse o Gerenciador de Eventos no Facebook Business.
2. Em Fontes de Dados, copie o ID do Pixel.
3. O Token é gerado na aba "Configurações" do Pixel, na seção "API de Conversões" (Gerar token de acesso).