Permissões da API do Instagram: os escopos de cada recurso
A API do Instagram com o Instagram Login usa cinco permissões, concedidas pelo dono da conta no login: instagram_business_basic, obrigatória junto 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 DMs e instagram_business_manage_insights para insights. Elas substituíram os nomes antigos business_* em 27 de janeiro de 2025, e atender contas que você não possui nem gerencia exige Acesso Avançado, obtido pela Análise do App.
O easyCoexistence solicita as cinco permissões instagram_business_* quando você conecta uma conta do Instagram pelo login do próprio Instagram, para que Claude, ChatGPT ou a sua própria plataforma publiquem, agendem posts, respondam a comentários e DMs e leiam insights por um único conector MCP, com a conexão monitorada 24 horas por dia.
Quando os valores antigos de escopo business_* do Instagram Login foram descontinuados e substituídos pelos nomes instagram_business_*.
Exige instagram_business_basic e instagram_business_content_publish no Instagram Login.
Exigem instagram_business_basic e instagram_business_manage_insights no Instagram Login.
Nível de acesso necessário para atender contas que o desenvolvedor não possui nem gerencia; exige Análise do App.
De qual permissão cada recurso precisa?
No Instagram Login, as chamadas de cada recurso exigem instagram_business_basic mais uma permissão própria. A instagram_business_basic também é a permissão necessária para ler as mídias da conta e a que a Meta verifica antes de renovar um token de longa duração. A permissão de comentários é a mais abrangente: ler, responder, ocultar e excluir comentários, desativá-los, respostas privadas e menções.
De quais permissões os webhooks precisam?
Dos 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 comments. Os campos de mensagens, entre eles messages, message_reactions, messaging_postbacks, messaging_seen e messaging_referral, 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, junto com as permissões de Página pages_show_list e pages_read_engagement, porque a conta é acessada pela Página do Facebook vinculada a ela. Uma pessoa só pode concedê-las para as tarefas que tem permissão de executar nessa Página.
O que aconteceu com business_basic e os outros nomes antigos?
Eles foram renomeados para seguir o padrão dos nomes das permissões: business_basic virou 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 apps que continuassem a enviá-los não conseguiriam chamar os endpoints do Instagram.
O que significam Acesso Padrão e Acesso Avançado?
O Acesso Padrão é o nível inicial, voltado às contas que o desenvolvedor possui ou gerencia e às pessoas com uma função no app. O Acesso Avançado é necessário para atender contas profissionais de terceiros e exige Análise do App e Verificação da Empresa. A Meta avisa que alguns recursos podem não funcionar corretamente até que o Acesso Avançado seja concedido.
Até onde vai uma permissão concedida?
Somente aos dados criados pela conta que a concedeu; a Meta aponta alguns endpoints que retornam dados que a conta não criou, limitados e públicos. Um app precisa solicitar todas as permissões que um endpoint exige antes de chamá-lo, e o dono da conta as aprova na janela de login.
Erros comuns
- Enviar os nomes antigos de escopo. business_basic e os demais nomes da mesma família foram descontinuados em 27 de janeiro de 2025; use 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_*.
- Esquecer a instagram_business_manage_insights. As chamadas de insights exigem essa permissão além da instagram_business_basic.
- Procurar uma permissão específica para menções. No Instagram Login, as menções dependem da instagram_business_manage_comments.
De R$ 29,90 a R$ 3,90 por conexão por mês, com o valor caindo conforme você adiciona conexões, e 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
Qual permissão é necessária para publicar no Instagram pela API?
No Instagram Login, a instagram_business_content_publish junto com a instagram_business_basic.
instagram_basic é a mesma coisa que instagram_business_basic?
As duas cumprem o mesmo papel em configurações diferentes: a instagram_basic pertence ao Facebook Login, e a instagram_business_basic, ao Instagram Login.
As permissões do Instagram precisam passar pela Análise do App?
Para atender contas que você não possui nem gerencia, sim: isso exige Acesso Avançado, que depende da Análise do App e da Verificação da Empresa.
Qual permissão cobre as respostas privadas?
No Instagram Login, a instagram_business_manage_comments junto com a instagram_business_basic, o mesmo par usado na moderação de comentários.
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