Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

27 Jan 2025

Quando os antigos valores de âmbito business_* do Instagram Login foram descontinuados a favor dos nomes instagram_business_*.

Publishing

Exige instagram_business_basic e instagram_business_content_publish no Instagram Login.

Insights

Precisam de instagram_business_basic e instagram_business_manage_insights no Instagram Login.

Advanced

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.

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

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.
Fazer isto com a EasyCoexistence

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