Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Guia da API do Instagram para 2026: da aplicação à primeira publicação

Em 2026, a API do Instagram leva uma aplicação à primeira publicação em seis passos: uma conta profissional, uma configuração de login, uma aplicação Meta, permissões com o nível de acesso certo, um token de acesso e, depois, um contentor multimédia criado com POST /<IG_ID>/media e publicado com media_publish. Comentários, mensagens diretas, webhooks, estatísticas e os limites da Meta vêm depois. Para aplicações novas, a Meta recomenda o Unified Login.

O easyCoexistence transforma os passos 2 a 5 num único início de sessão com o Instagram: a sua aplicação Meta executa o login, renova o token antes de expirar e verifica a conta de 6 em 6 horas, enquanto o Claude, o ChatGPT ou a sua própria plataforma publica, agenda, responde a comentários e mensagens diretas e lê as estatísticas através da API oficial da Meta.

3 setups

Unified Login, recomendado para novas integrações, e Instagram Login e Facebook Login, mantidos para as existentes.

New apps

As aplicações Meta criadas de novo não podem configurar a API do Instagram com Instagram Login, segundo o guia de migração da Meta.

60 days

Quanto dura um token de acesso de utilizador do Instagram de longa duração, que pode ser renovado a partir de um dia de idade.

100 posts

Publicações feitas pela API que uma conta pode fazer num período móvel de 24 horas, contando um carrossel como uma.

2 to 3 days

Quanto costuma demorar a App Review, segundo a Meta; normalmente processa um pedido em menos de uma semana.

Quais são os passos desde uma aplicação nova até à primeira publicação?

São seis os passos até à primeira publicação, e quatro outros definem o que a aplicação faz depois. A conta tem de ser profissional, a aplicação escolhe uma das três configurações de login da Meta, o titular da conta concede as permissões e o servidor da aplicação guarda um token. Depois, publicar faz-se com duas chamadas. Comentários, mensagens diretas, webhooks, estatísticas e limites seguem-se, e as últimas secções indicam a página que trata cada passo em pormenor.

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

Passo 1: que conta do Instagram funciona com a API?

Uma conta profissional, comercial ou de criador. A Instagram Platform da Meta serve apenas contas profissionais, e os dois tipos funcionam da mesma forma para publicar, comentar, enviar mensagens diretas e consultar estatísticas. Uma conta pessoal muda na aplicação do Instagram, em Tipo de conta e ferramentas, e uma conta privada passa a pública ao fazê-lo. O Instagram Login e o Unified Login não exigem uma Página associada, enquanto o Facebook Login exige uma.

Passo 2: que configuração de login deve usar a aplicação?

A Meta documenta três, e a escolha fixa o domínio, 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 indica que as novas funcionalidades da API do Instagram são lançadas apenas aí, e o guia de migração diz que as aplicações criadas de novo não podem configurar o Instagram Login. As integrações existentes com Instagram Login continuam a funcionar, sem data de fim anunciada.

  • Unified Login: o cliente inicia sessão com o Instagram ou através do Facebook Login, escolhe um portefólio empresarial, e a aplicação recebe um token Business Integration System User.
  • Instagram Login: o titular inicia sessão com o Instagram, e as chamadas seguem para graph.instagram.com com um token de utilizador do Instagram e as permissões instagram_business_*.
  • Facebook Login: a conta tem de estar ligada a uma Página que a pessoa possa gerir, com as permissões instagram_* e as de Página.

Passo 3: como se cria a aplicação Meta?

No painel da aplicação, seguindo um percurso que depende da configuração. O guia do Unified Login da Meta parte de uma aplicação com o caso de uso Manage messaging & content on Instagram, pertencente a um portefólio empresarial. Em Configuração da API com Unified login, a aplicação cria uma configuração, cujo config_id indica as permissões e os recursos a pedir, guarda um URL de redirecionamento HTTPS e copia o URL de início de sessão. Uma aplicação Instagram Login já existente mantém a Configuração da API com Instagram login, onde estão o ID e o segredo da aplicação do Instagram.

Passo 4: que permissões e que nível de acesso precisa a aplicação?

Uma permissão por funcionalidade, concedida pelo titular da conta no início de sessão. 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 predefinido, abrange contas que a aplicação possui ou gere e pessoas com uma função na aplicação. Servir contas de outras empresas exige o Advanced Access, concedido permissão a permissão através da App Review, com a Verificação da empresa.

Passo 5: como é que a aplicação obtém um token de acesso?

A partir do início de sessão do titular, trocado no servidor e nunca num navegador ou numa aplicação móvel. Com o Instagram Login, o redirecionamento traz um código válido durante uma hora e utilizável uma só vez; transforma-se num token de curta duração e depois num de longa duração, que dura 60 dias e pode ser renovado a partir de um dia de idade. Com o Unified Login, o código torna-se um token Business Integration System User, cuja validade depende da configuração.

Passo 6: como se publica uma primeira publicação?

Com duas chamadas. POST /<IG_ID>/media com um image_url público, que a Meta obtém por si própria, cria um contentor; POST /<IG_ID>/media_publish com o ID desse contentor como creation_id publica-o e devolve o ID do conteúdo. As imagens têm de ser JPEG. Para um Reel ou outro vídeo, verifique o status_code do contentor até indicar FINISHED, pois publicar antes disso falha.

A first photo post with Instagram Login
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 os comentários e as mensagens diretas?

Ambos começam com outra pessoa. GET /<IG_MEDIA_ID>/comments devolve até 50 comentários de primeiro nível por pedido, POST /<IG_COMMENT_ID>/replies responde a um deles publicamente, e uma resposta privada envia ao autor do comentário uma única mensagem direta no prazo de 7 dias após o comentário. As mensagens diretas são enviadas a pessoas que escreveram primeiro, dentro de uma janela predefinida de 24 horas para a maioria das ações, depois de o titular ativar Permitir acesso às mensagens na aplicação do Instagram.

Passo 8: como é que os webhooks indicam à aplicação o que aconteceu?

A Meta envia um JSON por POST para um endpoint HTTPS, que se valida uma vez ao devolver o hub.challenge, e assina cada evento no X-Hub-Signature-256 com um HMAC-SHA256 do payload, com chave no segredo da aplicação. A aplicação seleciona campos como comments e messages no painel da aplicação e, depois, subscreve cada conta através da aresta subscribed_apps. As notificações chegam apenas às aplicações em modo Live, e as notificações de comentários exigem o Advanced Access.

Passo 9: como lê a aplicação as estatísticas?

A partir de duas arestas: GET /<IG_ID>/insights para a conta e GET /<IG_MEDIA_ID>/insights para uma publicação, Reel ou Story. As 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 refere que os dados podem atrasar até 48 horas.

Que limites condicionam a aplicação?

A Meta define os seus principais limites por conta, pelo que uma conta nova traz a sua própria quota em vez de partilhar uma:

  • Chamadas: 4,800 vezes as impressões da conta num período móvel de 24 horas, por aplicação e conta, excluindo mensagens.
  • Publicação: 100 publicações feitas pela API e 400 contentores multimédia por conta em 24 horas.
  • Mensagens: 100 chamadas da Send API por segundo para texto, e 750 respostas privadas por hora em publicações e Reels.
  • Contentores: um contentor não publicado durante 24 horas expira e tem de ser criado de novo.

Que página cobre cada passo em pormenor?

Cada passo tem uma página de referência própria nestes documentos, com os campos, erros e casos limite que este guia deixa de fora. Os caminhos abaixo estão sob o endereço do site, e a página de código mostra as chamadas de publicação, comentários, estatísticas e webhooks em Python e Node.js, lado a lado:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

Qual é o percurso através do easyCoexistence?

Um único início de sessão em vez dos passos 2 a 5 e da configuração dos webhooks. No painel, escolha Nova ligação, depois Instagram, inicie sessão com a conta Business ou Creator e aprove as suas cinco permissões instagram_business_*; a aplicação Meta do easyCoexistence executa o início de sessão, renova o token e verifica a conta de 6 em 6 horas. O Claude, o ChatGPT ou o seu próprio agente trabalha através de https://easycoexistence.com/api/mcp, o seu código pode obter o ID da conta e a base da API a partir de get_social_credentials, e as publicações podem ser agendadas com até 90 dias de antecedência a partir da fila do easyCoexistence.

Erros comuns

  • Começar uma aplicação nova com o Instagram Login. O guia de migração da Meta diz que as aplicações criadas de novo não o podem configurar, e a visão geral recomenda o Unified Login para novas integrações.
  • Chamar uma integração Unified Login com um token de utilizador do Instagram. O guia de webhooks da Meta diz que esses tokens e graph.instagram.com não funcionam com o Unified Login.
  • Publicar um contentor de vídeo logo a seguir à criação. media_publish falha com o subcódigo 2207027 enquanto o status_code do contentor não indicar FINISHED.
  • Consultar comentários e mensagens diretas em ciclo. A Meta recomenda webhooks, que reduzem as chamadas feitas pela aplicação e o risco de atingir o limite de pedidos.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Quanto tempo demora a ter acesso à API do Instagram?

Para contas que possui ou gere, sem espera: o Standard Access funciona desde o início. Servir outras empresas exige a App Review, que a Meta diz demorar normalmente menos de uma semana, e a Verificação da empresa.

Uma aplicação Meta nova ainda pode usar o Instagram Login?

Não, segundo o guia de migração da Meta, que diz que as aplicações criadas de novo não o podem configurar. As integrações existentes com Instagram Login continuam a funcionar, e a Meta não anunciou data de fim.

A API pode publicar um ficheiro do meu computador?

Não com o Instagram Login, em que a Meta obtém cada imagem ou vídeo a partir de um URL público. A Meta documenta carregamentos retomáveis, que aceitam um ficheiro 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 ligação: US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em