## Visão geral

O **Gerenciador de Anúncios** integra a plataforma à **API de Marketing da Meta** com foco em
campanhas de **Conversas por mensagem**: o anúncio leva o cliente direto para uma conversa no
**WhatsApp**, no **Messenger** e/ou no **Instagram**, conforme os destinos escolhidos. Nas
conversas do WhatsApp, a conversa vira **lead atribuído ao anúncio**, a venda volta para a
Meta como **conversão** e o desempenho aparece em métricas nativas.

Ele completa os dois módulos de anúncios já existentes:

- **Leads de anúncios (CTWA)** — captura e atribuição de quem chega por anúncio;
- **Rastreamento de conversões** — envio de eventos de conversão de volta à Meta (CAPI).

Com o Gerenciador, a conta de anúncios (`act_<id>`) fica **conectada a uma caixa de entrada do
WhatsApp** e a plataforma mantém um **espelho somente leitura** das suas campanhas, conjuntos de
anúncios, anúncios e criativos, sincronizado periodicamente.

## Pré-requisitos

- O módulo **Ads Manager** habilitado na conta (ele é entregue **desativado por padrão** e é
  liberado pelo operador da instalação).
- Uma **conta de anúncios da Meta** (`act_<id>`) com permissão de gerenciamento.
- Uma **Página do Facebook** e um **número do WhatsApp Cloud** vinculados à conta de anúncios.
- Um **token de acesso** com os escopos de anúncios da Meta (`ads_management`, `ads_read`,
  `business_management`, `pages_show_list`, `whatsapp_business_management`).
- Perfil de **administrador** na conta.

## Passo a passo

1. Habilite o módulo na conta (operador) e confirme que a caixa de entrada do WhatsApp desejada
   está ativa.
2. **Conecte a conta de anúncios** (fluxo automático): escolha a caixa de entrada do WhatsApp
   Cloud e a plataforma **reutiliza o token da própria caixa** para listar automaticamente as
   contas de anúncios — basta selecionar uma (você nunca digita o `act_<id>` à mão). Se esse token
   não tiver escopo de anúncios, cole um **token de usuário do sistema** do Business Manager e a
   lista é carregada da mesma forma. Cada conta de anúncios se conecta a **uma** caixa de entrada
   (relação 1:1).
3. A conexão nasce como **pendente** e passa a **conectada** após a validação do token junto à
   Meta.
4. A partir daí a plataforma **sincroniza periodicamente** o espelho de campanhas, conjuntos,
   anúncios e criativos da conta (intervalo padrão de 60 minutos, ajustável por conexão), e você
   pode forçar uma atualização com a ação **Atualizar** da conexão.
5. Acompanhe os leads e conversões gerados pelos anúncios nos módulos **Leads de anúncios** e
   **Rastreamento de conversões** — a atribuição do anúncio aparece na própria conversa.

## Configurações & opções

- **Tipo de token**: `usuário do sistema` (recomendado — não expira) ou `usuário` (renovado
  automaticamente antes do vencimento por um job de manutenção).
- **Intervalo de sincronização**: minutos entre as leituras da estrutura de anúncios (padrão 60).
- **Status da conexão**: `pendente`, `conectada`, `erro` ou `revogada` — o último erro fica
  registrado na conexão para diagnóstico.
- **Token mascarado**: por segurança, o token nunca é exibido depois de salvo; a interface mostra
  apenas os últimos 4 caracteres.

## Casos de uso

- **Central única de anúncios de conversa**: acompanhar campanhas de conversas por mensagem
  (WhatsApp, Messenger e Instagram) e as conversas que elas geram no mesmo lugar em que o time
  atende.
- **Atribuição ponta a ponta**: saber qual anúncio originou cada conversa/lead e devolver a
  conversão à Meta para otimizar a entrega.
- **Custo por conversa**: medir o desempenho real dos anúncios pelo que importa — conversas e
  vendas, não cliques.

## Dicas, limites e boas práticas

- Prefira **token de usuário do sistema** do Business Manager: não expira e sobrevive a trocas de
  senha do usuário.
- Uma caixa de entrada aceita **uma** conta de anúncios conectada (e vice-versa dentro da conta).
- O Gerenciador cobre o ciclo completo dentro da caixa de entrada: **conexão da conta**, **espelho**
  de campanhas/conjuntos/anúncios, **criação** e **ativação/pausa** de campanhas de conversas por
  mensagem, **ajuste de orçamento**, **públicos**, o acompanhamento da **janela gratuita de 72h** e os
  **painéis de métricas** (gasto, conversas, ROAS).
- A janela de entrada gratuita de **72h** do CTWA é contada a partir do clique no anúncio —
  priorize responder dentro dela.

## Solução de problemas

- **Conexão em `erro`**: o token foi rejeitado pela Meta (expirado, senha trocada, permissão
  removida). Gere um novo token e reconecte; o motivo fica registrado no campo de último erro.
- **Conexão `revogada`**: o acesso foi revogado no Business Manager — reconecte com um token
  válido.
- **Espelho vazio**: confirme que a conexão está `conectada` e aguarde o próximo ciclo de
  sincronização (ou use **Atualizar**).
- **Permissão negada ao conectar**: confira se o token carrega todos os escopos de anúncios
  listados nos pré-requisitos.

## Referências oficiais da Meta

- [Usuários do sistema — gerar tokens de acesso para a API de Marketing](https://developers.facebook.com/docs/marketing-api/system-users)
- [Autorização e escopos da API de Marketing (`ads_management`, `ads_read`)](https://developers.facebook.com/docs/marketing-api/overview/authorization)

## Veja também

- [Criar uma campanha de conversas por mensagem ou formulário de cadastro no Gerenciador de Anúncios](/hc/ajuda/articles/growth-marketing-ads-manager-create-campaign-pt-br)
- [Janela de 72h e painéis de métricas do Gerenciador de Anúncios](/hc/ajuda/articles/growth-marketing-ads-manager-window-insights-pt-br)
- [Automação e Flow Builder com ações de anúncio](/hc/ajuda/articles/growth-marketing-ads-manager-automation-pt-br)
- [Leads de anúncios (CTWA): captura e atribuição de leads vindos de anúncios](/hc/ajuda/articles/growth-marketing-ads-ctwa-leadgen-pt-br)
- [Rastreamento de conversões: eventos de conversão de volta para a Meta (CAPI)](/hc/ajuda/articles/growth-marketing-ads-conversion-tracking-pt-br)
- [Caixa de entrada WhatsApp Cloud: conexão do número oficial](/hc/ajuda/articles/inboxes-channels-whatsapp-cloud-embedded-signup-pt-br)