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.
Desde então, media_url é omitido em vídeos com áudio protegido por direitos autorais ou licenciado, em todas as versões da API.
Quando a Graph API v20.0 foi removida; a v19.0 terminou em 21 de maio e a v18.0 em 26 de janeiro.
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.
Fim da transição do anexo de compartilhamento para ig_post nos webhooks de DM de publicações compartilhadas no Instagram.
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.
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:
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_limitainda 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:
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.
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