EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Mudanças da API do Instagram em 2026: o que parou de funcionar e o que fazer

Em 2026 a Meta deixou de retornar media_url para vídeos do Instagram com áudio protegido por direitos autorais ou licenciado (30 de julho), removeu a Graph API v18.0, v19.0 e v20.0, desativou cinco opções herdadas de requisição da Graph API, como date_format, e substituiu o anexo de compartilhamento nos webhooks de DM do Instagram por ig_post. O guia de migração dela diz que apps recém-criados não podem configurar a API do Instagram com Instagram Login. Nenhuma métrica do Instagram foi descontinuada em 2026.

O easyCoexistence mantém as conexões do Instagram funcionando durante as mudanças da Meta: repassa campos, erros e entradas de webhook sem alterações, renova cada token antes de expirar e verifica a conta a cada 6 horas, para que o Claude, o ChatGPT ou o seu próprio código perceba uma mudança no dia em que a Meta a fizer.

30 Jul 2026

Desde então, media_url é omitido em vídeos com áudio protegido por direitos autorais ou licenciado, em todas as versões da API.

24 Sep 2026

Quando a Graph API v20.0 foi removida; a v19.0 terminou em 21 de maio e a v18.0 em 26 de janeiro.

27 Oct 2026

A partir de então, chamadas da Graph API com date_format ou uma requisição ?ids= na raiz retornam erro de parâmetro nas versões restantes.

1 Feb 2026

Fim da transição do anexo de compartilhamento para ig_post nos webhooks de DM de publicações compartilhadas no Instagram.

15 Apr 2026

Quando o certificado assinado pela DigiCert, usado pelos webhooks da Meta para TLS mútuo, expirou e foi substituído pela CA própria da Meta.

None

Métricas do Instagram descontinuadas nas entradas de changelog de 2026 da Meta, que adicionam métricas como total_views e link_clicks.

Quais mudanças de 2026 podem quebrar uma integração com o Instagram?

Nove mudanças datadas dos changelogs e anúncios da Meta, da mais recente para a mais antiga. A maioria quebra código que dependia de um padrão antigo, de um campo sempre presente ou de uma versão que continua disponível, e cada uma tem uma correção curta nas seções a seguir:

27 OctoberFive legacy Graph API request options removed from the remaining versions
24 SeptemberGraph API v20.0 removed; calls default to the next oldest version
30 Julymedia_url omitted for videos with copyrighted or licensed audio
29 Julyv26.0 released; the Explore placement removed from Instagram ads
21 MayGraph API v19.0 removed
27 Aprilshare attachment removed from post-share DM webhooks, rolled out gradually
15 AprilMeta's DigiCert-signed webhook client certificate expired
1 FebruaryEnd of the share to ig_post transition in DM webhooks
26 JanuaryGraph API v18.0 removed

Por que media_url está ausente desde 30 de julho de 2026?

A Meta agora o omite em qualquer vídeo com áudio protegido por direitos autorais ou licenciado, inclusive áudio adicionado da biblioteca do próprio Instagram, ou sinalizado por violação de direitos autorais, mesmo quando a conta é dona do vídeo. Reels cujo dono desativou os downloads também o perdem, nos endpoints que leem mídia de outros usuários. As requisições continuam retornando 200 com os demais campos, então trate media_url como opcional e use permalink ou thumbnail_url como alternativa, conforme recomenda a Meta.

Quais versões da Graph API deixaram de funcionar em 2026?

Três chegaram ao fim: v18.0 em 26 de janeiro, v19.0 em 21 de maio e v20.0 em 24 de setembro. O guia de versionamento da Meta diz que uma chamada para uma versão que não pode mais ser usada passa a usar a versão mais antiga utilizável seguinte, então o código fixado em uma versão continua rodando com o comportamento de versões mais novas, sem erro. A v25.0 chegou em 18 de fevereiro e a v26.0 em 29 de julho; a v21.0 sai em 21 de janeiro de 2027.

Quais opções herdadas da Graph API deixaram de funcionar em 27 de outubro de 2026?

Cinco comportamentos de requisição, primeiro na v26.0 a partir de 29 de julho e depois nas demais versões a partir de 27 de outubro, segundo o anúncio da v26.0 da Meta. Requisições com date_format e GET /?ids= na raiz agora retornam erro de parâmetro; pretty e debug são ignorados; e If-None-Match é ignorado, com os cabeçalhos ETag e as respostas 304 eliminados. Converta as datas no seu próprio código e faça as requisições de objetos uma a uma ou em lote.

O que a v26.0 mudou nos anúncios do Instagram?

A partir da Marketing API v26.0, lançada em 29 de julho de 2026, o posicionamento Feed do Explore do Instagram não está mais disponível: a entrega para o Explore para, a verba migra para outros posicionamentos elegíveis, e especificá-lo retorna erros. A recomendação da Meta é remover o Explore das configurações de posicionamento. A mudança afeta apenas anúncios, não as publicações feitas pela API do Instagram.

O que mudou nas publicações compartilhadas nos webhooks de DM?

O anexo share foi substituído por ig_post. A partir de 3 de novembro de 2025, uma publicação compartilhada em DM chegava com os dois; a Meta manteve o share para publicações do Instagram até 1º de fevereiro de 2026 e, em 27 de abril de 2026, começou a removê-lo dos payloads dos webhooks em uma implantação gradual. Processe o anexo ig_post, cujo payload traz ig_post_media_id, title e url, ou peça ao suporte para desenvolvedores da Meta que exclua o app da mudança.

Qual certificado de webhook expirou em 15 de abril de 2026?

O certificado de cliente assinado pela DigiCert que a Meta apresentava aos endpoints de webhook que usam TLS mútuo. O guia de configuração de webhooks da Meta diz que o substituto é assinado por uma autoridade certificadora da própria Meta, então um servidor ou balanceador de carga que verifica certificados de cliente deve confiar em meta-outbound-api-ca-2025-12.pem e verificar o common name client.webhooks.fbclientcerts.com. A mudança afeta apenas endpoints com TLS mútuo ativado.

O que mudou no login para novos apps?

A Meta agora direciona as novas integrações para o Unified Login. A visão geral recomenda essa configuração, a página do Unified Login diz que os novos recursos da API do Instagram são lançados apenas ali, e o guia de migração diz que apps recém-criados não podem configurar o Instagram Login, enquanto as integrações existentes com Instagram Login continuam funcionando sem data de término. Em 6 de fevereiro de 2026, a Meta também adicionou enable_fb_login à URL de autorização do Instagram, com valor padrão true, para mostrar ou ocultar a opção de Login com Facebook.

Quais limites as páginas da Meta agora descrevem de forma diferente?

Três, em que os guias da Meta ou a Central de Ajuda do Instagram trazem um número que partes mais antigas da referência não acompanham, sem entrada de changelog que date a mudança:

  • Carrosséis: até 20 fotos e vídeos no guia de publicação e na referência de mídia da Meta, enquanto a mensagem do subcódigo 2207028 ainda diz 10.
  • Hashtags: use no máximo 5, o limite da Central de Ajuda para uma publicação, embora a referência de mídia ainda permita 30 em uma legenda.
  • Publicações diárias: 100 publicações feitas pela API em 24 horas, no limite de taxa do guia de publicação, enquanto a seção de carrosséis e a referência content_publishing_limit ainda dizem 50.

O que a Meta adicionou em 2026, e em qual login?

Mais do que removeu. Vários dos acréscimos do ano vêm apenas com Login com Facebook, então um app com Instagram Login recebe menos deles, enquanto o rótulo de informação de IA funciona nos dois. Cada linha traz a data no changelog da Meta:

AI info labelis_ai_generated on a container, both logins, 22 June
Story link_clicksTaps on links in a Story, Facebook Login only, 22 June
Audio APIMusic and original sounds for Reels, Facebook Login and Unified Login, 1 June
oEmbed without a tokenEmbeds with no access token, 15 May
Multiple images in DMsOut of beta for all accounts, 6 May
Aggregated metricstotal_likes, total_comments and total_views, Facebook Login only, 22 April
Like APILikes on media and comments, with instagram_manage_engagement, 22 April
Paid partnership labelbranded_content_sponsor_ids at publish time, Facebook Login only, 22 April
Collaborative mediaGET /<IG_USER_ID>/collaborative_media, 22 April
Image attachment IDsReusable image uploads for DMs, 13 March

A Meta descontinuou alguma métrica ou API do Instagram em 2026?

Nenhuma métrica: as últimas descontinuações, entre elas impressões e reproduções, entraram em vigor em 2025, e a Basic Display API terminou em 4 de dezembro de 2024. As remoções do ano foram as versões antigas da Graph API, as opções herdadas de requisição, o anexo de compartilhamento, o certificado antigo de webhook da Meta, o posicionamento de anúncios no Explore e a Commerce Order Management API, removida das demais versões em 27 de outubro, depois que o checkout no Shops foi descontinuado.

Como o easyCoexistence lida com essas mudanças?

Ele repassa os dados e erros da Meta sem remodelá-los. list_social_posts pede permalink e thumbnail_url junto de media_url, então um vídeo sem media_url ainda volta com o seu link; os webhooks encaminhados levam a entrada da Meta sem alterações, incluindo os anexos ig_post; e get_social_insights envia os nomes de métrica que você informar, devolvendo o erro da própria Meta quando ela recusa uma. publish_instagram_post aceita carrosséis de 2 a 10 itens, menos que os 20 que o guia de publicação da Meta agora permite.

Erros comuns

  • Exigir media_url em vídeos. Desde 30 de julho de 2026 a Meta o omite em vídeos com áudio protegido por direitos autorais ou licenciado; use permalink ou thumbnail_url como alternativa.
  • Fixar uma versão descontinuada da Graph API e esperar um erro. A Meta atende essas chamadas na versão mais antiga utilizável seguinte, então o comportamento muda sem aviso.
  • Verificar apenas o tipo de anexo share. Compartilhamentos de publicação em DMs agora chegam como ig_post, com ig_post_media_id, title e url.
  • Enviar date_format para formatar timestamps. Desde 27 de outubro de 2026 ele retorna erro de parâmetro; converta o formato padrão no seu próprio código.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 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

A API do Instagram mudou o limite de publicações em 2026?

Nenhuma entrada do changelog de 2026 altera isso. O limite de taxa do guia de publicação da Meta permite 100 publicações feitas pela API por conta em 24 horas, enquanto a referência content_publishing_limit ainda informa um quota_total de 50.

A Graph API do Instagram está sendo desativada?

Não. A Meta continua documentando o Instagram Login e o Login com Facebook para integrações existentes e recomenda o Unified Login para as novas; a Basic Display, uma API separada, é a que terminou, em 2024.

Onde a Meta anuncia mudanças na API do Instagram?

No changelog da Instagram Platform, com as mudanças de mensagens no changelog de mensagens da Meta e as datas de versão na página de changelog da Graph API.

Quanto custa o easyCoexistence para uma conta do Instagram?

Cada conta do Instagram é uma conexão: de US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

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