[ajuda] conexões

Instagram e Facebook do zero: conta profissional, app da Meta, Análise do App e token

Deixe o Instagram como conta profissional e pública. Em developers.facebook.com, crie um app do tipo Business, adicione o produto Instagram e gere o token na tela API setup with Instagram login. Cole o token e o ID da conta na Central de Conexões, no cartão Instagram e Facebook: postar e ler números da sua própria conta já funciona. Para o robô responder Direct e comentário de qualquer pessoa, a Meta exige empresa verificada, Análise do App aprovada e app Ao vivo, e isso leva dias ou semanas.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

O AFK não publica na Página do Facebook pela API. Para o Facebook, ele entrega a imagem e a legenda prontas, e você agenda no Meta Business Suite. Sem este cartão, o Instagram segue esse mesmo caminho manual.

Antes: grátis, mas com aprovação

Sua conta (postar e ler números)Responder o público (Direct e comentário)
PreçoGrátisGrátis
Precisa de Análise do AppNãoSim, com Acesso Avançado
Precisa de empresa verificadaNãoSim
App Ao vivoNãoSim
Quem recebe resposta antes da aprovação—Só contas com função no app (testadoras)
PrazoNo mesmo diaVerificação da empresa: até 14 dias úteis. Análise do App: a Meta não publica prazo.

As páginas oficiais da Meta não citam cobrança pelo uso da API. A Meta limita os posts feitos por API: a própria documentação cita 100 posts em 24 horas num trecho e 50 em outro. Para um negócio pequeno, sobra. As regras podem mudar: confira em developers.facebook.com/docs/instagram-platform.

Modo desenvolvimento não é solução para atender cliente. Nele, o robô só responde contas que você cadastrou como testadoras. Seguidor comum não recebe nada.

Parte 1: deixar o Instagram profissional e público

  1. No app do Instagram, toque na sua foto do perfil, no canto inferior direito.
  2. Toque no menu para abrir Configurações e atividade.
  3. Em Para profissionais, toque em Tipo de conta e ferramentas e depois em Mudar para conta profissional.
  4. Escolha a categoria e o tipo: Empresa (loja, negócio local, serviço) ou Criador de conteúdo. Os dois funcionam com o AFK.
  5. A conta profissional fica pública. Deixe assim: a Meta só libera token para conta pública, e comentário de conta privada não chega ao robô.
  6. Ligar a uma Página do Facebook é opcional neste caminho. O login do Instagram não precisa de Página.

Parte 2: ligar a verificação em duas etapas

A conta da Meta vai guardar o app que posta em seu nome. Proteja antes de criar.

  1. No Facebook, clique na sua foto, no canto superior direito → Configurações e privacidade → Configurações.
  2. Clique em Central de Contas → Senha e segurança → Autenticação de dois fatores.
  3. Escolha a conta e o método app de autenticação (o mesmo do GitHub serve). O SMS funciona, mas o app é mais seguro.
  4. Guarde os códigos de recuperação fora do computador.
  5. Faça o mesmo para o Instagram, na mesma Central de Contas, se ele estiver separado.

Parte 3: virar desenvolvedor e criar o app

O painel de desenvolvedor da Meta costuma aparecer em inglês. Os nomes abaixo estão como aparecem na tela.

  1. Entre no Facebook e abra developers.facebook.com/async/registration. Aceite os termos, digite o código que chega no seu celular e no seu e-mail e escolha a profissão.
  2. Abra developers.facebook.com/apps e clique em Create App.
  3. Siga as telas:
    • Use case: escolha Other e clique em Next.
    • App type: escolha Business e clique em Next. Só o tipo Business aceita o produto Instagram.
    • App name: por exemplo Minha Empresa AFK. Contact email: o e-mail que você lê.
    • Se perguntar a empresa (business portfolio), pode ligar agora ou depois, em App settings → Basic. Para responder o público, ela vai precisar estar verificada (parte 6).
  4. No painel do app, role até o produto Instagram e clique em Set up. A tela API setup with Instagram login entra sozinha.

Se a sua conta já está ligada a uma Página e você prefere o login do Facebook, a Meta oferece API setup with Facebook login. O AFK aceita os dois tokens. Este guia segue o login do Instagram, que não precisa de Página.

Parte 4: gerar o token e pegar o ID

  1. No menu da esquerda, abra Instagram → API setup with Instagram login.
  2. Na parte de gerar tokens, adicione a sua conta do Instagram e entre com ela quando pedir.
  3. Clique em Generate token ao lado da conta. Na tela de login do Instagram, aceite as permissões:
    • instagram_business_basic: obrigatória.
    • instagram_business_content_publish: postar.
    • instagram_business_manage_insights: números dos posts.
    • instagram_business_manage_messages: Direct (só para o robô).
    • instagram_business_manage_comments: comentários (só para o robô).
  4. Copie o token. Ele aparece uma vez só e costuma começar com IG. O token gerado nesta tela vale 60 dias.
  5. Copie o ID da conta: é o número que aparece junto do nome da conta, na mesma tela. Ele tem só números.
  6. Para o robô de Direct e comentário, pegue também a chave secreta: em 3. Set up Instagram business login → Business login settings, copie o Instagram app secret. Atenção: é a chave do app do Instagram, diferente da chave do app da Meta em App settings → Basic.

Parte 5: colar no AFK

No painel do AFK, abra Conexões, clique no cartão Instagram e Facebook, cole em Token de acesso (longa duração), em ID da conta profissional do Instagram e, se for usar o robô, em Chave secreta do app do Instagram (Instagram app secret). Clique em Salvar conexão e depois em Testar. Deu certo quando aparece o seu @.

Pronto: postar e ler números da sua conta já funcionam.

Parte 6: liberar o robô para responder o público

Faça esta parte só se quiser respostas automáticas no Direct e nos comentários. O painel guia cada passo em Respostas automáticas → Ligar canais.

  1. Ligue o robô 24h. Ele roda na sua Cloudflare, no plano grátis: veja Cloudflare do zero: conta, 2FA, token do robô 24 horas e o seu domínio. Em Ligar canais, clique em Atualizar o robô com as chaves.
  2. Configure o webhook na Meta. Em API setup with Instagram login, na parte de webhooks, clique em Configure, cole o Endereço do webhook e a Senha de verificação que o painel mostra, e clique em Save. Assine messages e comments. Volte ao painel e clique em Ativar recebimento.
  3. Teste com uma conta testadora. Adicione uma segunda conta do Instagram em App Roles → Roles. Mande um Direct e comente a palavra num post: a resposta já chega para ela.
  4. Verifique a empresa. No Meta Business Suite, abra a Central de Segurança e clique em Iniciar verificação. Precisa de controle total do portfólio empresarial. Preencha razão social, endereço, telefone e site exatamente como no CNPJ; se a Meta não achar o registro, ela pede documento oficial, como alvará ou contrato social. A decisão leva até 14 dias úteis.
  5. Preencha o app. Em App settings → Basic: ícone (1024 x 1024), categoria, URL da política de privacidade e URL de exclusão de dados. O robô já serve essas duas páginas com o nome da sua empresa: copie em Respostas automáticas → Páginas que a Meta pede.
  6. Peça a Análise do App. Em API setup with Instagram login, abra a seta de Complete app review, clique em Continue to app review e depois em Edit. A Meta pede:
    • instruções passo a passo para o revisor testar;
    • para cada permissão, um texto de uso e um vídeo de tela mostrando o uso, de preferência com a tela em inglês ou com legenda;
    • pelo menos uma chamada que deu certo com cada permissão (o teste do passo 3 conta).

      O texto pronto e o roteiro do vídeo estão em Respostas automáticas → Pedido de aprovação (Análise do App). Ou diga ao AFK: "me ajuda a pedir a aprovação da Meta". Peça só o que vai usar: instagram_business_manage_messages e instagram_business_manage_comments. Permissão pedida sem uso leva recusa.

  7. Espere. A Meta não publica prazo. Na prática, leva de dias a semanas, e pode voltar pedindo ajuste. Enquanto isso, atenda pelo WhatsApp (veja WhatsApp: API oficial da Meta ou QR Code).
  8. Aprovado: ponha o app Ao vivo. No painel do app, mude o modo do app de desenvolvimento para Live. Mande um Direct de uma conta comum para conferir.

No dia a dia

Você querComo
Postar um post aprovadoDiga ao AFK "aprova o post do tema X". Ele sobe as imagens no site e posta no Instagram.
Ver seguidores e postsAbra Criação no painel. A Meta é lida a cada dia que você abre; cada dia vira um ponto do gráfico.
Saber qual formato rendeu maisDiga ao AFK "importa os números dos posts". Ele traz visualizações, alcance, salvos e comentários de cada post.
Criar uma resposta automáticaRespostas automáticas → Regras. Ex.: comentou "EBOOK" → recebe o material no Direct.
Trocar o token que venceuVolte à parte 4, clique em Generate token de novo e cole por cima na Central de Conexões.
Saber se a conexão caiuA Central de Conexões confere sozinha de tempos em tempos e avisa quando um token que funcionava para de funcionar.

O token vale 60 dias e o AFK não renova sozinho. Anote a data na agenda e gere outro uns dias antes.

Erros e soluções

O que apareceO que fazer
Preencha o ID numérico da conta antes de testar.Cole o ID da parte 4, passo 5. Só números, sem @.
Error validating access token: Session has expired (código 190)O token venceu. Gere outro (parte 4) e cole por cima.
Invalid OAuth access token - Cannot parse access token (código 190)O token foi copiado pela metade ou com espaço. Copie de novo, inteiro.
(#10) Application does not have permission for this actionFaltou aceitar uma permissão no Generate token. Gere o token de novo e aceite todas da parte 4.
A Meta recusou a conexão na tela CriaçãoLeia o motivo ao lado e abra Conexões → Instagram e Facebook → Testar. Quase sempre é token vencido.
The media could not be fetched from this uriA imagem não está num endereço público. Confira se o site publicou as imagens e tente de novo.
The image format ... is not supportedO Instagram só aceita imagem JPEG pela API. Diga ao AFK: "converte as imagens para JPEG e posta de novo".
The submitted image with aspect ratio ... cannot be publishedA proporção tem que ficar entre 4:5 (em pé) e 1,91:1 (deitada).
The media is not ready for publishing, please wait for a momentO vídeo ainda está processando. Espere um minuto e peça de novo.
Your post won't work as a carouselO carrossel precisa de no mínimo 2 imagens.
You reached maximum number of posts that is allowed to be published by Content Publishing API.Limite do dia atingido. Tente amanhã.
The Instagram account is restricted.Abra o app do Instagram e resolva o aviso que ele mostrar.
Legenda recusada por tamanhoMáximo de 2.200 caracteres e 30 hashtags.
O robô responde você, mas não responde clienteO app ainda está em desenvolvimento ou sem Acesso Avançado. Só testadoras recebem. Faça a parte 6 até o fim.
Direct e comentário não chegam nem para a testadoraConfira o Instagram app secret (não a chave do app da Meta), clique em Atualizar o robô com as chaves e depois em Conferir webhook. A conta tem que estar pública.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o token nem a chave secreta.


Fontes oficiais (conferido em 30/10/2026): developers.facebook.com/documentation/instagram-platform/create-an-instagram-app (use case Other, app Business, produto Instagram, conta pública, webhooks, permissões da Análise do App) · developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login (conta profissional Empresa ou Criador, sem Página do Facebook) · developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/get-started (Generate token no painel; token do painel vale 60 dias) · developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/business-login (Instagram app secret em Business login settings; renovar por mais 60 dias) · developers.facebook.com/documentation/instagram-platform/app-review (Acesso Padrão para a própria empresa; texto, vídeo e chamada de teste por permissão) · developers.facebook.com/documentation/instagram-platform/webhooks/setup (app Live, Acesso Avançado e empresa verificada para receber Direct e comentário; conta privada não recebe) · developers.facebook.com/docs/graph-api/overview/access-levels (Acesso Padrão só vale para quem tem função no app; Acesso Avançado exige verificação da empresa) · developers.facebook.com/documentation/instagram-platform/insights (instagram_business_manage_insights no login do Instagram) · developers.facebook.com/documentation/instagram-platform/content-publishing (mídia em endereço público, só JPEG, limite de posts em 24 horas) · developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/error-codes (mensagens de erro de publicação) · developers.facebook.com/docs/graph-api/guides/error-handling (código 190 token vencido, código 10 permissão) · developers.facebook.com/documentation/development/register (inscrição de desenvolvedor) · facebook.com/business/help/2058515294227817 (verificação na Central de Segurança, até 14 dias úteis) · help.instagram.com/502981923235522 (mudar para conta profissional) · facebook.com/help/148233965247823 (autenticação de dois fatores).

ainda não tem o AFK?

Com o Instagram ligado, o AFK posta o carrossel que você aprovou e lê seguidores e números dos posts sozinho.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.