> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Ads

> Consultar campanhas e métricas do Facebook/Instagram Ads via chat

# Meta Ads

Integração com a API do Meta (Facebook/Instagram Ads). Consulte suas campanhas, anúncios e métricas de performance diretamente pelo chat.

## Conectar

Envie seu access token do Meta e o bot troca automaticamente por um token de longa duração (60 dias). Seus tokens ficam salvos de forma segura no banco de dados.

```
Conecte minha conta Meta Ads. Meu token é EAAx...
```

<Tip>
  O bot mascara tokens automaticamente durante a conversa (Token Vault). Seus tokens nunca aparecem nas respostas da IA.
</Tip>

<Card title="Guia: Como gerar os tokens" icon="plug" href="/guides/meta-ads-setup">
  Passo a passo pra criar o app no Meta, gerar o Access Token e o App Secret.
</Card>

## O que você pode consultar

<AccordionGroup>
  <Accordion title="Contas de anúncio" icon="building">
    Liste todas as contas de anúncio vinculadas à sua conta Meta.
  </Accordion>

  <Accordion title="Campanhas" icon="bullhorn">
    Veja campanhas ativas, pausadas ou arquivadas com nome, status e objetivo.
  </Accordion>

  <Accordion title="Conjuntos de anúncio (Ad Sets)" icon="layer-group">
    Detalhes de targeting, budget e schedule dos ad sets.
  </Accordion>

  <Accordion title="Anúncios" icon="ad">
    Anúncios individuais com status e creative.
  </Accordion>

  <Accordion title="Insights de performance" icon="chart-line">
    Métricas detalhadas: gasto, impressões, cliques, CPC, CTR, alcance, conversões.

    **Períodos disponíveis:**
    hoje, ontem, últimos 7 dias, últimos 30 dias, mês atual, mês passado, ou range customizado.

    **Breakdowns:**
    idade, gênero, país, dispositivo, plataforma.

    **Níveis:**
    conta, campanha, ad set, anúncio.
  </Accordion>
</AccordionGroup>

## Tools

| Tool                  | O que faz                                            |
| --------------------- | ---------------------------------------------------- |
| `meta_ads_connect`    | Conectar conta (valida token + troca por long-lived) |
| `meta_ads_disconnect` | Desconectar conta                                    |
| `meta_ads_accounts`   | Listar contas de anúncio                             |
| `meta_ads_campaigns`  | Listar campanhas                                     |
| `meta_ads_adsets`     | Listar conjuntos de anúncios                         |
| `meta_ads_ads`        | Listar anúncios                                      |
| `meta_ads_insights`   | Métricas de performance                              |