Guia da API do Instagram para 2026: do seu app à primeira postagem
Em 2026, a API do Instagram leva um app à primeira postagem em seis passos: uma conta profissional, uma configuração de login, um app na Meta, permissões no nível de acesso certo, um token de acesso e, em seguida, um container de mídia criado com POST /<IG_ID>/media e publicado com media_publish. Comentários, DMs, webhooks, insights e os limites da Meta vêm depois. Para apps novos, a Meta recomenda o Unified Login.
O easyCoexistence transforma os passos 2 a 5 em um único login com o Instagram: seu app na Meta executa o login, renova o token antes que expire e verifica a conta a cada 6 horas, enquanto Claude, ChatGPT ou sua própria plataforma publica, agenda, responde comentários e DMs e lê insights pela API oficial da Meta.
O Unified Login é recomendado para novas integrações, além do Instagram Login e do Facebook Login, mantidos para as existentes.
Apps da Meta recém-criados não podem configurar a API do Instagram com o Instagram Login, segundo o guia de migração da Meta.
Por quanto tempo dura um token de acesso de longa duração do Instagram User; ele pode ser renovado depois de 24 horas.
Publicações via API que uma conta pode fazer em um período móvel de 24 horas, contando um carrossel como uma.
Quanto tempo a App Review costuma levar, segundo a Meta; ela normalmente analisa um envio em menos de uma semana.
Quais são os passos de um app novo até a primeira postagem?
Seis passos levam à primeira postagem, e quatro outros definem o que o app faz depois. A conta precisa ser profissional, o app escolhe uma das três configurações de login da Meta, o dono da conta concede permissões, e o servidor do app guarda um token. A publicação é então feita em duas chamadas. Comentários, DMs, webhooks, insights e limites vêm na sequência, e as últimas seções indicam a página que cobre cada passo por completo.
Passo 1: qual conta do Instagram funciona com a API?
Uma conta profissional, comercial ou de criador. A Instagram Platform da Meta atende apenas contas profissionais, e os dois tipos funcionam da mesma forma para publicação, comentários, DMs e insights. Uma conta pessoal muda no app do Instagram, em Tipo de conta e ferramentas, e uma conta privada passa a pública ao fazer isso. O Instagram Login e o Unified Login não exigem Página vinculada, enquanto o Facebook Login exige uma.
Passo 2: qual configuração de login o app deve usar?
A Meta documenta três, e a escolha define o host, o token e os nomes das permissões. A visão geral recomenda o Unified Login para novas integrações, a página do Unified Login diz que os novos recursos da API do Instagram são lançados apenas nele, e o guia de migração diz que apps recém-criados não podem configurar o Instagram Login. As integrações existentes com Instagram Login seguem funcionando, sem data de encerramento anunciada.
- Unified Login: o cliente entra com o Instagram ou pelo Facebook Login, escolhe um Portfólio de Negócios, e o app recebe um token de Business Integration System User.
- Instagram Login: o dono entra com o Instagram, e as chamadas vão para graph.instagram.com com um token de Instagram User e as permissões instagram_business_*.
- Facebook Login: a conta precisa estar vinculada a uma Página que a pessoa possa gerenciar, com as permissões instagram_* e de Página.
Passo 3: como o app da Meta é criado?
No App Dashboard, por um caminho que depende da configuração. O guia do Unified Login da Meta parte de um app com o caso de uso Manage messaging & content on Instagram, pertencente a um Portfólio de Negócios. Em API setup with Unified login, o app cria uma configuração cujo config_id define as permissões e os ativos a solicitar, salva uma URL de redirecionamento HTTPS e copia a URL de login. Um app existente de Instagram Login mantém o API setup with Instagram login, onde ficam seu ID e segredo de app do Instagram.
Passo 4: quais permissões e nível de acesso o app precisa?
Uma permissão por recurso, concedida pelo dono da conta no login. O Unified Login usa a família instagram_*, como instagram_content_publish e instagram_manage_comments, e o Instagram Login usa os nomes instagram_business_*. O Standard Access, o padrão, cobre contas que você possui ou gerencia e pessoas com um papel no app. Atender contas de outras empresas exige Advanced Access, concedido permissão por permissão pela App Review, com Business Verification.
Passo 5: como o app obtém um token de acesso?
A partir do login do dono, trocado no servidor e nunca no navegador ou em um app mobile. Com o Instagram Login, o redirecionamento traz um código válido por uma hora e usável uma única vez; ele vira um token de curta duração e depois um de longa duração, que dura 60 dias e pode ser renovado quando tiver um dia. Com o Unified Login, o código vira um token de Business Integration System User, cuja validade depende da configuração.
Passo 6: como publicar a primeira postagem?
Com duas chamadas. POST /<IG_ID>/media, com uma image_url pública que a Meta busca por conta própria, cria um container; POST /<IG_ID>/media_publish, com o ID desse container como creation_id, publica e devolve o ID da mídia. As imagens devem ser JPEG. Para um Reel ou outro vídeo, verifique o status_code do container até ele mostrar FINISHED, pois publicar antes falha.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }Passo 7: como funcionam comentários e DMs?
Ambos começam com outra pessoa. GET /<IG_MEDIA_ID>/comments retorna até 50 comentários de primeiro nível por requisição, POST /<IG_COMMENT_ID>/replies responde um deles publicamente, e uma resposta privada envia ao autor do comentário uma única DM em até 7 dias após o comentário. As DMs vão para quem escreveu primeiro, dentro de uma janela de atendimento de 24 horas para a maioria das ações, depois que o dono ativa Allow access to messages no app do Instagram.
Passo 8: como os webhooks informam ao app o que aconteceu?
A Meta envia um POST em JSON a um endpoint HTTPS, que comprova a própria validade uma vez ecoando hub.challenge, e assina cada evento em X-Hub-Signature-256 com um HMAC-SHA256 do payload, usando o segredo do app como chave. O app seleciona campos como comments e messages no App Dashboard, depois assina cada conta pelo edge subscribed_apps. As notificações chegam apenas a apps no modo Live, e as de comentários exigem Advanced Access.
Passo 9: como o app lê os insights?
A partir de dois edges: GET /<IG_ID>/insights para a conta e GET /<IG_MEDIA_ID>/insights para uma postagem, Reel ou Story. Métricas da conta, como reach, views e accounts_engaged, usam period=day com metric_type=total_value. views substituiu impressions em 2025, algumas métricas exigem pelo menos 100 seguidores, e a Meta observa que os dados podem atrasar até 48 horas.
Passo 10: quais limites moldam o app?
A Meta define seus principais limites por conta, então uma conta nova traz sua própria cota em vez de dividir uma:
- Chamadas: 4.800 vezes as impressões da conta em 24 horas móveis, por app e conta, excluindo mensagens.
- Publicação: 100 postagens via API e 400 containers de mídia por conta em 24 horas.
- Mensagens: 100 chamadas da Send API por segundo para texto, e 750 respostas privadas por hora em posts e Reels.
- Containers: um não publicado por 24 horas expira e precisa ser criado de novo.
Qual página cobre cada passo em detalhe?
Cada passo tem uma página de referência própria nesta documentação, com os campos, erros e casos extremos que este guia deixa de fora. Os caminhos abaixo ficam sob o endereço do site, e a página de código mostra as chamadas de publicação, comentários, insights e webhooks em Python e Node.js, lado a lado:
Qual é o caminho pelo easyCoexistence?
Um único login no lugar dos passos 2 a 5 e da configuração de webhooks. No painel, escolha Nova conexão, depois Instagram, entre com a conta Business ou Creator e aprove suas cinco permissões instagram_business_*; o app da Meta do easyCoexistence executa o login, renova o token e verifica a conta a cada 6 horas. Claude, ChatGPT ou seu próprio agente então trabalha por https://easycoexistence.com/api/mcp, seu código pode obter o ID da conta e a base da API em get_social_credentials, e as postagens podem ser agendadas com até 90 dias de antecedência pela fila do easyCoexistence.
Erros comuns
- Começar um app novo com o Instagram Login. O guia de migração da Meta diz que apps recém-criados não podem configurá-lo, e a visão geral recomenda o Unified Login para novas integrações.
- Chamar uma integração de Unified Login com um token de Instagram User. O guia de webhooks da Meta diz que esses tokens e o graph.instagram.com não funcionam com o Unified Login.
- Publicar um container de vídeo logo em seguida. media_publish falha com o subcode 2207027 até o status_code do container mostrar FINISHED.
- Fazer polling de comentários e DMs. A Meta recomenda webhooks, que reduzem as chamadas do app e o risco de ser limitado por taxa.
De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Quanto tempo leva para ter acesso à API do Instagram?
Para contas que você possui ou gerencia, sem espera: o Standard Access funciona desde o início. Atender outras empresas exige App Review, que a Meta diz levar normalmente menos de uma semana, e Business Verification.
Um app novo da Meta ainda pode usar o Instagram Login?
Não, segundo o guia de migração da Meta, que diz que apps recém-criados não podem configurá-lo. As integrações existentes com Instagram Login seguem funcionando, e a Meta não anunciou data de encerramento.
A API pode publicar um arquivo do meu computador?
Não com o Instagram Login, em que a Meta busca cada imagem ou vídeo em uma URL pública. A Meta documenta uploads retomáveis, que aceitam um arquivo de vídeo local, para configurações construídas sobre o Facebook Login for Business, incluindo o Unified Login.
Quanto custa o easyCoexistence para uma conta do Instagram?
Cada conta do Instagram é uma conexão: de US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em