Apresentamos a versão 18.0 da Graph API e da API de Marketing do Facebook

Hoje estamos lançando a versão 18.0 da Graph API e da API de Marketing do Facebook. Como parte desse lançamento, destacamos abaixo as alterações que acreditamos serem relevantes para parte da nossa comunidade de desenvolvedores. As mudanças incluem anúncios, atualizações de produtos e notificações sobre descontinuações que podem ser relevantes para a integração dos seus aplicativos à nossa plataforma.

Para ver uma lista completa de todas as alterações e seus detalhes, consulte o registro de alterações.

Atualizações gerais

Consolidação das opções do status de localização de público para o direcionamento por localização

Conforme anunciado anteriormente em maio de 2023, consolidamos o status de localização de público para nossa atual opção padrão de "Pessoas que moram ou estiveram recentemente nesta localização" ao escolher o tipo de público para alcançar nas seleções de Direcionamento por localização. Essa atualização reflete uma consolidação de outras opções disponíveis anteriormente e a remoção da nossa opção "Pessoas que estiveram visitando essa localização".

Estamos fazendo essa alteração como parte dos nossos esforços contínuos para agregar mais valor aos negócios, simplificar nosso sistema de anúncios e otimizar nossas opções de direcionamento para aumentar a eficiência do desempenho e remover opções com baixo uso.

Essa atualização se aplicará a campanhas novas ou duplicadas. Campanhas existentes criadas antes do lançamento não serão inclusas nessa nova experiência, a menos que estejam no modo de rascunho ou sejam duplicadas.

Adição de "add_security_recommendation" e "code_expiration_minutes" à API de Modelos de Mensagem do WA

No início do ano, lançamos a solução de autenticação do WhatsApp, que permitiu a criação e o envio de modelos de autenticação com botões nativos e mensagens de autenticação predefinidas. Com o lançamento da versão 18 da Graph API, estamos aprimorando a recuperação de modelos de autenticação, tornando o processo de modelo de autenticação completo mais fácil para BSPs e empresas.

Com a versão 18 da Graph API, os BSPs e as empresas podem ter melhor visibilidade quanto ao conteúdo do modelo de mensagem de autenticação predefinido depois da criação. Especificamente, as cargas retornarão opções de configuração de conteúdo predefinidas, além do texto usado pelo WhatsApp. Essa melhoria pode permitir que BSPs e empresas "editem" interfaces do usuário para modelos de autenticação que podem ser criados com base na API.

Podem ocorrer erros ao atualizar para a versão 18 da Graph API se BSPs ou empresas estiverem pegando toda a resposta da solicitação GET e fornecendo-a de volta para a solicitação POST a fim de atualizar os modelos. Para resolver isso, os campos de texto do corpo/cabeçalho/rodapé devem ser eliminados antes de passarem para a API.

Novo lançamento do documento de desenvolvedores e registros de alterações para a criação de anúncios com ligação telefônica

• Posicionamento do Facebook Reels para anúncios com ligação telefônica
  A Meta está lançando a opção de veicular anúncios com ligação telefônica por meio da plataforma do Facebook Reels. Anúncios com ligação telefônica permitem que usuários liguem para empresas no momento da consideração quando visualizam um anúncio e ajudam empresas a gerarem discussões mais complexas com os usuários interessados. Essa é uma oportunidade para empresas anunciarem usando anúncios com ligação telefônica com base no comportamento em tempo real das pessoas no Facebook. No nível do conjunto de anúncios no Gerenciador de Anúncios, as empresas podem optar por adicionar "Facebook Reels" na seção Posicionamentos.
• Novo lançamento de anúncios com ligação telefônica via API
  Em 12 de setembro de 2023, forneceremos orientações atualizadas sobre como criar anúncios com ligação telefônica via API. Estamos introduzindo a documentação unicamente para anúncios com ligação telefônica. Dessa forma, os desenvolvedores de 3P poderão criar campanhas de anúncios com ligação telefônica com mais facilidade e saber como ver insights sobre as campanhas em andamento, incluindo métricas relacionadas a ligações. No futuro, também planejamos oferecer suporte a complementos para ligações via nossa plataforma de API. Os desenvolvedores devem ter acesso às permissões gerais necessárias para criar anúncios gerais a fim de criar anúncios com ligação telefônica via plataforma de API.
  
  Consulte a documentação do desenvolvedor para obter informações adicionais.

Descontinuações e alterações disruptivas

Mudanças na Graph API para recurso de permissão granular do usuário

Estamos atualizando dois pontos de extremidade da Graph API para a conta do WhatsAppBusiness. Esses pontos de extremidade são:

• Recuperar modelos de mensagem associados à conta do WhatsAppBusiness
• Recuperar números de telefone associados com a conta do WhatsAppBusiness

Com a versão 18, estamos implementando um novo recurso, a "permissão granular do usuário". Todos os usuários existentes que já foram adicionados à conta do WhatsAppBusiness serão preenchidos e continuarão tendo acesso (sem impacto).

O administrador tem a flexibilidade de alterar essas permissões. Se o administrador alterar a permissão e remover o acesso para visualizar modelos de mensagem ou números de telefone para um dos usuários, esse usuário específico começará a receber uma mensagem de erro. A mensagem afirma que ele não tem permissão para ver modelos de mensagem ou números de telefone em todas as versões 18 e anteriores.

Descontinuação da nomenclatura de métricas legadas para mídia no Instagram e insights sobre usuários

A partir de 12 de setembro, o Instagram removerá métricas de insights duplicadas e legadas da Graph API do Instagram a fim de compartilhar uma única fonte de métricas com nossos desenvolvedores.

Essa nova atualização reduz qualquer confusão, bem como aumenta a confiabilidade e a qualidade dos nossos relatórios.

Após 90 dias desse lançamento (ou seja, 11 de dezembro de 2023), removeremos todas essas métricas de insights legadas e duplicadas da Graph API do Instagram em todas as versões para sermos mais consistentes com o app do Instagram.

Agradecemos o feedback da nossa comunidade de desenvolveres e esperamos continuar trabalhando juntos.

Analise a documentação de desenvolvedores referente aos insights sobre mídia e aos insights sobre usuário para saber mais.

Descontinuação de todos os pontos de extremidade do Facebook Wi-Fi versão 1 e 2

O Facebook Wi-Fi foi criado para melhorar a experiência de conexão a hotspots de Wi-Fi em empresas. Com ele, os clientes de um comerciante podiam usar o Wi-Fi gratuitamente ao fazer check-in no Facebook. Ele também permitia que o comerciante controlasse quem podia usar o Wi-Fi e por quanto tempo. Além disso, era integrado a anúncios para possibilitar o direcionamento para clientes que usaram essa Wi-Fi. Esse produto foi descontinuado em 12 de junho de 2023. Como o período de aviso para parceiros foi encerrado, todos os pontos de extremidade usados pelo Facebook Wi-Fi versão 1 e 2 foram descontinuados e removidos.

Descontinuações de versões de API:

Confira a programação do Facebook para a descontinuação de versões da Graph API e da API de Marketing:

Graph API

• 14 de setembro de 2023: a Graph API versão 11.0 será descontinuada e removida da plataforma
• 8 de fevereiro de 2024: a Graph API versão 12.0 será descontinuada e removida da plataforma
• 28 de maio de 2024: a Graph API versão 13.0 será descontinuada e removida da plataforma

API de Marketing

• 20 de setembro de 2023: a API de Marketing versão 14.0 será descontinuada e removida da plataforma
• 20 de setembro de 2023: a API de Marketing versão 15.0 será descontinuada e removida da plataforma
• 6 de fevereiro de 2024: a API de Marketing versão 16.0 será descontinuada e removida da plataforma

Para evitar interrupção dos negócios, recomendamos fazer a migração de todas as chamadas para a versão mais recente da API lançada hoje.

SDK da plataforma do Facebook

Como parte da nossa programação de descontinuação em dois anos para SDKs da plataforma, veja os próximos itens que serão descontinuados e as próximas interrupções:

• Outubro de 2023: o SDK da plataforma do Facebook v11.0 ou anterior será interrompido
• Fevereiro de 2024: o SDK da plataforma do Facebook v12.0 ou anterior será interrompido