Plataforma do Instagram

Registo de alterações da plataforma do Instagram

Este registro documenta as alterações feitas nas APIs do Instagram.

Registros de alterações relacionados

3 de outubro de 2024

Os fluxos de mensagens de boas-vindas agora estão disponíveis para a API do Instagram com Login do Instagram. Saiba mais.

2 de outubro de 2024

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

17 de setembro de 2024

Novos valores scope

Aplicável a todas as versões.

Para garantir que nomes de permissão e valores scope sejam consistentes, estamos introduzindo novos valores scope à API do Instagram com o login do Instagram. Os novos valores scope são:

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

Eles substituirão os valores business_basic, business_content_publish, business_manage_comments e business_manage_messages, respectivamente.

Os valores antigos de scope ficarão obsoletos a partir de 27 de janeiro de 2025. Atualize o código do seu app antes dessa data para evitar interrupções na funcionalidade. Se você não fizer essa atualização, seu app não conseguirá chamar os pontos de extremidade do Instagram.

Correção: a data de descontinuação mudou de 17 de dezembro de 2024 para 27 de janeiro de 2025.

23 de julho de 2024

Lançamento da nova API do Instagram com o Login do Instagram

Componentes da nova API do Instagram:

  • Uma página do Facebook não será mais necessária
  • O URL do host para chamadas de API é graph.instagram.com
  • Novas permissões da API:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • A Messenger API não será mais usada para enviar mensagens do Instagram
  • Novos apps adicionarão o novo produto do Instagram durante a criação de um app da Meta
  • Apps existentes poderão adicionar o novo produto do Instagram no Painel de Apps

Consulte nosso guia de migração para saber se a nova API do Instagram com o Login do Instagram é a opção certa para você.

11 de junho de 2024

Webhooks de comentários do Instagram

Aplicável a todas as versões.

Além de ad_id e ad_title, original_media_id será retornado no objeto media de value do campo comments quando alguém comentar em publicações turbinadas ou de anúncios no Instagram. Para mais informações, consulte Como configurar webhooks para o Instagram.

21 de maio de 2024

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

12 de setembro de 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9 de novembro de 2022

Webhooks do Instagram

Aplicável a todas as versões.

ad_id e ad_title serão retornados no objeto media de value do campo comments quando alguém comentar em publicações turbinadas ou de anúncios no Instagram.

31 de outubro

Reels – Etiquetas de produtos

Aplicável a todas as versões.

A API de Etiquetas de Produto do Instagram para o Reels já está disponível. É possível marcar até 30 produtos ao publicar reels.

28 de junho de 2022

Reels

Aplicável a todas as versões.

Agora, oferecemos compatibilidade com o Reels. Para publicar um vídeo do Reels, defina o parâmetro media_type como REELS ao criar um contêiner de publicação de mídia única. Consulte a referência POST /ig-user/media endpoint para descobrir quais parâmetros podem ser usados com um vídeo do Reels e conhecer as exigências para esse tipo de mídia.

27 de junho de 2022

Documentação da API do Instagram legada

Aplicável a todas as versões.

A documentação para desenvolvedores sobre a API do Instagram legada foi removida. Agora, a página redireciona para a documentação para desenvolvedores da plataforma do Instagram.

20 de junho de 2022

Marcação de produto

Aplicável a todas as versões.

Agora, você pode criar e gerenciar etiquetas de produtos do Compras no Instagram em uma mídia publicada no Instagram para Empresas. Para ver mais informações, consulte o guia Marcação de produto.

27 de maio de 2022

Variantes do produto

Aplicável a todas as versões.

Agora, os parceiros com a versão beta da Marcação de produto que pesquisarem em catálogos de produtos verão todas as variantes do produto que atenderem aos critérios da consulta.

15 de março de 2022

Publicações em carrossel

Aplicável a todas as versões.

Agora você pode usar a API do Instagram para criar publicações com vários vídeos e imagens (publicações em carrossel). Consulte o guia Publicação de conteúdo para ver todas as etapas do processo.

Se o seu aplicativo já tiver as permissões necessárias para a publicação de conteúdo, não será preciso passar pela análise do aplicativo novamente para usar essa funcionalidade.

9 de novembro de 2021

Vídeos ao vivo

Aplicável a todas as versões.

Agora, é possível usar a API do Instagram para obter mídias e comentários de vídeos ao vivo transmitidos por usuários do aplicativo, bem como usar a API de Mensagens do Instagram para enviar respostas privadas (mensagens diretas) aos autores dos comentários. Para viabilizar essa funcionalidade, as seguintes alterações foram realizadas:

  • Uma nova borda GET /ig-user/live_media pode retornar mídia do Instagram de vídeo ao vivo transmitida por um usuário do aplicativo no momento da solicitação.
  • O campo media em um comentário do Instagram agora retorna um objeto com a identificação (id) e a localização da publicação (media_product_type) da mídia em que o comentário foi feito.
  • Um novo campo do Webhooks do Instagram live_comments envia notificações com comentários publicados nos vídeos ao vivo dos usuários durante a transmissão.

Consulte a documentação sobre respostas privadas da API de Mensagens do Instagram para saber como enviar respostas privadas aos usuários que comentaram na mídia do Instagram de vídeo ao vivo.

20 de outubro de 2021

Comentários do Instagram

Aplicável a todas as versões.

Dois novos campos foram adicionados aos comentários do Instagram:

  • from – retorna um objeto que contém o IGSID (id) e o nome de usuário (username) do criador do comentário.
  • parent_id – retorna a identificação do comentário principal no Instagram, caso o comentário feito seja derivado de outro (ou seja, uma resposta a um comentário).

Webhooks do Instagram

Aplicável a todas as versões.

O campocomments dos webhooks do Instagram agora inclui as seguintes propriedades no objeto de campo value:

  • from.id – o IGSID do usuário do Instagram que criou o comentário.
  • from.username – o nome de usuário do criador do comentário do Instagram.
  • media.id – a identificação da mídia do Instagram em que o comentário foi feito.
  • media.media_product_type – a superfície (localização da publicação) da mídia do Instagram em que o comentário foi feito.
  • parent_id – a identificação do comentário principal no Instagram, caso o comentário feito seja derivado de outro (ou seja, uma resposta a um comentário).

5 de outubro de 2021

As alterações a seguir se aplicam aos vídeos do Instagram TV criados a partir de 5 de outubro de 2021. Os vídeos do Instagram TV criados antes dessa data não serão afetados por essas mudanças.

  • O campomedia_product_type retornará FEED, em vez de IGTV.
  • O campovideo_title não será retornado.
  • Agora há compatibilidade com os campos comments e mentions de Webhooks do Instagram.

Em 3 de janeiro de 2022, as alterações acima serão aplicadas a todas as versões da API e a todos os vídeos do Instagram TV, independentemente da data de criação do vídeo. Isso significa que, a partir de 3 de janeiro de 2022, os aplicativos que usarem versões mais antigas da API poderão consultar vídeos do Instagram TV (a compatibilidade de leitura foi lançada na versão 10.0 e limitada a essa versão e posteriores).

A partir da versão 14.0, o campo video_title não será mais compatível, e a API gerará um erro quando ele for solicitado.

8 de junho de 2021

Número de curtidas

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

Caso uma consulta indireta seja feita a uma mídia do Instagram por meio de outro ponto de extremidade ou expansão de campo, o campo like_count será omitido das respostas de API se o dono da mídia tiver ocultado o número de curtidas. A consulta direta a mídias do Instagram (que pode ser realizada somente pelo próprio dono) retornará o número real de curtidas mesmo se a contagem tiver sido ocultada.


Paginação com base no tempo

Aplicável a partir da versão 11.0.

Os parâmetros since e until foram adicionados ao ponto de extremidade GET /{ig-user-id}/media para compatibilidade com a paginação com base no tempo.

26 de maio de 2021

Caso a consulta seja feita de forma indireta a uma mídia do IG por meio de outro ponto de extremidade, o campo like_count retornará 0 se o usuário não for proprietário da mídia e se o proprietário tiver ocultado a contagem de curtidas. A consulta direta à mídia do IG, que pode ser realizada somente pelo proprietário da mídia, retornará a contagem real de curtidas, mesmo se o proprietário tiver ocultado esse número na mídia.

4 de maio de 2021

Foi realizada uma alteração secundária no modo de calcularmos a online_followers métrica para usuários do IG.

14 de abril de 2021

As interações com mídia de story do IG realizadas por usuários no Japão não são mais incluídas em alguns cálculos da métrica replies:

  • Para stories criados por usuários no Japão, a métrica replies agora retorna o valor 0.
  • Para stories criados por usuários fora do Japão, a métrica replies retorna o número de respostas, mas as respostas de usuários no Japão não são incluídas no cálculo.

12 de abril de 2021

Correção de um pequeno erro nas métricas de alcance em mídia de stories do Instagram.

9 de abril de 2021

16 de março de 2021

As mídias do IGTV agora são aceitas na v10.0 e superiores. Isso se aplica a todos os pontos de extremidade, exceto os usados para webhooks e publicações de conteúdo. Com o objetivo de viabilizar essa mudança, adicionamos os campos media_product_type e video_title ao nó de mídia do Instagram. Para ser acessível via API, a mídia do IGTV precisa ser compartilhada no Instagram no momento da publicação. Além disso, é necessário habilitar as opções Publicar uma prévia ou Compartilhar prévia no feed.

26 de janeiro de 2021

O beta da Publicação de conteúdo terminou, e todos os desenvolvedores agora podem publicar mídia em contas profissionais do Instagram. Consulte o guia Publicação de conteúdo para ver mais detalhes sobre o uso.

2 de dezembro de 2020

Em conformidade com a Diretiva ePrivacy da União Europeia, as interações de mensagem em mídia do Instagram de stories realizadas por usuários no Espaço Econômico Europeu (EEE) após 1º de dezembro de 2020 não serão mais incluídas em alguns cálculos de métrica:

  • Para stories criados por usuários no EEE, a métrica replies agora retornará o valor 0.
  • Para stories criados por usuários fora do EEE, a métrica replies retornará o número de respostas, mas as respostas publicadas por usuários no EEE não serão incluídas no cálculo.

Essa alteração se aplica a todas as versões.

10 de novembro de 2020

  • Insights de usuário do Instagram: os valores follower_count estão mais alinhados com os valores correspondentes exibidos no app do Instagram. Além disso, o valor follower_count agora retorna dados de no máximo 30 dias, em vez de dois anos. Essa alteração se aplica à v9.0 e superiores. Em 9 de maio de 2021, ela será aplicada a todas as versões.

5 de maio de 2020

3 de dezembro de 2019

  • Insights: para alinhar o comportamento da API com o do app do Instagram, os insights sobre os usuários do Instagram agora só estão disponíveis em usuários que têm 100 seguidores ou mais.

13 de agosto de 2019

  • Descoberta de empresas: a API da Descoberta de Empresas agora pode ser usada para obter dados sobre outras contas de criador de conteúdo do Instagram.

22 de maio de 2019

9 de maio de 2019

  • Webhooks: o campo story_insights agora requer a permissão instagram_manage_insights, em vez de instagram_manage_comments.

31 de outubro de 2018

  • API de Pesquisa de Hashtag: agora é possível pesquisar mídia marcada com hashtags específicas usando a nova API de Pesquisa de Hashtag. #spooky!

23 de outubro de 2018

  • Borda /{ig-media-id}/comments: as solicitações GET feitas com a API 3.1 ou versões superiores retornarão resultados em ordem cronológica. As solicitações feitas com a versão 3.2 ou superiores retornarão resultados em ordem cronológica inversa.

7 de junho de 2018

  • Nó /{ig-media-id}: agora é possível usar a expansão de campo para obter o campo permalink em objetos de mídia.

1º de maio de 2018

  • Verificação da empresa: para usar a Graph API do Instagram, todos os apps precisam passar pela verificação da empresa, que é parte do processo de análise do app e passa a ser exigida para todos os pontos de extremidade da Graph API do Instagram. Os apps analisados antes de 1º de maio de 2018 precisam refazer esse processo até 1º de agosto de 2018. Caso contrário, eles perderão acesso à API.

24 de abril de 2018

  • Nó /{ig-comment-id}:
    • Incluímos o novo campo username.
    • Para solicitações GET, o campo user não será incluído nas respostas a menos que o usuário que fez a solicitação seja dono do comentário. Em vez disso, retornaremos username para todos que comentaram. Isso também se aplica a consultas em comentários feitos por meio de outras APIs, como a API de Menções.
  • Nó /{ig-media-id}:
    • Incluímos o novo campo username.
    • Para solicitações GET, o campo owner não será incluído nas respostas a menos que o usuário que fez a solicitação for dono do objeto de mídia. Em vez disso, retornaremos username para todos que comentaram. Isso também se aplica a consultas em objetos de mídia feitos por meio de outras APIs, como a API de Menções.

23 de abril de 2018

  • API de Insights: os insights agora incluem atividade de anúncios gerada por meio da API, das interfaces de anúncios do Facebook e do recurso Promover do Instagram. Isso afeta as seguintes métricas:

    • impressions
    • reach

13 de março de 2018

  • API de Publicação de Conteúdo: os parceiros beta agora podem usar a borda /{ig-user-id}/media para marcar localizações e usuários públicos do Instagram ao publicar fotos.

8 de março de 2018

  • Campos públicos: o campo timestamp no nó /{ig-media-id} agora é público e pode ser retornado por meio de uma expansão de campo.

22 de fevereiro de 2018

  • Campos públicos: os nós /{ig-user-id}, /{ig-comment-id} e /{ig-media-id} agora retornam todos os campos públicos quando acessados por meio de uma borda via expansão de campo. Consulte o documento de referência de cada nó para ver quais campos são públicos.

8 de fevereiro de 2018

  • API de Publicação de Conteúdo: os parceiros beta agora podem incluir hashtags ao publicar fotos por meio da borda /{ig-user-id}/media. Oba! #crazywildebeest!