EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

27 Jan 2025

Quando os valores antigos de escopo business_* do Instagram Login foram descontinuados e substituídos pelos nomes instagram_business_*.

Publishing

Exige instagram_business_basic e instagram_business_content_publish no Instagram Login.

Insights

Exigem instagram_business_basic e instagram_business_manage_insights no Instagram Login.

Advanced

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.

Publishinginstagram_business_content_publish
Commentsinstagram_business_manage_comments
Private repliesinstagram_business_manage_comments
Mentionsinstagram_business_manage_comments
DMsinstagram_business_manage_messages
Insightsinstagram_business_manage_insights

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.
Fazendo isso com o EasyCoexistence

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