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.
Unified Login, recomendado para novas integrações, e Instagram Login e Facebook Login, mantidos para as existentes.
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.
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.
Publicações feitas pela API que uma conta pode fazer num período móvel de 24 horas, contando um carrossel como uma.
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.
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.
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:
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.
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