Conectando o Meta Ads

Conecte sua conta do Meta ao Opus Growth.

Antes de começar

• Você precisa ter acesso, no Meta Business Manager, à conta de anúncios e à Página do Facebook pela qual os anúncios serão veiculados.
• Na tela de consentimento, use Editar acesso e marque TODAS as contas de anúncios e Páginas que você quer gerenciar. A Meta concede acesso com base no que é selecionado ali, e seleções somente de visualização não permitem fazer alterações.

Etapas da conexão

1. Execute a ferramenta. Diga ao seu assistente connect_meta_ads. Ele retorna um link de autorização de uso único vinculado à sua conta; nada está conectado ainda nesta etapa.
2. Abra o link. O link é válido por uma hora. Abra-o em um navegador no qual você esteja conectado como a pessoa que tem acesso à conta do Meta.
3. Conceda o acesso. Aprove as permissões solicitadas na tela do Meta. Essa é a tela de consentimento do próprio Meta, então o login acontece lá, não conosco.
4. Selecione uma conta. Suas contas são listadas após a autorização. Marque as que você quer gerenciar e salve; todas as operações seguintes são executadas na conta que você escolheu.
5. Confirme. list_meta_ad_accounts retorna as contas de anúncios conectadas.

Permissões solicitadas

• ads_read
• ads_management
• pages_show_list
• pages_read_engagement

Nada além desta lista é solicitado, e o token é armazenado criptografado. Se você recusar qualquer permissão na tela de consentimento, o fluxo é interrompido e nenhum token é gravado.

Observações

• O Meta Ads está disponível em todos os planos, sem custo extra.
• A Meta emite um token de 60 dias (não há refresh token); quando ele expira, você reconecta com a mesma ferramenta.
• Durante a autorização, selecione TODAS as contas de anúncios que você quer gerenciar, pois a Meta concede acesso com base nas contas selecionadas no login.
• Todo anúncio é veiculado em nome de uma Página do Facebook; suas páginas são listadas com list_meta_pages.

Solução de problemas

Há algo que a Meta não permite fazer?

Uma coisa: baixar pela API os envios de um formulário instantâneo. Isso exige a permissão separada leads_retrieval da Meta, que ainda está em análise pela Meta; até lá, baixe os leads pelo Gerenciador de Anúncios da Meta. Criar novos formulários de leads, anexar formulários a anúncios e executar o restante da campanha funcionam normalmente. Se você conectou a Meta antes de 6 de setembro de 2026, reconecte uma vez para que a permissão de criação de formulários seja adicionada.

Por que o token da Meta precisa ser renovado a cada 60 dias?

A Meta emite um token de longa duração, mas sem refresh token; por isso, quando ele expira, você executa novamente a mesma ferramenta de conexão para renovar a autorização. É uma regra da Meta, não uma escolha nossa.

Por que a tela diz que contas de anúncios exigem o plano Pro ou Agência?

Essa mensagem só aparece em contas com plano WordPress, que não inclui contas de anúncios. Ao migrar para o Pro ou Agência, a mesma ferramenta de conexão funciona sem nenhuma alteração.

Por que o link diz que a conexão é inválida ou expirou?

Um link de autorização expira uma hora após ser gerado e só pode ser usado uma vez; abrir um link que já foi usado gera o mesmo erro. Execute a ferramenta de conexão novamente e você receberá um novo link para continuar.

Selecionei várias contas, mas só uma foi salva. Por quê?

Os planos Grátis e Pro conectam uma conta de anúncios por plataforma; gerenciar várias é um recurso do plano Agência. Mesmo que você marque mais de uma na tela de seleção, apenas a primeira é mantida ao salvar. Para trabalhar como agência, é preciso fazer upgrade do plano; depois disso, você atualiza a seleção pelo seletor de contas do painel, que reutiliza o token armazenado, então você nunca precisa autorizar de novo.

Autorizei com o usuário errado. O que acontece?

O acesso armazenado se limita às contas que o usuário autorizador consegue ver; uma conta que esse usuário não alcança também não fica visível para nós. Desconecte pelo painel e conecte novamente com o usuário correto, e o token antigo será excluído.

Desconexão

Abra o painel, encontre o Meta em plataformas conectadas e escolha desconectar. O token armazenado é excluído imediatamente, não apenas ocultado, então não conseguimos mais acessar a conta. Reconectar depois significa executar connect_meta_ads novamente e passar pela autorização do zero. Desconectar não exclui nada dentro da sua conta do Meta.

→ lista completa de ferramentas do Meta