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
- Habilite o módulo na conta (operador) e confirme que a caixa de entrada do WhatsApp desejada está ativa.
- 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). - A conexão nasce como pendente e passa a conectada após a validação do token junto à Meta.
- 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.
- 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) ouusuá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,erroourevogada— 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á
conectadae 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
- Autorização e escopos da API de Marketing (
ads_management,ads_read)
Veja também
- Criar uma campanha de conversas por mensagem ou formulário de cadastro no Gerenciador de Anúncios
- Janela de 72h e painéis de métricas do Gerenciador de Anúncios
- Automação e Flow Builder com ações de anúncio
- Leads de anúncios (CTWA): captura e atribuição de leads vindos de anúncios
- Rastreamento de conversões: eventos de conversão de volta para a Meta (CAPI)
- Caixa de entrada WhatsApp Cloud: conexão do número oficial