> ## 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.

# Conectar Meta Ads

> Como gerar os tokens necessários e conectar suas contas de anúncio

# Conectar Meta Ads

Guia passo a passo pra gerar um Access Token e App Secret no Meta for Developers e conectar suas contas de anúncio ao BuildZero.

**Tempo:** \~5 minutos | **Resultado:** token de 60 dias com acesso a todas as suas contas

<Info>
  Você vai precisar de uma conta do Facebook (a mesma que gerencia os anúncios) e um navegador.
</Info>

***

## O que você vai gerar

Ao final do processo, você vai ter dois valores pra enviar pro bot:

| Item             | O que é                    | Duração                                   |
| ---------------- | -------------------------- | ----------------------------------------- |
| **Access Token** | Token de acesso temporário | 1-2 horas (o bot troca por um de 60 dias) |
| **App Secret**   | Chave secreta do app       | Permanente (só precisa enviar uma vez)    |

***

## Passo a passo

<Steps>
  <Step title="Acesse o Meta for Developers">
    Abra **developers.facebook.com** no navegador e faça login com sua conta do Facebook.

    Se for sua primeira vez, aceite os termos de desenvolvedor. É só um cadastro inicial — não precisa verificar empresa.

    Você vai cair na página **"Meus Apps"**.
  </Step>

  <Step title="Crie um app">
    1. Clique no botão verde **"Criar aplicativo"** (canto superior direito)
    2. Preencha:
       * **Nome do app:** qualquer nome (ex: "Meus Anuncios")
       * **Email:** seu email de contato (já vem preenchido)
    3. Clique **"Avançar"**
    4. Em **"Casos de uso"**, selecione: **"Criar e gerenciar anúncios com a API de Marketing"** (primeiro da lista)
    5. Clique **"Avançar"**
    6. Em **"Empresa"**, selecione seu portfólio ou **"Ainda não quero me conectar"**
    7. Clique **"Avançar"** (tela de requisitos — só confirmar)
    8. Na **"Visão geral"**, clique **"Ir para o painel"**

    <Tip>
      O nome do app é só pra sua organização — o usuário final nunca vê.
    </Tip>
  </Step>

  <Step title="Gere o Access Token">
    Agora vamos pro **Graph API Explorer** — a ferramenta da Meta pra gerar tokens.

    1. Acesse **developers.facebook.com/tools/explorer**
    2. No painel da direita, em **"App da Meta"**, selecione o app que você criou
    3. No campo **"Adicionar uma permissão"**, adicione estas 3:

    ```
    ads_management        → gerenciar campanhas e anúncios
    ads_read              → ler dados das campanhas
    business_management   → acessar contas em Business Managers
    ```

    4. Clique no botão azul **"Generate Access Token"**
    5. Autorize tudo no popup que abrir
    6. Copie o token que aparece no campo **"Token de acesso"**

    <Warning>
      Esse token dura só 1-2 horas. Não se preocupe — o bot troca automaticamente por um de 60 dias.
    </Warning>
  </Step>

  <Step title="Pegue o App Secret">
    1. Acesse **developers.facebook.com/apps**
    2. Clique no seu app (ex: "Meus Anuncios")
    3. Menu lateral: **Configurações do app** → **Básico**
    4. Localize **"Chave Secreta do Aplicativo"** e clique em **"Mostrar"**
    5. Confirme sua senha se pedir
    6. Copie a chave secreta
  </Step>

  <Step title="Envie pro bot">
    No Telegram, envie algo como:

    ```
    Quero conectar minha conta do Meta Ads.
    Token: EAA...seu_token_aqui...
    App Secret: abc123...sua_chave_aqui...
    ```

    O bot vai:

    1. Validar seu token com uma chamada de teste
    2. Trocar por um token de **60 dias**
    3. Salvar tudo de forma segura
    4. Mostrar suas contas de anúncio conectadas
  </Step>
</Steps>

***

## Renovação (a cada 60 dias)

Quando o token expirar, o bot avisa. Basta repetir os passos 3 e 5:

1. Gere um novo Access Token no Graph API Explorer
2. Envie pro bot

O App Secret não muda — só precisa enviar uma vez.

***

## FAQ

<AccordionGroup>
  <Accordion title="Preciso de CNPJ ou empresa?">
    Não. Uma conta pessoal do Facebook é suficiente.
  </Accordion>

  <Accordion title="Isso mexe nos meus anúncios?">
    Só se você pedir. O token dá acesso, mas o bot só faz o que você mandar.
  </Accordion>

  <Accordion title="É seguro?">
    Sim. Tokens ficam salvos de forma segura no servidor e nunca aparecem nas respostas da IA (o sistema usa referências internas — Token Vault).
  </Accordion>

  <Accordion title="Funciona com várias contas?">
    Sim. Um único token dá acesso a todas as contas que você gerencia, mesmo em Business Managers diferentes.
  </Accordion>

  <Accordion title="O app que criei tem custo?">
    Não. Apps de desenvolvedor da Meta são gratuitos.
  </Accordion>
</AccordionGroup>