EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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

Em 2026 a Meta lançou a Graph API v26.0 em 29 de julho, removeu a v19.0 em 21 de maio e a v20.0 em 24 de setembro, aposentou métricas de alcance, como page_impressions_unique, até 15 de junho, encerrou três tags de mensagem do Messenger em 27 de abril e, em 27 de outubro, estendeu as mudanças da v26.0 a todas as versões restantes: date_format e GET /?ids= agora retornam erros, e a Commerce Order Management API foi removida.

O easyCoexistence conecta Páginas pelo seu próprio app da Meta e define a versão da Graph API que as ferramentas chamam.

Oct 27, 2026

Quando as mudanças de protocolo da v26.0 chegaram a todas as versões restantes: requisições com date_format e GET /?ids= retornam erros.

Sep 24, 2026

Quando a Meta descontinuou e removeu a Graph API v20.0; a v21.0 segue até 21 de janeiro de 2027.

Jun 15, 2026

A data que o guia de Insights de Página da Meta indica para descontinuar page_impressions_unique e outras métricas de alcance em todas as versões.

Oct 9, 2026

Quando a Meta aposentou a Verificação de Acesso para apps Tech Provider; a Verificação da Empresa e a Análise do app continuam valendo.

Next oldest

Para onde a Meta envia as chamadas feitas a uma versão da Graph API que não está mais utilizável.

O que mudou na Graph API em 2026, da mais recente para a mais antiga?

Estas são as entradas com data nos changelogs da Graph API, da Pages API e da Messenger Platform da Meta, e no seu blog para desenvolvedores, que afetam uma integração com Página do Facebook, da mais recente para a mais antiga. As seções abaixo mostram o que cada uma quebra e a correção:

Oct 27, 2026v26.0's protocol changes and the Commerce Order Management removal reach all versions
Oct 9, 2026Access Verification retired for Tech Provider apps
Sep 24, 2026Graph API v20.0 deprecated and removed
Jul 29, 2026Graph API v26.0 released; legacy Page fields fail on it
Jun 15, 2026Page, post, video and story reach metrics deprecated
May 21, 2026Graph API v19.0 deprecated and removed
May 19, 2026metadata=1 stops returning field metadata in all versions
Apr 27, 2026Three Messenger message tags return error 100
Feb 18, 2026Graph API v25.0 released, announcing the June metric removals
Jan 26, 2026Graph API v18.0 reaches its end date

O que parou de funcionar em 27 de outubro de 2026?

Duas mudanças da v26.0 chegaram a todas as versões restantes da Graph API naquele dia. Cinco comportamentos legados de protocolo foram removidos: pretty e debug são ignorados, date_format retorna erro, requisições raiz para GET /?ids= retornam erro, e If-None-Match é ignorado, com os cabeçalhos ETag e as respostas 304 Not Modified removidos. debug_token não foi afetado. A Commerce Order Management API, incluindo GET /{page-id}/commerce_orders, foi removida sem substituto depois que a Meta descontinuou o checkout direto da Shops. A correção: converta as datas no seu próprio código, faça as requisições um objeto por vez ou em lote, e espere respostas completas.

Quais campos legados de Página deixaram de funcionar?

Nas Páginas da Nova Experiência de Páginas, current_location, genre, network, parking e start_info estão descontinuados porque a Meta não os mantém mais, e a configuração auto_publish_page_info_updates saiu do edge de configurações da Página. Na v26.0 e nas versões posteriores, pedir qualquer um desses campos retorna um erro de versão. O changelog da Meta diz que a mudança chega a todas as versões cerca de 90 dias após o lançamento da v26.0, em uma data que ela ainda não confirmou. Páginas comuns não são afetadas e não há substituto, então remova os campos das suas requisições.

O que mudou com o fim da Verificação de Acesso?

Apps Tech Provider não passam mais por ela. O comunicado da Meta de 9 de outubro de 2026 remove o formulário de Verificação de Acesso, seus pré-requisitos e seu campo de status do App Dashboard, e os endpoints que rejeitavam chamadas de empresas sem um status aprovado não fazem mais essa verificação. A Verificação da Empresa ainda é exigida antes que um app acesse dados de outras empresas, a Análise do app continua valendo para as permissões avançadas, e as regras do Data Use Checkup e da Avaliação de Proteção de Dados não mudaram. Não há nada para migrar: retire a etapa dos planos de onboarding.

O que acontece com as chamadas à Graph API v20.0 agora?

Elas são respondidas por uma versão que ainda está utilizável: quando uma versão deixa de ser utilizável, a Meta direciona as chamadas dela para a próxima mais antiga que ainda é utilizável. Por isso, as chamadas à v20.0 rodam na v21.0 desde 24 de setembro de 2026, e as da v19.0 foram direcionadas em 21 de maio. Elas continuam recebendo respostas, sob o comportamento da versão mais nova. A v21.0 é removida em 21 de janeiro de 2027, enquanto a v25.0 fica disponível até 29 de julho de 2028. Então migre para a v26.0 ou a v25.0 e teste, em vez de depender do padrão.

Como as mudanças por versão chegam às versões mais antigas?

Em duas etapas, por isso uma mudança costuma ter duas datas. Uma mudança versionada se aplica de imediato à nova versão, geralmente com uma data para as demais: as mudanças de protocolo da v26.0 atingiram as chamadas à v26.0 em 29 de julho de 2026 e as demais versões em 27 de outubro. Mudanças fora de ciclo se aplicam a todas as versões no momento em que são introduzidas, e o registro de mudanças fora de ciclo da Meta não lista nenhuma em 2026. A Meta mantém cada versão funcionando por pelo menos dois anos, e uma chamada sem versão usa a versão definida no App Dashboard.

Quais métricas de Insights deixaram de funcionar em junho de 2026?

As métricas de alcance e de impressões de Páginas, posts, vídeos e stories foram descontinuadas em todas as versões; pedir uma delas retorna um erro de métrica inválida. O guia de Insights de Página da Meta data isso em 15 de junho de 2026, enquanto o changelog da v25.0 tinha vinculado a remoção ao lançamento da v26.0. As substituições que a Meta indica:

  • page_impressions_unique e a família page_posts_impressions: page_total_media_view_unique, ou page_media_view para os detalhamentos pagos e orgânicos.
  • post_impressions_unique e suas variantes pagas, orgânicas e virais: post_total_media_view_unique, ou post_media_view para os detalhamentos.
  • Visualizações de 3 segundos, como page_video_views_unique e post_video_views_unique: as métricas de espectadores equivalentes.
  • Impressões de vídeo, como total_video_impressions: a Meta não indica substituto em nível de vídeo; as notas da versão v25.0 apontam para as métricas Media Views e Media Viewers, post_media_view e post_total_media_view_unique, lidas na publicação.
  • Impressões de stories: STORY_MEDIA_VIEW e STORY_TOTAL_MEDIA_VIEW_UNIQUE.

O que mudou nas tags de mensagem do Messenger em 27 de abril de 2026?

Requisições com CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE ou POST_PURCHASE_UPDATE passaram a falhar com o código de erro 100, como o changelog da Meta tinha anunciado em 27 de março. HUMAN_AGENT, usada para a resposta de uma pessoa até 7 dias após a última mensagem do cliente, não estava entre elas. Os caminhos da Meta para os usos aposentados são os templates utilitários e a Marketing Messages API, e a página de tags de mensagem detalha o que cada tag restante permite.

O que mais a Meta mudou para Páginas e Messenger em 2026?

Mudanças menores, a maioria delas acréscimos, cada uma com data nos changelogs da Meta:

  • 30 de janeiro: a Page Integrity API e o webhook informam o status de uma Página, suas violações, restrições e recursos.
  • 11 de fevereiro: a Messenger Calling API ficou disponível de forma geral para apps com pages_messaging.
  • 3 de março: requisições de agendamento de horários chegam à Conversations API e aos webhooks como anexos appointment_booking.
  • 6 de março: os templates utilitários do Messenger passam a aceitar parâmetros nomeados, com parameter_format definido como NAMED.
  • 26 de março: compartilhamentos de posts e Reels enviados no Messenger passam a trazer url, id, type e title.
  • 19 de maio: metadata=1 não retorna mais metadados sobre os campos de um nó em nenhuma versão; as listas de campos ficam nas referências.

Como verificar uma integração contra essas mudanças?

Procure no código e nos logs de requisições o que mudou, e depois rode as chamadas na versão que você pretende manter:

  • Strings de versão abaixo da v21.0 em URLs e configurações de SDK, e a versão definida no App Dashboard.
  • date_format, pretty, debug, If-None-Match e GET /?ids= nas requisições.
  • Nomes de métricas aposentadas, como page_impressions_unique ou total_video_impressions.
  • As três tags de mensagem aposentadas nos envios do Messenger.
  • current_location, genre, network, parking e start_info nas leituras de Página.
  • commerce_orders e os demais endpoints da Commerce Order Management API.

Como o easyCoexistence lida com essas mudanças?

As Páginas conectadas ao easyCoexistence acessam a Graph API da Meta pelo seu app da Meta, na versão da Graph API que o easyCoexistence define. Essa versão também é a base que get_social_credentials devolve, então a Análise do app e as trocas de versão ficam a cargo do easyCoexistence. O send_social_dm envia respostas padrão dentro da janela de atendimento, sem tag de mensagem, então a aposentadoria de abril não o afetou. O get_social_insights pede os nomes de métricas que a sua IA passar, então deve passar as substituições acima.

Erros comuns

  • Ler apenas o changelog da versão mais nova. Uma mudança versionada cai primeiro na versão nova e depois nas antigas, e foi assim que as mudanças de protocolo da v26.0 chegaram ao código da v25.0 em 27 de outubro de 2026.
  • Manter date_format para exibição. Desde 27 de outubro de 2026 ele retorna erro em todas as versões; use o formato padrão da Meta e converta no seu próprio código.
  • Esperar a data da Meta para os campos legados de Página. Eles já retornam erro de versão na v26.0, e a Meta não confirmou quando as versões antigas seguem; então remova-os agora.
  • Achar que uma versão removida falha de forma explícita. As chamadas dela são respondidas pela próxima versão utilizável mais antiga, então um código fixado na v20.0 agora roda com o comportamento da v21.0 sem erro.
Fazendo isso com o EasyCoexistence

Assim, a sua IA continua publicando, respondendo comentários e DMs e lendo insights pelas mesmas ferramentas MCP enquanto as mudanças da Meta acontecem, com cada conexão verificada a cada 6 horas e um e-mail quando ela precisar ser reconectada. De US$ 9 até 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

Qual é a versão mais recente da Graph API do Facebook?

A v26.0, lançada em 29 de julho de 2026, sem data de fim definida ainda. A v25.0, lançada em 18 de fevereiro de 2026, fica disponível até 29 de julho de 2028.

Quando a Graph API v21.0 deixa de funcionar?

Em 21 de janeiro de 2027, quando a Meta a descontinua e remove. Chamadas ainda fixadas nela nessa data vão para a próxima versão utilizável mais antiga.

As métricas de Insights aposentadas retornam zero ou erro?

Erro. A API da Meta retorna um erro de métrica inválida para uma métrica descontinuada em todas as versões, então a requisição precisa usar o nome da substituição.

Quanto custa o easyCoexistence para uma Página do Facebook?

Cada Página é uma conexão, de US$ 9 até US$ 0.75 por conexão por mês, com o preço caindo conforme o número de conexões cresce, e os primeiros 3 dias são 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