Central de Ajuda

Guias

Passo a passo para operar a plataforma — conexão de contas, anúncios e tokens

Todas as contas são centralizadas na BM Percus

Para simplificar a gestão, todas as contas conectadas na plataforma ficam vinculadas exclusivamente à Business Manager Percus (BM Percus). O cliente não nos entrega senha nem cria token sozinho: ele apenas adiciona a Percus como Parceiro no Gerenciador de Negócios dele e atribui os ativos (Página, Instagram e conta de anúncios). A partir daí a Percus gera e renova os tokens por um único lugar, sem depender de cada cliente.

ID da BM Percus:3128726640689310

Como conectar as contas de um cliente

1

O cliente adiciona a Percus como Parceiro

No Gerenciador de Negócios dele (business.facebook.com) → Configurações do negócio → Usuários → Parceiros → "Adicionar" → "Dar acesso a ativos a um parceiro".

  • No campo de ID do parceiro, informar o ID da BM Percus: 3128726640689310.
2

Atribuir os ativos à Percus

Ainda na tela de parceiro, marcar e conceder acesso aos ativos do cliente:

  • Página do Facebook
  • Conta do Instagram (perfil profissional/comercial)
  • Conta de anúncios (ver bloco abaixo)
3

A Percus adiciona os ativos ao Usuário do Sistema e gera o token

No Gerenciador de Negócios da Percus → Usuários → Usuários do sistema → selecionar o Usuário do Sistema (ex.: "SocialMidia Automation") → "Adicionar ativos" e incluir a Página, o Instagram e a conta de anúncios do cliente. IMPORTANTE: sem adicionar o ativo (a Página) aqui, o token NÃO enxerga a conta. Só então "Gerar novo token".

  • Adicionar a Página + Instagram + conta de anúncios ao Usuário do Sistema (passo obrigatório)
  • Gerar o token — Usuário do Sistema não expira (recomendado) ou long-lived 60 dias
  • Capturar Page ID (392471…), IG Business Account ID (17841…), Ad Account ID (act_…)
4

Cadastrar a conexão na plataforma

Configurações → Conexões de Plataformas → "Nova Conexão". Preencher Cliente, Plataforma, Account ID, Access Token, validade e scopes → "Cadastrar Conexão".

5

Verificar

Na tabela de Conexões, usar o botão "Verificar" (Instagram/Facebook) para confirmar que o token é válido, ver a validade e os scopes liberados.

O que fazer na conta de anúncios

A conta de anúncios (Conta de Anúncios do Meta) é o que permite impulsionar posts, rodar campanhas pagas e puxar métricas. Ela também é atribuída à Percus como parceiro — assim a gestão fica no mesmo lugar das demais contas.

  • Atribuir a conta de anúncios ao parceiro Percus

    No Gerenciador de Negócios do cliente → Contas → Contas de anúncios → selecionar a conta → "Atribuir parceiro" → informar a BM Percus.

  • Definir o papel: Admin (Acesso total)

    Conceder à Percus o papel Admin / Acesso total na conta de anúncios — permite criar, editar e pausar campanhas e puxar métricas. (O papel Anunciante só roda campanha; o padrão da Percus é Admin.)

  • Método de pagamento: pago pelo cliente

    A conta de anúncios precisa de um método de pagamento ativo (cartão), e ele fica na conta do próprio cliente: quem paga os impulsionamentos/anúncios é o cliente. A Percus apenas opera as campanhas.

  • Anotar o Ad Account ID

    O ID começa com "act_" (ex.: act_123456789). É ele que a equipe usa ao gerar o token e configurar boost/anúncios.

Campos da "Nova Conexão" — onde pegar cada valor

CampoO que é / onde pegar
ClienteO cliente já cadastrado na plataforma a quem a conta pertence.
PlataformaInstagram, Facebook, LinkedIn, Twitter/X ou TikTok.
Account ID (Instagram)IG Business Account ID (17841…). Pegue em GET /me?fields=instagram_business_account ou /PAGE_ID?fields=instagram_business_account.
Account ID (Facebook)Page ID (392471…), exposto em /me/accounts ou nos granular_scopes do debug_token.
Access TokenToken long-lived (60 dias) gerado pela Percus, ou — recomendado — token do Usuário do Sistema da BM Percus, que não expira.
ValidadeOpcional. Data de expiração do token, para a plataforma alertar antes de vencer.
ScopesPermissões do token. Ex.: pages_manage_posts, pages_read_engagement, instagram_basic, instagram_content_publish, business_management, ads_management.

Validade e renovação dos tokens

Na tabela de Conexões de Plataformas, cada linha mostra um selo de validade: verde (ok), laranja (vence em até 2 semanas) e vermelho (vence em até 7 dias ou já venceu).

Token long-lived do Meta dura ~60 dias e precisa ser renovado. Por isso o caminho recomendado é o Usuário do Sistema da BM Percus: o token dele não expira, então não há re-cadastro periódico. Em ambos os casos, basta a Percus gerar o novo token e "Editar" a conexão colando o valor atualizado.

Precisa de algo que não está aqui? Fale com a equipe Percus.