A Meta anunciou em 4 de novembro de 2026 as versões 27.0 da Graph API e da Marketing API. A atualização altera como ferramentas externas e sistemas integrados criam e gerenciam anúncios, públicos e catálogos no Facebook e no Instagram.
À primeira vista, uma atualização de API parece assunto exclusivo de desenvolvedores. Na prática, ela também merece atenção de agências, gestores de tráfego, e-commerces e empresas que usam plataformas de automação ou sistemas próprios para administrar campanhas.
O principal cuidado é separar o que realmente mudou: boa parte das alterações afeta integrações que utilizam as APIs, e não significa que todos os anúncios criados diretamente no Gerenciador de Anúncios precisem ser refeitos.
O que são a Graph API e a Marketing API?
A Graph API permite que aplicativos e sistemas autorizados troquem informações com os serviços da Meta. A Marketing API oferece recursos específicos para administrar atividades de publicidade, como campanhas, conjuntos de anúncios, criativos, públicos e relatórios.
Essas interfaces permitem, por exemplo, que uma agência gerencie várias contas por uma plataforma própria, que um software conecte o catálogo de uma loja virtual aos anúncios ou que uma ferramenta automatize tarefas do Gerenciador de Anúncios. Quando a Meta altera uma API, o código e os processos dessas integrações podem precisar de ajustes.
As principais mudanças da versão 27.0
1. Novos conjuntos de anúncios podem ampliar a entrega para outros dispositivos
Em novos conjuntos elegíveis de campanhas de Vendas que segmentam dispositivos móveis ou sistemas operacionais específicos, a opção de ampliar o alcance para outros dispositivos móveis passa a ficar ativada por padrão quando a configuração correspondente não é informada.
Se a estratégia exige manter a entrega restrita aos aparelhos definidos na segmentação, a integração deve informar explicitamente o parâmetro device com valor 0. A mudança não altera automaticamente conjuntos de anúncios que já existiam. A Meta indicou que esse comportamento será expandido para outras versões da API cerca de 90 dias após o lançamento; a data exata deve ser confirmada na documentação oficial.
Aplicação prática: agências e empresas que criam conjuntos por ferramentas externas devem verificar como o sistema envia as configurações de dispositivos. Não basta confiar que a opção escolhida em uma campanha antiga será repetida em novas criações.
2. Criação de públicos semelhantes deixa de aceitar localização no pedido
Os públicos semelhantes (Lookalike Audiences) ajudam a encontrar pessoas com características parecidas com um público de origem, como uma lista de clientes. Na Marketing API v27.0, a criação de novos públicos semelhantes rejeita campos de país ou localização enviados dentro de lookalike_spec.
A localização passa a ser definida na configuração de público do conjunto de anúncios que utiliza o Lookalike. A alteração afeta solicitações de criação feitas pela API v27.0; públicos semelhantes já existentes e anúncios que os utilizam continuam funcionando.
Aplicação prática: revise scripts, CRMs e plataformas que criam públicos automaticamente. Se a integração continuar enviando os campos antigos, a solicitação poderá falhar.
3. A Meta pode ativar a vitrine de produtos em anúncios
Em anúncios criados pela API, a Meta poderá ativar o recurso Product showcase quando o criativo não trouxer uma configuração para esse recurso e a plataforma identificar, com alta confiança, um conjunto de produtos do catálogo compatível com o anúncio.
Quem não quiser esse comportamento pode desativá-lo explicitamente na configuração do criativo, usando o parâmetro product_extensions com enroll_status definido como OPT_OUT, dentro de degrees_of_freedom_spec.creative_features_spec.
Aplicação prática: lojas virtuais que usam catálogos integrados devem conferir se suas ferramentas permitem controlar a exibição de produtos e se os itens associados ao criativo correspondem à estratégia da campanha.
4. O endpoint de lote de catálogos mudou
Na versão 27.0, o endpoint de lote /{catalog-id}/batch deixa de funcionar. A orientação é migrar para /{catalog-id}/items_batch. Sistemas que ainda chamam o endpoint antigo podem apresentar falhas no envio ou na atualização de produtos quando utilizarem a v27.0.
Aplicação prática: peça ao responsável técnico ou fornecedor da plataforma que confirme se a integração já utiliza o endpoint recomendado e teste a sincronização de produtos, preços e demais informações do catálogo.
Outras mudanças técnicas que merecem atenção
A versão 27.0 também permite adicionar ou remover a autodeclaração de conteúdo gerado por inteligência artificial ao editar uma publicação de Página, por meio do parâmetro is_ai_generated. O valor true adiciona a declaração; false a remove; se o parâmetro for omitido, o estado atual é mantido.
Além disso, a Meta anunciou restrições a seis recursos legados da Graph API para novos aplicativos a partir de 4 de novembro, em todas as versões: solicitações por múltiplos IDs, formatação de data e hora, substituição do método HTTP, aliases de campos, callbacks JSONP e solicitações em lote assíncronas. Aplicativos existentes não podem introduzir novos usos desses recursos.
A métrica total_video_consumption_rate também foi descontinuada a partir do início de novembro de 2026, sem substituto direto anunciado. Relatórios e ferramentas que dependem dela precisam ser revisados.
Quem precisa prestar atenção?
O impacto depende de como cada empresa utiliza os serviços da Meta. Anunciantes que trabalham somente no Gerenciador de Anúncios devem acompanhar os comunicados e as configurações de suas campanhas. Agências com plataformas externas, e-commerces com catálogos integrados, empresas com CRM próprio e desenvolvedores de integrações precisam fazer uma verificação técnica mais cuidadosa.
Essa é uma orientação operacional, não uma classificação oficial da Meta. O que determina o impacto é a versão da API utilizada e os recursos que cada sistema chama.
Checklist: o que gestores de tráfego e agências devem fazer
- Mapeie as integrações: liste plataformas externas, CRMs, sistemas próprios e ferramentas conectadas às contas de anúncios e catálogos.
- Confirme a versão da API: pergunte aos fornecedores quais versões da Graph API e da Marketing API estão em uso e qual é o plano de atualização.
- Revise a criação de campanhas: verifique a configuração de expansão por dispositivos em novos conjuntos elegíveis.
- Audite a criação de públicos: confirme se a localização está configurada no conjunto de anúncios, e não no pedido de criação do Lookalike.
- Teste os catálogos: confira se a integração usa /items_batch e se os produtos continuam sendo sincronizados corretamente.
- Revise relatórios e publicações: identifique dependências da métrica descontinuada e avalie os fluxos que gerenciam a declaração de conteúdo gerado por IA.
Por que acompanhar atualizações técnicas faz parte da estratégia de marketing?
Uma operação de vendas depende de vários sistemas conectados: plataformas de anúncios, lojas virtuais, catálogos, ferramentas de análise, CRMs e automações. Quando uma dessas estruturas muda, o processo comercial pode sentir os efeitos.
Uma integração desatualizada pode gerar falhas de sincronização, dificultar a criação de campanhas ou aplicar uma configuração diferente da planejada. Por isso, acompanhar atualizações não é apenas uma tarefa técnica: também faz parte da gestão do negócio.
Conclusão: atualização exige atenção, não alarme
A Graph API v27.0 e a Marketing API v27.0 trazem mudanças em segmentação por dispositivos, públicos semelhantes, vitrines de produtos, catálogos e recursos legados. Elas merecem atenção principalmente de empresas que dependem de ferramentas externas para administrar campanhas.
Não há motivo para afirmar que todos os anúncios existentes serão afetados ou que todo anunciante precisa alterar campanhas imediatamente. O caminho mais seguro é identificar as integrações utilizadas, confirmar sua compatibilidade com a nova versão e testar os processos que podem ser impactados.
No mercado digital, acompanhar as mudanças e agir com informação é uma vantagem competitiva. Mais do que investir em anúncios, é preciso garantir que toda a estrutura responsável por gerar vendas continue funcionando corretamente.
Fontes e referências
Meta for Developers — Introducing Graph API v27.0 and Marketing API v27.0: https://developers.meta.com/resources/blog/
Social Media Today — Meta adds new capabilities to Graph and Marketing API: https://www.socialmediatoday.com/news/meta-adds-new-capabilities-to-graph-and-marketing-api/873951/
PPC Land — Meta’s API v27 may add catalog products to new ads by default: https://ppc.land/metas-api-v27-may-add-catalog-products-to-new-ads-by-default/
Voh! — Meta lança a versão 27.0 da Graph API e da Marketing API: https://www.voh.com.br/noticias/meta-lanca-marketing-api-v27-com-alcance-maior-por-padrao/
Nota editorial: os efeitos descritos variam conforme a versão da API, a ferramenta utilizada e o tipo de campanha. Antes de implementar alterações técnicas, consulte o changelog oficial e o fornecedor da integração.
