Permissões da API do Instagram: os âmbitos por funcionalidade
A API do Instagram com o Instagram Login usa cinco permissões, concedidas pelo titular da conta no início de sessão: instagram_business_basic, obrigatória em conjunto com cada uma das outras, instagram_business_content_publish para publicar, instagram_business_manage_comments para comentários, respostas privadas e menções, instagram_business_manage_messages para mensagens diretas e instagram_business_manage_insights para métricas. Substituíram os antigos nomes business_* em 27 de janeiro de 2025, e servir contas que não possui nem gere exige Advanced Access, através de App Review.
A easyCoexistence pede as cinco permissões instagram_business_* quando liga uma conta do Instagram com o login do próprio Instagram, para que o Claude, o ChatGPT ou a sua própria plataforma possam publicar, agendar, responder a comentários e mensagens diretas e ler métricas através de um único conector MCP, com a ligação vigiada 24 horas por dia.
Quando os antigos valores de âmbito business_* do Instagram Login foram descontinuados a favor dos nomes instagram_business_*.
Exige instagram_business_basic e instagram_business_content_publish no Instagram Login.
Precisam de instagram_business_basic e instagram_business_manage_insights no Instagram Login.
Nível de acesso necessário para servir contas que o programador não possui nem gere; exige App Review.
Que permissão exige cada funcionalidade?
No Instagram Login, as chamadas de cada funcionalidade exigem instagram_business_basic mais uma permissão própria. instagram_business_basic é também o que a leitura dos conteúdos da conta exige, e a permissão que a Meta verifica antes de renovar um token de longa duração. A permissão de comentários é a que cobre mais terreno: ler, responder, ocultar e eliminar comentários, desativar os comentários, respostas privadas e menções.
Que permissões precisam os webhooks?
Os mesmos pares. No Instagram Login, os campos comments e live_comments exigem instagram_business_basic e instagram_business_manage_comments, e as menções chegam dentro da notificação de comentários. Os campos de mensagens, messages, message_reactions, messaging_postbacks, messaging_seen e messaging_referral entre eles, exigem instagram_business_basic e instagram_business_manage_messages.
Quais são os equivalentes no Facebook Login?
Os mesmos nomes sem business: instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights e instagram_manage_messages, juntamente com as permissões de Página pages_show_list e pages_read_engagement, porque se chega à conta através da sua Página do Facebook. Uma pessoa só pode concedê-las para as tarefas que consegue executar nessa Página.
O que aconteceu ao business_basic e aos outros nomes antigos?
Foram renomeados para corresponder aos nomes das permissões: business_basic passou a instagram_business_basic, e business_content_publish, business_manage_comments e business_manage_messages mudaram da mesma forma. Os valores antigos foram descontinuados em 27 de janeiro de 2025, e a Meta avisou que as aplicações que ainda os enviassem deixariam de conseguir chamar os endpoints do Instagram.
O que significam o Standard Access e o Advanced Access?
O Standard Access é o predefinido, pensado para contas que o programador possui ou gere e para pessoas com uma função na aplicação. O Advanced Access é necessário para servir contas profissionais de terceiros, e exige App Review e Business Verification. A Meta refere que algumas funcionalidades podem não funcionar corretamente até o Advanced Access ser concedido.
Até onde chega uma permissão concedida?
Apenas aos dados criados pela conta que a concedeu; a Meta refere alguns endpoints que devolvem dados que a conta não criou, de acesso limitado e público. Uma aplicação tem de pedir todas as permissões de que um endpoint precisa antes de o chamar, e o titular da conta aprova-as na janela de início de sessão.
Erros comuns
- Enviar os nomes antigos de âmbito. business_basic e os seus equivalentes foram descontinuados em 27 de janeiro de 2025; utilize os nomes instagram_business_*.
- Misturar as duas famílias. instagram_basic e as permissões pages_* pertencem ao Facebook Login, enquanto o Instagram Login usa os nomes instagram_business_*.
- Deixar de fora instagram_business_manage_insights. As chamadas de métricas precisam dela além de instagram_business_basic.
- Procurar uma permissão para menções. No Instagram Login, as menções funcionam com instagram_business_manage_comments.
De 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.
Perguntas frequentes
Que permissão exige a publicação no Instagram?
Com o Instagram Login, instagram_business_content_publish em conjunto com instagram_business_basic.
O instagram_basic é o mesmo que o instagram_business_basic?
Desempenham o mesmo papel em contextos diferentes: o instagram_basic pertence ao Facebook Login, e o instagram_business_basic ao Instagram Login.
As permissões do Instagram precisam de App Review?
Para servir contas que não possui nem gere, sim: isso exige Advanced Access, que requer App Review e Business Verification.
Que permissão cobre as respostas privadas?
Com o Instagram Login, instagram_business_manage_comments em conjunto com instagram_business_basic, o mesmo par que a moderação de comentários usa.
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