Visão geral
A Graph API do Instagram é uma coleção de pontos de extremidade da Graph API do Facebook que permite aos apps acessarem dados em contas profissionais do Instagram (sejam empresariais ou de criadores de conteúdo). Caso você não conheça a Graph API do Facebook, leia a documentação correspondente antes de continuar.
URL de base
Todos os pontos de extremidade podem ser acessados por meio do host graph.facebook.com.
Usuários do app
As contas profissionais do Instagram são acessadas indiretamente por meio de contas do Facebook. Por isso, os usuários devem ter e usar uma conta do Facebook ao acessar seu app. Além disso, é preciso que a conta do Facebook possa executar tarefas equivalentes às de um administrador em uma Página conectada à conta do Instagram que está sendo acessada.
Os requisitos se aplicam a todos os usuários do app, mesmo àqueles com uma função no app ou na empresa que o obteve.
Autenticação
A autenticação do usuário do app é feita por meio de tokens de acesso. As contas profissionais do Instagram são acessadas indiretamente por meio de contas do Facebook. Por isso, todas as solicitações da API devem incluir o token de acesso do Facebook do usuário do app. Para obter tokens de usuários do seu app, implemente o Login do Facebook. O Login do Facebook não aceita credenciais do Instagram. Isso significa que os usuários do app devem entrar usando uma conta do Facebook.
Autorização
A autorização de pontos de extremidade é controlada por meio de permissões e recursos. Antes que seu app possa usar um ponto de extremidade para acessar os dados do Instagram de um usuário, você precisa solicitar todas as permissões exigidas pelos pontos de extremidade do usuário do app. Depois, o usuário precisa conceder essas permissões ao app. Assim que isso acontecer, você poderá consultar os pontos de extremidade para acessar dados do usuário.
Uma permissão autoriza o acesso somente a dados criados pelo usuário que a concedeu. Alguns pontos de extremidade permitem que os apps acessem dados que não foram criados pelo usuário, mas que são limitados e públicos.
Para solicitar permissões dos usuários do app, implemente o Login do Facebook. Os usuários que têm uma função no app podem conceder todas as permissões solicitadas. Os usuários que não têm uma função no app podem conceder apenas permissões e recursos aprovados no processo de análise do app.
A API usa as permissões e os recursos a seguir:
Consulte nossa referência de ponto de extremidade para determinar quais permissões e recursos o app precisa solicitar dos usuários.
Mensagens do Instagram
Se você planeja implementar Mensagens do Instagram na plataforma do Messenger, será necessário incluir a permissão instagram_manage_messages. Saiba mais sobre as mensagens do Instagram. 
Colaboradores
O recurso Collab do Instagram permite que os usuários do app sejam coautores de conteúdo (ou seja, publiquem mídia) com outras contas (colaboradores).
Salvo algumas exceções, os dados de mídia com coautoria podem ser acessados por meio da API somente pelo usuário que a publicou. Os colaboradores não conseguem acessar os dados usando a API. As únicas exceções são as pesquisas por mídias com melhor desempenho ou recém-publicadas que foram marcadas com uma hashtag específica. Consulte Pesquisa de hashtag.
Páginas
As contas profissionais do Instagram devem estar conectadas a uma Página do Facebook antes que os dados possam ser acessados por meio da API. Após a conexão, os usuários do Facebook capazes de executar tarefas na Página poderão conceder ao seu app um token de acesso que será usado em solicitações da API.
Nosso artigo de ajuda Adicionar ou alterar a Página do Facebook conectada à sua conta empresarial do Instagram explica como conectar uma Página do Facebook a uma conta profissional do Instagram.
Tarefas
Para que um usuário conceda permissões ao seu app, ele deve ter a capacidade de executar tarefas na Página do Facebook conectada à conta do Instagram que está sendo acessada. Os usuários podem conceder permissões ao seu app com base nas tarefas que são capazes de realizar, desta forma:
| Permissão | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
É possível determinar quais tarefas o usuário de um app pode executar em uma Página consultando o ponto de extremidade GET /me/accounts com o token de acesso correspondente. O ponto de extremidade retornará uma lista de Páginas em que o usuário do app pode executar tarefas e indicará quais tarefas ele pode realizar em cada uma delas.
Consulte a documentação de referência para ver as permissões exigidas para cada ponto de extremidade. A API não é compatível com usuários do sistema do Gerenciador de Negócios ou usuários do app que não tenham uma função de colaborador ao vivo.
Como referenciar tarefas
Se você precisar informar os usuários sobre tarefas (e indicar quais são obrigatórias para o uso correto do app), veja como referenciá-las nas nossas interfaces do usuário.
Páginas clássicas
As Páginas clássicas fazem referência a tarefas como funções. Os usuários com uma função de administrador em uma Página podem conceder permissões de todos os tipos ao app. Os usuários do app com outras funções podem conceder permissões da seguinte maneira:
| Função | Permissões possíveis |
|---|---|
Editor | instagram_basic |
Moderador | instagram_basic |
Anunciante | instagram_basic |
Analista | instagram_basic |
Páginas de novas experiências
As Páginas de novas experiências fazem referência a tarefas como Acesso ao Facebook ou Acesso a tarefas. Os usuários com Acesso ao Facebook em uma Página podem conceder permissões de todos os tipos ao app. Os usuários do app com Acesso a tarefas podem conceder permissões da seguinte maneira:
| Acesso a tarefas | Permissões possíveis |
|---|---|
Anúncios | instagram_basic |
Conteúdo | instagram_basic |
Insights | instagram_basic |
Mensagens e atividade da comunidade | instagram_basic |
Para determinar se a Página está usando a nova experiência, solicite o campo has_transitioned_to_new_page_experience. O valor retornará true se a Página usar a nova experiência.
Análise do app
O app deve passar pelo processo de análise antes que possa ser usado por usuários sem uma função no app ou uma função na empresa que o obteve. Caso o app seja usado somente por usuários que têm uma função no app ou na empresa, não será preciso concluir o processo de análise.
No envio para análise, você não precisará incluir credenciais de usuário de teste do Facebook se tiver implementado o Login do Facebook e se o app estiver disponível publicamente. Entretanto, caso os nossos analistas precisem entrar no app usando uma conta que não seja do Facebook para acionar a implementação do Login do Facebook, será necessário incluir as credenciais dessa conta no envio.
Apps privados
Caso os nossos analistas não consigam fazer testes porque o app usa uma intranet privada, não tem uma interface do usuário ou não implementou o Login do Facebook, você só poderá solicitar a aprovação das seguintes permissões:
Verificação da empresa
Conclua a verificação da empresa caso o app seja usado por usuários que não tenham uma função no app ou na empresa que o obteve.
Limitação de volume
Todos os pontos de extremidade estão sujeitos ao caso de uso da limitação de volume do Instagram para Empresas, exceto os pontos de extremidade Descoberta de empresas e Pesquisa de hashtag, que estão sujeitos à limitação de volume da plataforma.
Webhooks
Use Webhooks para enviar notificações a você sempre que alguém comentar nos objetos de mídia dos usuários do app ou quando um story deles expirar. Consulte a documentação de Webhooks para saber como usar o recurso. Depois, configure um webhook para o tópico Instagram e assine os campos comments e story_insights.
Mensagens do Instagram
Vários pontos de extremidade da Graph API do Instagram são usados em conjunto com os da plataforma do Messenger para permitir que os usuários do seu app interajam com mensagens diretas enviadas para as respectivas contas profissionais do Instagram. Consulte a documentação Mensagens do Instagram da plataforma do Messenger para saber como acessar mensagens em contas empresariais da plataforma.