Apresentamos as versões 26.0 da Graph API e da API de Marketing

As versões 26.0 da Graph API v26.0 e da API de Marketing incluem novos recursos, descontinuações e alterações importantes. Leia os destaques abaixo e acesse o registro de alterações da versão 26.0 para ver a lista completa de mudanças e detalhes.

Principais datas e alterações

• Graph API – Gerenciamento de pedidos comerciais: as chamadas aos pontos de extremidade afetados na versão 26.0 e posteriores serão bloqueadas a partir de 29 de julho de 2026. Os pontos de extremidade serão removidos de todas as versões restantes da Graph API no dia 27 de outubro de 2026. Após essa data, as chamadas retornarão erros. Não há uma API de substituição disponível.
• Graph API – Campos de proprietário do Rights Manager: a partir da versão 26.0, de 29 de julho de 2026, campos de substituição que retornam o tipo RightsHolderOwner estarão disponíveis. Os campos de proprietário obsoletos não serão mais retornados. Os campos descontinuados permanecem disponíveis na versão 25.0 e em versões anteriores por dois anos após o lançamento da versão 26.0.
• Graph API – Recursos de protocolo antigo: cinco comportamentos antigos serão removidos das chamadas da versão 26.0 a partir de 29 de julho de 2026. O mesmo comportamento será aplicado a todas as versões da Graph API a partir de 27 de outubro de 2026.
• API de Marketing – anúncios no Status do WhatsApp: a versão 26.0 adiciona recursos de identidade, direcionamento, otimização e criativo expandidos a partir de 29 de julho de 2026.
• API de Marketing – público Advantage+ para campanhas de moradia, emprego e produtos e serviços financeiros: a partir da versão 26.0, em 29 de julho de 2026, os conjuntos de anúncios novos ou copiados com direcionamento restrito devem definir explicitamente advantage_audience como 1 ou 0. As configurações padrão ou flexíveis continuam a definir o padrão como 1. As atualizações de conjuntos de anúncios existentes não são afetadas.
• API de Marketing – Feed da seção Explorar do Instagram: o posicionamento não estará mais disponível a partir da versão 26.0 em 29 de julho de 2026. Os desenvolvedores devem remover o Explorar das configurações de posicionamento.
• API de Marketing – Destino somente na web para campanhas de web e app: a partir da versão 26.0, em 29 de julho de 2026, um anúncio não poderá usar um criativo com applink_treatment definido como web_only quando a campanha usar os locais de conversão site e app. A restrição será aplicada a todas as versões da API de Marketing em 27 de outubro de 2026.
• API de Marketing – Messenger Stories: a partir das chamadas da versão 26.0, em 29 de julho de 2026, o valor story será removido silenciosamente de messenger_positions durante a criação ou atualização de conjuntos de anúncios. A descontinuação se aplica a todas as versões da API de Marketing, incluindo chamadas sem versão, a partir de 27 de outubro de 2026.
• API de Marketing – Criação de anúncios com enquete: a partir da versão 26.0, em 29 de julho de 2026, os pedidos que criarem um criativo de enquete ou alterarem um anúncio para usar uma enquete serão rejeitados. As atualizações de anúncios existentes que não alterarem o criativo continuarão sendo compatíveis. A descontinuação se aplica a todas as versões da API de Marketing em 27 de outubro de 2026.
• Graph API e API de Marketing – Campos de estimativa de veiculação: os campos de resposta daily_outcomes_curve, budget_guardrail e estimate_dau serão removidos das chamadas da versão 26.0 a partir de 29 de julho de 2026 e de todas as versões compatíveis restantes a partir de 27 de outubro de 2026. Não há uma API de substituição disponível.
• Descontinuação da versão da Graph API: a versão 20.0 da Graph API será descontinuada e removida em 24 de setembro de 2026. A versão 21.0 da Graph API será descontinuada e removida em 21 de janeiro de 2027.

Atualizações gerais

API de Marketing: suporte ampliado para anúncios no Status do WhatsApp

A partir da versão 26.0 da API de Marketing em 29 de julho de 2026, os anúncios no Status do WhatsApp serão compatíveis com recursos adicionais de identidade, direcionamento, otimização e criativo.

• Identidade do WhatsApp: os chamadores externos da API de Marketing devem incluir explicitamente wamo_whatsapp_identity_spec nos criativos do anúncio destinados à veiculação no Status do WhatsApp. A identidade do WhatsApp não é definida automaticamente para essas chamadas.
• Direcionamento de idade desconhecida: quando o posicionamento Status do WhatsApp é selecionado e user_age_unknown não é definido, o campo é definido como true por padrão. Isso significa que a campanha pode alcançar pessoas de idade desconhecida no WhatsApp.
• Otimização: a otimização de conversão para conversões fora do site é compatível com os objetivos de Vendas, Leads e Engajamento. A otimização para visualizações da página de destino também é compatível.
• Formato do criativo: os anúncios em carrossel aceitam até 10 cartões.

Consulte a documentação de direcionamento de posicionamento e direcionamento básico para mais detalhes.

Descontinuações e alterações importantes

Graph API e API de Marketing: remoção do campo de estimativa de veiculação

Os campos daily_outcomes_curve, budget_guardrail e estimate_dau estão sendo removidos da resposta do ponto de extremidade da Estimativa de veiculação porque o serviço que alimenta esses valores foi descontinuado. A partir de 29 de julho de 2026, esses campos não serão mais retornados na versão 26.0 da Graph API e da API de Marketing. A alteração será aplicada a todas as versões restantes da Graph API e da API de Marketing em 27 de outubro de 2026. Não há uma API de substituição disponível.

Os desenvolvedores devem remover qualquer uso ou referência a esses campos antes da data de remoção aplicável.

Os pontos de extremidade afetados incluem:

• GET /{ad-account-id}/delivery_estimate - Estimativas de veiculação da conta de anúncios
• GET /{adset-id}/delivery_estimate - Estimativas de veiculação do conjunto de anúncios

A lista completa de campos e pontos de extremidade estará disponível no registro de alterações da versão 26.0.

Graph API: descontinuação da API de Gerenciamento de Pedidos Comerciais

Os apps que chamarem esses pontos de extremidade na versão 26.0 da Graph API e posteriores serão bloqueados a partir de 29 de julho de 2026. Os pontos de extremidade serão removidos para todas as versões restantes da Graph API em 27 de outubro de 2026. Depois disso, as chamadas retornarão erros.

A experiência de finalização da compra diretamente no Facebook e no Instagram para lojas foi totalmente desativada. A API de Gerenciamento de Pedidos Comerciais permitia que plataformas externas listassem pedidos, visualizassem detalhes de pedidos, gerenciassem envios, processassem cancelamentos, lidassem com reembolsos e rastreassem devoluções para essa experiência de finalização da compra. Como a infraestrutura de pedidos de comércio subjacente está sendo descontinuada, esses pontos de extremidade estão sendo descontinuados.

Os desenvolvedores devem parar de fazer chamadas para esses pontos de extremidade e remover a dependência. Não há uma API de substituição disponível.

Os pontos de extremidade afetados incluem:

• GET /{commerce-order-id} - Detalhes do pedido
• GET /{commerce-order-id}/items - Itens da linha de pedido
• GET /{commerce-order-id}/payments - Pagamentos de pedidos
• GET /{commerce-order-id}/payment_transaction_details - Detalhes da transação de pagamento
• GET /{commerce-order-id}/refunds - Reembolsos de pedidos
• GET /{commerce-order-id}/shipments - Envios de pedidos
• GET /{commerce-order-shipment-id}/items - Itens do envio
• GET /{commerce-return-id} - Detalhes da devolução
• GET /{commerce-order-cancellation-id}/items - Itens de linha de cancelamento
• GET /{page-id}/commerce_orders - Listar pedidos por Página
• GET /{commerce-merchant-settings-id}/commerce_orders - Listar pedidos por configurações do comerciante
• GET /{commerce-merchant-settings-id}/commerce_returns - Listar devoluções por configurações do comerciante
• GET /{commerce-merchant-settings-id}/tax_settings - Configurações de impostos

A lista completa de 47 pontos de extremidade afetados estará disponível no registro de alterações da versão 26.0 da Graph API.

Graph API: os campos de proprietário do Rights Manager migraram para RightsHolderOwner

Os campos reference_owner e matched_reference_owner em AudioVisualReferenceMatch e ImageReferenceMatch, além dos campos sending_rights_holder e receiving_rights_holder em CopyrightOwnershipTransfer, estão sendo descontinuados. A partir da versão 26.0 da Graph API, os campos de substituição que retornam o tipo RightsHolderOwner dedicado estão disponíveis para representar melhor o modelo de propriedade usado pelo Rights Manager. Os campos descontinuados não são mais retornados nas respostas da versão 26.0 e posteriores.

Os campos descontinuados continuarão a funcionar na versão 25.0 e em versões anteriores por dois anos após o lançamento da versão 26.0. Depois disso, eles serão removidos. Os desenvolvedores devem migrar para os campos de substituição durante esse período de dois anos.

Use os seguintes campos de substituição:

• Use reference_owner_rh_owner em vez de reference_owner.
• Use matched_reference_owner_rh_owner em vez de matched_reference_owner.
• Use sending_rights_holder_owner em vez de sending_rights_holder.
• Use receiving_rights_holder_owner em vez de receiving_rights_holder.

Os pontos de extremidade afetados incluem:

• GET /{audio-visual-reference-match-id} - Detalhes da correspondência de referência
• GET /{image-reference-match-id} - Detalhes da correspondência de referência de imagem
• GET /{copyright-ownership-transfer-id} - Detalhes da transferência de propriedade

A lista completa de campos estará disponível no registro de alterações da versão 26.0 da Graph API.

Graph API: recursos do protocolo antigo descontinuados

A partir de 29 de julho de 2026, a versão 26.0 da Graph API e posteriores não oferecerão mais suporte a cinco comportamentos de protocolo legados: pretty, debug, date_format, solicitações de GET /?ids=... raiz e processamento de If-None-Match / ETag legado.

Esses comportamentos estão sendo removidos para simplificar as respostas da Graph API e tornar o processamento de solicitações mais consistente.

Para a versão 26.0 da Graph API e posteriores:

• pretty é ignorado e as respostas JSON usam formatação compacta. Formate JSON em ferramentas ou códigos do cliente.
• debug é ignorado e nenhum envelope de resposta de depuração é adicionado. Use ferramentas de depuração padrão. O ponto de extremidade debug_token não foi afetado.
• Pedidos que incluem date_format retornam um erro de parâmetro. Use o formato de data padrão e converta os valores localmente, se necessário.
• Solicitações raiz usando GET /?ids=... retornam um erro de parâmetro. Use solicitações por objeto ou os lotes compatíveis.
• If-None-Match é ignorado. Os cabeçalhos de resposta ETag e o comportamento 304 Not Modified foram removidos. As solicitações retornam respostas completas.

A partir de 27 de outubro de 2026, essas alterações serão aplicadas a todas as versões da Graph API compatíveis restantes. Analise os registros de solicitação de tempo de execução e o registro de alterações da versão 26.0 da Graph API para saber os detalhes da migração.

Descontinuação de campos de Página legados para a nova experiência de Páginas (versão 26.0 da Graph API)

Rascunho de post de blog do desenvolvedor. Lançamento-alvo: versão 26.0 da Graph API. Tipo de alteração: descontinuação (90 dias).

Resumo

Para as Páginas da nova experiência de Páginas, cinco campos de nó de Página (current_location, genre, network, parking, start_info) e a configuração de Página auto_publish_page_info_updates serão descontinuados a partir da versão 26.0 da Graph API. Esses campos não são mais mantidos e não devem ser acessados para páginas da nova experiência de Páginas.

Linha do tempo

• 29 de julho de 2026: os campos serão bloqueados e a configuração será removida na versão 26.0 e posteriores para as Páginas da nova experiência de Páginas.
• Aproximadamente 90 dias após o lançamento: a mesma mudança será aplicada a todas as versões restantes. A data exata no final de outubro de 2026 ainda será confirmada.

O que está mudando

Na versão 26.0 e posteriores, a solicitação de qualquer um desses cinco campos em uma página da experiência de novas Páginas retorna um erro de versão. Além disso, a configuração auto_publish_page_info_updates não aparece mais na resposta de configurações da Página. Nas versões anteriores, o comportamento permanece inalterado até o encerramento da janela de migração de 90 dias. Depois disso, o mesmo se aplica a todas as versões.

Pontos de extremidade afetados:

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings - a configuração auto_publish_page_info_updates é removida da lista de configurações retornada

O que os desenvolvedores devem fazer

• Remova esses campos e a configuração auto_publish_page_info_updates das solicitações da sua Página.
• Verifique seus registros de solicitações, integrações de clientes e painéis para uso desses campos na nova experiência de Páginas.
• Consulte o registro de alterações da versão 26.0 da Graph API para ver a lista completa e atualizada.

Referência

• Referência de nó da Página

API de Marketing: requisitos de público Advantage+ para campanhas de moradia, emprego e produtos e serviços financeiros

A partir de 29 de julho de 2026, com a versão 26.0 da API de Marketing, o parâmetro advantage_audience dentro de targeting_automation será definido automaticamente como 1 para configurações de público totalmente padrão ou flexíveis. Para configurações de público restrito, os desenvolvedores devem definir explicitamente advantage_audience como 1 ou 0 para campanhas nas categorias de anúncios especiais de moradia, emprego ou produtos e serviços financeiros.

Esse comportamento aplica-se apenas ao criar um novo conjunto de anúncios. A atualização de um conjunto de anúncios existente não demonstrará esse comportamento em nenhuma versão da API.

Esse é o mesmo comportamento introduzido para campanhas fora das categorias de anúncios especiais na API de Marketing versão 23.0. Consulte a documentação de solução de problemas de público Advantage+ para mais detalhes.

Estes pontos de extremidade da API serão afetados:

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

API de Marketing: o posicionamento de anúncios Explorar não está mais disponível

A partir da versão 26.0 da API de Marketing, em 29 de julho de 2026, o posicionamento no feed da seção Explorar do Instagram não estará mais disponível. A veiculação no Explorar será interrompida e os gastos da campanha serão transferidos automaticamente para outros posicionamentos qualificados.

Se você tentar criar ou atualizar um conjunto de anúncios que especifique o posicionamento Explorar, encontrará um erro. Os desenvolvedores devem remover o Explorar das configurações de posicionamento e usar outros posicionamentos qualificados.

Estes pontos de extremidade serão afetados:

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

API de Marketing: descontinuação do destino somente web para campanhas da web e do app

A partir de 29 de julho de 2026, com a versão 26.0 da API de Marketing, os desenvolvedores não poderão mais anexar um criativo do anúncio com applink_treatment definido como web_only a um anúncio em uma campanha que usa os locais de conversão no site e no app. Isso afeta a criação e as atualizações de anúncios por meio de POST /act_{ad-account-id}/ads e POST /{ad-id}.

O ponto de extremidade do criativo do anúncio não mudará, mas o POST /act_{ad-account-id}/adcreatives é onde o valor applink_treatment será configurado. Os desenvolvedores devem analisar as integrações para applink_treatment=web_only e usar a seleção de destino automático ou outro destino manual compatível para campanhas de site e app.

Em 27 de outubro de 2026, 90 dias após o lançamento da versão 26.0, essa restrição será aplicada a todas as versões da API de Marketing. Consulte a documentação sobre anúncio e criativo do anúncio para mais informações.

API de Marketing: o posicionamento do Messenger Stories foi descontinuado

A partir de 29 de julho de 2026, com a versão 26.0 da API de Marketing, o valor story em messenger_positions não estará mais disponível ao criar ou atualizar conjuntos de anúncios por meio de chamadas com a versão 26.0 ou posterior.

Para essas chamadas, o story será removido silenciosamente da especificação de direcionamento e não aparecerá mais nos posicionamentos efetivos para conjuntos de anúncios novos ou existentes. Os dados históricos de direcionamento podem continuar incluindo story quando solicitados por meio de GET /{ad_set-id}?fields=targeting. Nenhum erro dedicado será retornado. No entanto, erros de validação de posicionamento padrão poderão ser aplicados se a remoção de story deixar uma configuração de posicionamento inválida.

Estes pontos de extremidade serão afetados:

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Os desenvolvedores que usam posicionamentos manuais devem remover story de messenger_positions. Se for o único valor, remova todo o campo messenger_positions e considere remover messenger de publisher_platforms quando nenhum outro posicionamento do Messenger, como marketing_messages, for usado. Não é necessária nenhuma ação para os posicionamentos Advantage+.

Essa alteração somente na API não afeta o Gerenciador de Anúncios. Chamadas sem versão e chamadas a versões anteriores à 26.0 não serão afetadas inicialmente. Em 27 de outubro de 2026, 90 dias após o lançamento da versão 26.0, a descontinuação será aplicada a todas as versões da API de Marketing, incluindo chamadas sem versão.

API de Marketing: a criação de anúncios com enquete foi descontinuada

A partir de 29 de julho de 2026, com a versão 26.0 da API de Marketing, os componentes de enquete não serão mais compatíveis no momento de criação ou atualização de anúncios e criativos do anúncio. O campo poll_spec e o valor "poll" para o campo type não estarão mais disponíveis em interactive_components_spec.

As solicitações que criam um criativo de enquete ou alteram um anúncio para usar uma enquete serão rejeitadas. As atualizações de um anúncio existente que não alteram o criativo, como mudanças de status, orçamento ou programação, podem continuar.

Estes pontos de extremidade serão afetados:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Os desenvolvedores devem remover os campos relacionados à enquete das especificações do criativo e usar um criativo sem esse componente. As chamadas a versões anteriores à 26.0 e as chamadas sem versão não são afetadas inicialmente.

Em 27 de outubro de 2026, 90 dias após o lançamento da versão 26.0, essa descontinuação será aplicada a todas as versões da API de Marketing.

Lançamento da versão 26 dos SDKs de Negócios da Meta

O lançamento da versão 26 do SDK de Negócios da Meta será feito logo após o lançamento da versão 26 da Graph API. Esse lançamento incluirá atualizações de dependências, integração do Configurador de Parâmetros da API de Conversões, novos recursos de API e descontinuação da API de Gerenciamento de Pedidos Comerciais e vários recursos de protocolo legados.

O SDK de Negócios agora está integrado ao Configurador de Parâmetros da API de Conversões com código aberto. Você pode aproveitar essa nova integração para melhorar a qualidade da integração da API de Conversões. Principais recursos: gera automaticamente (restrito por preferência definida pelos anunciantes) e aprimora os parâmetros fbc, fbp, event_source_url, referrer_url e client_ip_address e normalização/hashing automático de PII para idiomas compatíveis. Saiba mais neste link. A API de Gerenciamento de Pedidos Comerciais (47 pontos de extremidade) foi totalmente descontinuada sem substituição. O posicionamento de anúncios no feed da seção Explorar do Instagram foi removido e retorna erros se especificado. O posicionamento do Messenger Stories foi removido silenciosamente de messenger_positions. Os anúncios no Status do WhatsApp ganham novos recursos, incluindo especificação de identidade, carrossel com até dez cartões e otimização de conversão fora do site.

Como parte da nossa programação de descontinuação em dois anos para SDKs da plataforma, confira as próximas descontinuações e sunsets:

• Ssetembro de 2026: o SDK da plataforma do Facebook versão 20.0 será descontinuado
• Janeiro de 2027: o SDK da plataforma do Facebook versão 21.0 será descontinuado

Descontinuações de versões de API:

Confira as versões da Graph API que ficarão obsoletas:

Graph API

• 24 de setembro de 2026: a versão 20.0 da Graph API será descontinuada e removida da plataforma.
• 21 de janeiro de 2027: a versão 21.0 da Graph API será descontinuada e removida da plataforma.

Para evitar interrupções, migre todas as chamadas para a versão mais recente da API.