Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Alterações à Graph API do Facebook em 2026: o que deixou de funcionar e o que fazer

Em 2026, a Meta lançou a Graph API v26.0 a 29 de julho, retirou a v19.0 a 21 de maio e a v20.0 a 24 de setembro, retirou as métricas de alcance, como page_impressions_unique, até 15 de junho, terminou três tags de mensagem do Messenger a 27 de abril e, a 27 de outubro, estendeu as alterações da v26.0 a todas as versões restantes: date_format e GET /?ids= passam a devolver erros, e a Commerce Order Management API deixou de existir.

O easyCoexistence liga as Páginas através da sua própria aplicação Meta e define a versão da Graph API que as suas ferramentas chamam, para que a sua IA continue a publicar, a responder a comentários e mensagens diretas e a ler métricas pelas mesmas ferramentas MCP enquanto as alterações da Meta entram em vigor, com cada ligação verificada de 6 em 6 horas e um e-mail quando for preciso voltar a ligá-la.

Oct 27, 2026

Quando as alterações de protocolo da v26.0 chegaram a todas as versões restantes: os pedidos com date_format e GET /?ids= devolvem erros.

Sep 24, 2026

Quando a Meta descontinuou e retirou a Graph API v20.0; a v21.0 segue-se a 21 de janeiro de 2027.

Jun 15, 2026

A data que o guia de Page Insights da Meta indica para a descontinuação de page_impressions_unique e de outras métricas de alcance em todas as versões.

Oct 9, 2026

Quando a Meta retirou a Verificação de Acesso para as aplicações Tech Provider; a Verificação da Empresa e a Revisão da aplicação continuam a aplicar-se.

Next oldest

Para onde a Meta envia as chamadas feitas a uma versão da Graph API que já não pode ser utilizada.

Que alterações houve na Graph API em 2026, da mais recente para a mais antiga?

Estas são as entradas datadas nos registos de alterações da Graph API, da API de Páginas e da Plataforma Messenger da Meta, e no seu blogue para programadores, que afetam uma integração com uma Página do Facebook, da mais recente para a mais antiga. As secções seguintes indicam o que cada uma interrompe e a correção a aplicar:

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 deixou de funcionar a 27 de outubro de 2026?

Duas das alterações da v26.0 chegaram nesse dia a todas as versões restantes da Graph API. Cinco comportamentos antigos do protocolo deixaram de funcionar: pretty e debug são ignorados, date_format devolve um erro, os pedidos à raiz para GET /?ids= devolvem um erro, e If-None-Match é ignorado, com os cabeçalhos ETag e as respostas 304 Not Modified removidos; debug_token não é afetado. A Commerce Order Management API, incluindo GET /{page-id}/commerce_orders, foi removida sem substituto, depois de a Meta ter descontinuado o checkout direto para Shops. A correção: converta as datas no seu próprio código, peça os objetos um a um ou em lote, e espere respostas completas.

Que campos antigos das Páginas deixaram de funcionar?

Nas Páginas da New Pages Experience, current_location, genre, network, parking e start_info estão descontinuados porque a Meta já não os mantém, e a definição auto_publish_page_info_updates desapareceu do edge de definições da Página. Na v26.0 e posteriores, pedir qualquer um destes campos devolve um erro de versão; o registo de alterações da Meta indica que a alteração chega a todas as versões cerca de 90 dias após o lançamento da v26.0, numa data que ainda não confirmou. As Páginas normais não são afetadas e não há substituto, por isso remova os campos dos seus pedidos.

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

As aplicações Tech Provider deixam de passar por ela. A publicação da Meta de 9 de outubro de 2026 remove do Painel de Aplicações o formulário de Verificação de Acesso, os seus pré-requisitos e o campo de estado, e os endpoints que rejeitavam chamadas de empresas sem um estado aprovado deixam de fazer essa verificação. A Verificação da Empresa continua a ser exigida antes de uma aplicação aceder a dados de outras empresas, a Revisão da aplicação continua a aplicar-se às permissões avançadas, e as regras do Data Use Checkup e da Data Protection Assessment mantêm-se. Não há nada a migrar: retire esta etapa dos planos de integração.

O que acontece agora às chamadas feitas à Graph API v20.0?

São respondidas por uma versão mais antiga que ainda pode ser utilizada: quando uma versão deixa de poder ser utilizada, a Meta encaminha as suas chamadas para a versão utilizável seguinte mais antiga, pelo que as chamadas à v20.0 são executadas na v21.0 desde 24 de setembro de 2026, e as da v19.0 foram transferidas a 21 de maio. Continuam a receber respostas, com o comportamento da versão mais recente. A própria v21.0 é retirada a 21 de janeiro de 2027, enquanto a v25.0 se mantém disponível até 29 de julho de 2028; por isso, passe para a v26.0 ou a v25.0 e teste, em vez de depender da predefinição.

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

Em duas etapas, por isso uma mesma alteração tem muitas vezes duas datas. Uma alteração por versão aplica-se de imediato à nova versão, normalmente com uma data para as restantes: as alterações de protocolo da v26.0 atingiram as chamadas à v26.0 a 29 de julho de 2026 e todas as restantes versões a 27 de outubro. As alterações fora de ciclo aplicam-se a todas as versões quando são introduzidas, e o registo de alterações fora de ciclo da Meta não indica nenhuma para 2026. A Meta mantém cada versão a funcionar durante pelo menos dois anos, e uma chamada sem versão usa a versão definida no Painel de Aplicações.

Que métricas de insights deixaram de funcionar em junho de 2026?

As métricas de alcance e de impressões das Páginas, publicações, vídeos e stories, descontinuadas em todas as versões; pedir qualquer uma delas devolve um erro de métrica inválida. O guia de Page Insights da Meta data isto de 15 de junho de 2026, enquanto o registo de alterações da v25.0 tinha associado 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 as desagregações pagas e orgânicas.
  • post_impressions_unique e as suas variantes pagas, orgânicas e virais: post_total_media_view_unique, ou post_media_view para as desagregações.
  • Visualizações de 3 segundos, como page_video_views_unique e post_video_views_unique: as mesmas métricas de visualizadores.
  • Impressões de vídeo, como total_video_impressions: a Meta não nomeia nenhuma substituição ao nível do vídeo; as notas da 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 a 27 de abril de 2026?

Os pedidos que incluíam CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE ou POST_PURCHASE_UPDATE começaram a falhar com o código de erro 100, como o registo de alterações da Meta tinha anunciado a 27 de março. HUMAN_AGENT, para uma resposta de uma pessoa dentro dos 7 dias seguintes à última mensagem do cliente, não foi incluída. As alternativas da Meta para as utilizações retiradas são as utility templates e a Marketing Messages API, e a página sobre tags de mensagem indica o que cada tag restante permite.

O que mais mudou para as Páginas e o Messenger em 2026?

Alterações mais pequenas, na maioria acrescentos, cada uma datada nos registos de alterações da Meta:

  • 30 de janeiro: a Page Integrity API e o webhook comunicam o estado de uma Página, as suas violações, restrições e recursos.
  • 11 de fevereiro: a Messenger Calling API passou a estar geralmente disponível para aplicações com pages_messaging.
  • 3 de março: os pedidos de marcação de consultas chegam à Conversations API e aos webhooks como anexos appointment_booking.
  • 6 de março: as utility templates do Messenger passam a aceitar parâmetros com nome, com parameter_format definido como NAMED.
  • 26 de março: as partilhas de publicações e Reels enviadas no Messenger incluem o seu url, id, type e title.
  • 19 de maio: metadata=1 deixa de devolver metadados sobre os campos de um nó em qualquer versão; as listas de campos estão nas referências.

Como verificar uma integração face a estas alterações?

Procure no código e nos registos de pedidos o que mudou, e depois execute as chamadas na versão que pretende manter:

  • Versões anteriores à v21.0 nos URL e nas definições do SDK, e a versão definida no Painel de Aplicações.
  • date_format, pretty, debug, If-None-Match e GET /?ids= nos pedidos.
  • Nomes de métricas retiradas, como page_impressions_unique ou total_video_impressions.
  • As três tags de mensagem retiradas nos envios do Messenger.
  • current_location, genre, network, parking e start_info nas leituras de Páginas.
  • commerce_orders e os restantes endpoints da Commerce Order Management API.

Como é que o easyCoexistence trata estas alterações?

As Páginas ligadas ao easyCoexistence chegam à Graph API da Meta através da sua aplicação Meta, na versão da Graph API que o easyCoexistence define, que é também a base que get_social_credentials devolve; assim, a Revisão da aplicação e as mudanças de versão ficam a cargo do easyCoexistence. send_social_dm envia respostas normais dentro da janela de mensagens, sem tag de mensagem, pelo que a retirada de abril não o afetou; e get_social_insights pede os nomes de métricas que a sua IA indica, pelo que deve transmitir as substituições acima.

Erros comuns

  • Ler apenas o registo de alterações da versão mais recente. Uma alteração por versão aplica-se primeiro à nova versão e só mais tarde às antigas, e foi assim que as alterações de protocolo da v26.0 chegaram ao código da v25.0 a 27 de outubro de 2026.
  • Manter date_format para apresentação. Desde 27 de outubro de 2026 devolve um erro em todas as versões; use o formato predefinido da Meta e converta-o no seu próprio código.
  • Esperar pela data da Meta para os campos antigos das Páginas. Já devolvem um erro de versão na v26.0, e a Meta ainda não confirmou quando as versões anteriores se seguem; remova-os já.
  • Presumir que uma versão retirada falha de forma visível. As suas chamadas são respondidas pela versão utilizável seguinte mais antiga, pelo que o código fixado na v20.0 passa agora a correr com o comportamento da v21.0 sem qualquer erro.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

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

A v26.0, lançada a 29 de julho de 2026, sem data de fim definida até agora. A v25.0, lançada a 18 de fevereiro de 2026, está disponível até 29 de julho de 2028.

Quando deixa de funcionar a Graph API v21.0?

A 21 de janeiro de 2027, quando a Meta a descontinua e retira; as chamadas que ainda estiverem fixadas nela nessa altura passam para a versão utilizável seguinte mais antiga.

As métricas de insights retiradas devolvem zero ou um erro?

Um erro. A API da Meta devolve um erro de métrica inválida para uma métrica descontinuada em todas as versões, por isso o pedido tem de indicar a substituição.

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

Cada Página é uma ligação e custa de US$ 9 a US$ 0.75 por ligação por mês, com o preço a descer à medida que aumenta o número de ligações, e os primeiros 3 dias são gratuitos.

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