A conexão com o Meta Ads é feita por OAuth com login pelo Facebook: você entra com o seu usuário, autoriza o acesso e, de volta à Toca, escolhe no card qual conta de anúncios será consultada. Nenhuma senha fica armazenada na Toca — a autorização acontece na tela da própria Meta.

Antes de começar

• Tenha um usuário do Facebook com acesso às contas de anúncios que você quer conectar — o seletor da Toca mostra as contas de anúncios que esse usuário acessa.
• Se o acesso à conta de anúncios é gerenciado num Gerenciador de Negócios (Business), garanta que o seu usuário tem permissão nela antes de conectar (confirme na documentação oficial como conceder acesso).

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Meta Ads e clique em Conectar.
3. Entre com o seu usuário do Facebook e autorize o acesso na tela de login da Meta.
4. De volta à Toca, o card exibe um seletor de conta, com as contas de anúncios que o seu usuário acessa. Escolha a conta que a Toca deve consultar.
5. Ao selecionar, a escolha é salva ("Conta Meta ads atualizada.") e a integração fica ativa.

O que a Toca acessa

Com a conexão ativa, a Toca lê as campanhas pagas no Facebook e Instagram: investimento, alcance, impressões, CPM, CTR, conversões, conjuntos de anúncios e criativos. Alterações — como pausar ou ativar campanha e conjunto, ajustar orçamento e lance, incluir ou remover produto de conjunto, criar campanha ou conjunto e excluir campanha e anúncio — só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat.

Manutenção da conexão

A autorização gera um token de longa duração, válido por cerca de 60 dias. A Toca renova esse token toda semana, então em uso normal a conexão não expira. Se o token for revogado — por troca de senha do Facebook ou remoção do acesso do aplicativo —, a verificação semanal detecta a revogação em até 7 dias e o card passa a pedir reconexão.

Problemas comuns

• O seletor de conta veio vazio — o usuário do Facebook que autorizou não tem acesso a nenhuma conta de anúncios. Refaça a conexão com o usuário certo, ou peça acesso à conta no Gerenciador de Negócios.
• A conexão caiu depois de trocar a senha do Facebook — a troca de senha pode revogar o token de acesso. Refaça a conexão pelo card.
• Erro de permissão numa consulta específica — nem todo erro é desconexão: se o card segue conectado, o problema costuma ser a permissão daquele recurso na conta, não a credencial.
• Quero trocar a conta de anúncios — não é preciso reconectar: escolha outra conta no seletor do card.