Alterações à API do Instagram em 2026: o que deixou de funcionar e o que fazer
Em 2026, a Meta deixou de devolver media_url nos vídeos com áudio protegido por direitos de autor ou licenciado (30 de julho), removeu as versões v18.0, v19.0 e v20.0 do Graph API, retirou cinco opções antigas de pedido ao Graph API, como date_format, e substituiu o anexo share pelo ig_post nos webhooks de DM do Instagram. O guia de migração da Meta diz que as aplicações criadas de novo não podem configurar a API do Instagram com o Instagram Login. Nenhuma métrica do Instagram foi retirada em 2026.
A easyCoexistence mantém as ligações ao Instagram a funcionar apesar das alterações da Meta: transmite os campos, erros e entradas de webhook da Meta sem alterações, renova cada token antes de expirar e verifica a conta de 6 em 6 horas, pelo que o Claude, o ChatGPT ou o seu próprio código detetam uma alteração no próprio dia em que a Meta a faz.
Desde então, media_url é omitido nos vídeos com áudio protegido por direitos de autor ou licenciado, em todas as versões da API.
Quando a versão v20.0 do Graph API foi removida; a v19.0 terminou a 21 de maio e a v18.0 a 26 de janeiro.
A partir daí, os pedidos ao Graph API com date_format ou com ?ids= na raiz devolvem um erro de parâmetro nas versões restantes.
Fim da transição do anexo share para ig_post nos webhooks de DM do Instagram sobre partilhas de publicações.
Quando expirou o certificado assinado pela DigiCert que os webhooks da Meta usavam para TLS mútuo, substituído pela CA própria da Meta.
Métricas do Instagram retiradas nas entradas de 2026 do registo de alterações da Meta, que acrescentam métricas como total_views e link_clicks.
Que alterações de 2026 podem interromper uma integração com o Instagram?
Nove alterações datadas, dos registos de alterações e anúncios da Meta, da mais recente para a mais antiga. A maioria interrompe código que dependia de um valor predefinido antigo, de um campo sempre presente ou de uma versão que continuava disponível. Cada uma tem uma correção curta nas secções seguintes:
Porque é que media_url desapareceu desde 30 de julho de 2026?
A Meta deixou de o incluir em qualquer vídeo com áudio protegido por direitos de autor ou licenciado, incluindo o áudio adicionado a partir da biblioteca do próprio Instagram, ou sinalizado por violação de direitos de autor, mesmo quando a conta é do proprietário. Os Reels cujo proprietário desativou as transferências também o perdem, nos endpoints que leem conteúdos de outros utilizadores. Os pedidos continuam a devolver 200 com os restantes campos, por isso trate media_url como opcional e recorra a permalink ou thumbnail_url, como a Meta recomenda.
Que versões do Graph API deixaram de funcionar em 2026?
Três chegaram ao fim: v18.0 a 26 de janeiro, v19.0 a 21 de maio e v20.0 a 24 de setembro. O guia de versões da Meta diz que uma chamada a uma versão que já não pode ser usada é encaminhada para a versão utilizável mais antiga seguinte, pelo que o código que fixou uma versão continua a funcionar com comportamento mais recente, sem erro. A v25.0 chegou a 18 de fevereiro e a v26.0 a 29 de julho; a v21.0 termina a 21 de janeiro de 2027.
Que opções antigas do Graph API deixaram de funcionar a 27 de outubro de 2026?
Cinco comportamentos de pedido, primeiro na v26.0 a partir de 29 de julho e depois nas restantes versões a partir de 27 de outubro, segundo o anúncio da Meta sobre a v26.0. Os pedidos com date_format e com GET /?ids= na raiz passam a devolver um erro de parâmetro; pretty e debug são ignorados; e If-None-Match é ignorado, tendo desaparecido os cabeçalhos ETag e as respostas 304. Converta as datas no próprio código e faça os pedidos a objetos um a um ou em lote.
O que mudou na v26.0 para os anúncios do Instagram?
Desde a Marketing API v26.0, lançada a 29 de julho de 2026, o posicionamento no feed Explore do Instagram deixou de estar disponível: a entrega para o Explore para, o investimento passa para outros posicionamentos elegíveis e indicá-lo devolve erros. A recomendação da Meta é remover o Explore das configurações de posicionamento. A alteração diz respeito apenas aos anúncios, e não às publicações feitas através da API do Instagram.
O que mudou nas publicações partilhadas nos webhooks de DM?
O anexo share deu lugar a ig_post. Desde 3 de novembro de 2025, uma publicação partilhada numa DM chegava com os dois; a Meta manteve o share nas publicações do Instagram até 1 de fevereiro de 2026 e, a 27 de abril de 2026, começou a retirá-lo dos payloads dos webhooks, num lançamento gradual. Processe o anexo ig_post, cujo payload traz ig_post_media_id, title e url, ou peça ao apoio a programadores da Meta que exclua a aplicação da alteração.
Que certificado de webhook expirou a 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 de certificação detida pela Meta, pelo que um servidor ou balanceador de carga que verifique certificados de cliente tem de confiar em meta-outbound-api-ca-2025-12.pem e confirmar o nome comum client.webhooks.fbclientcerts.com. A alteração diz respeito apenas aos endpoints com TLS mútuo ativado.
O que mudou no início de sessão para as novas aplicações?
A Meta encaminha agora as novas integrações para o Unified Login. A visão geral recomenda essa configuração, a página do Unified Login indica que as novas funcionalidades da API do Instagram são lançadas apenas aí, e o guia de migração diz que as aplicações criadas de novo não podem configurar o Instagram Login, enquanto as integrações existentes com Instagram Login continuam a funcionar sem data de fim. A 6 de fevereiro de 2026, a Meta acrescentou ainda enable_fb_login ao URL de autorização do Instagram, com valor predefinido true, para mostrar ou ocultar a opção Facebook Login.
Que limites indicam agora as páginas da Meta de forma diferente?
Três, em que os guias da Meta ou o Centro de Ajuda do Instagram indicam um valor que partes mais antigas da referência não acompanham, sem qualquer entrada no registo de alterações que date a mudança:
- Carrosséis: até 20 fotos e vídeos no guia de publicação e na referência de conteúdos multimédia da Meta, enquanto a mensagem do subcódigo 2207028 ainda diz 10.
- Hashtags: manter até 5, o limite do Centro de Ajuda para uma publicação, embora a referência de conteúdos multimédia ainda permita 30 numa legenda.
- Publicações diárias: 100 publicações pela API em 24 horas no limite de taxa do guia de publicação, enquanto a respetiva secção de carrosséis e a referência
content_publishing_limitainda dizem 50.
O que acrescentou a Meta em 2026, e em que início de sessão?
Mais do que retirou. Várias das novidades do ano chegam só com o Facebook Login, pelo que uma aplicação com Instagram Login recebe menos, enquanto a etiqueta de informação de IA funciona nos dois. Cada linha indica a data no registo de alterações da Meta:
A Meta retirou alguma métrica ou API do Instagram em 2026?
Nenhuma métrica: as últimas retiradas, entre elas impressões e reproduções, produziram efeitos em 2025, e a Basic Display API terminou a 4 de dezembro de 2024. As remoções do ano foram as versões antigas do Graph API, as opções antigas de pedido, o anexo share, o certificado antigo dos webhooks da Meta, o posicionamento de anúncios Explore e a Commerce Order Management API, retirada das restantes versões a 27 de outubro, depois de o checkout nas Shops ter sido descontinuado.
Como é que a easyCoexistence lida com estas alterações?
Transmite os dados e os erros da Meta em vez de os reformatar. list_social_posts pede permalink e thumbnail_url ao lado de media_url, pelo que um vídeo sem media_url continua a devolver a respetiva ligação; os webhooks reencaminhados trazem a entrada da Meta sem alterações, incluindo os anexos ig_post; e get_social_insights envia os nomes de métricas que indicar, devolvendo o erro da própria Meta quando um for recusado. publish_instagram_post aceita carrosséis de 2 a 10 itens, menos do que os 20 que o guia de publicação da Meta permite agora.
Erros comuns
- Exigir media_url nos vídeos. Desde 30 de julho de 2026 a Meta omite-o nos vídeos com áudio protegido por direitos de autor ou licenciado; recorra a permalink ou thumbnail_url.
- Fixar uma versão retirada do Graph API e esperar um erro. A Meta encaminha essas chamadas para a versão utilizável mais antiga seguinte, pelo que o comportamento muda sem aviso.
- Filtrar apenas pelo tipo de anexo share. As partilhas de publicações em DM chegam agora como ig_post, com ig_post_media_id, title e url.
- Enviar date_format para formatar datas. Desde 27 de outubro de 2026 devolve um erro de parâmetro; converta o formato predefinido no próprio código.
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
A API do Instagram mudou o limite de publicações em 2026?
Nenhuma entrada do registo de alterações de 2026 o altera. O limite de taxa do guia de publicação da Meta permite 100 publicações por conta em 24 horas, enquanto a referência content_publishing_limit ainda indica uma quota_total de 50.
A Graph API do Instagram vai ser desligada?
Não. A Meta continua a documentar o Instagram Login e o Facebook Login para as integrações existentes e recomenda o Unified Login para as novas; a Basic Display, uma API separada, é a única que terminou, em 2024.
Onde é que a Meta anuncia as alterações à API do Instagram?
No registo de alterações da Plataforma Instagram, com as alterações de mensagens no registo de alterações de mensagens da Meta e as datas das versões na página de registo de alterações do Graph API.
Quanto custa a easyCoexistence para uma conta do Instagram?
Cada conta do Instagram é uma ligação: 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.
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