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

Hoje estamos lançando a versão 16.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 a lista completa de alterações e detalhes, consulte o Registro de alterações.

Atualizações e anúncios gerais

Respostas de erro da Plataforma do WhatsApp Business

Como parte dos nossos esforços contínuos para melhorar o comportamento de respostas de erro da API, fizemos as alterações a seguir.

• Os subcódigos de erros (que não são confiáveis e são raramente usados) não serão mais incluídos nas respostas de erro da versão 16.0 e posteriores. Em vez disso, use code e details.
• O código de erro 100 ("code":100) usava vários títulos únicos que indicavam a natureza do erro. Agora, todos os erros com o código 100 terão "Invalid parameter" como título. Os títulos antigos que descreviam a natureza do código de erro 100 foram transferidos para a propriedade "details". Essa alteração também ocorreu nas cargas de webhooks que descrevem respostas de erro com o código 100.
• Os objetos de erros Webhook ganharam uma nova propriedade message, que mapeia para a propriedade message nas cargas de resposta de erro da API.

Agora a Plataforma do Desenvolvedor exigirá a verificação da empresa para acesso avançado a todas as APIs

Conforme anunciado em 1º de fevereiro de 2023, a Meta passará a solicitar que os desenvolvedores verifiquem as empresas para obter acesso avançado a todas as permissões da plataforma. Isso é parte do processo para confirmar a autenticidade e legitimidade de empresas e organizações.

Para apps criados depois de 1º de fevereiro de 2023, isso será introduzido progressivamente quando o acesso avançado for solicitado. A partir de 1º de maio de 2023, os apps com acesso avançado que foram criados antes de 1º de fevereiro desse ano precisarão ser vinculados a uma empresa verificada. Para ver a lista de permissões que exigem a verificação da empresa antes de serem aprovadas para o acesso avançado, consulte esta página.

Itens que se tornaram obsoletos e alterações disruptivas

Descontinuação da Consideração de viagem

Em 2018, lançamos a Consideração de viagem como um botão que os anunciantes de viagens podiam ativar. Isso priorizava a veiculação dos anúncios para pessoas que haviam expressado intenção de viajar, mas não haviam decidido ainda para onde ir. A Consideração de viagem funcionava em conjunto com as opções de direcionamento existentes. O objetivo era ajudar os anunciantes a veicular anúncios para as pessoas certas, no momento certo, no Facebook, Instagram e Audience Network. Nos últimos quatro anos, com o desenvolvimento contínuo dos nossos sistemas de aprendizado de máquina e muitos testes, podemos agora ajudar os anunciantes de viagens a alcançar os consumidores que pretendem viajar e alcançar metas de desempenho semelhantes sem a necessidade do botão.

A partir de 2 de fevereiro de 2023, o botão Consideração de viagem será removido do Gerenciador de Anúncios e da API para as novas campanhas. Determinamos que o botão não é mais necessário e esperamos que os anunciantes tenham o mesmo desempenho sem ele. No meio tempo, a ativação ou desativação do botão dificilmente terá um impacto perceptível no desempenho da campanha.

À medida que os modelos de aprendizado de máquina melhoram, as mesmas metas e desempenho podem ser alcançados sem a opção do botão. Portanto, acreditamos que, ao removê-lo, a experiência será mais simples.

Descontinuação dos Anúncios de voo para prospecção

Em setembro de 2018, lançamos os Anúncios de voo para prospecção. Em meados de 2021, o produto começou a passar por desafios técnicos. Foram identificados erros que impediam a veiculação eficiente de campanhas. Portanto, tomamos a decisão de dizer de forma proativa aos anunciantes para mudarem para outras opções de prospecção. O recurso de redirecionamento ainda continua e pode ser usado pelos anunciantes.

Se você ou um parceiro estiver usando os Anúncios de voo para prospecção, recomendamos que as campanhas atuais sejam desativadas até 1º de maio de 2023.

Descontinuação do posicionamento de anúncio em Instant Articles

Removeremos os Instant Articles e o respectivo posicionamento de anúncio a partir de 20 de abril de 2023. Lançamos os Instant Articles em 2015 para permitir que os publishers criassem artigos de mídia interativos em dispositivos móveis e os monetizassem com anúncios no Facebook. No entanto, a descoberta de notícias é uma pequena parte da experiência do Facebook para a maioria dos usuários. As pessoas nos dizem que querem ver menos desse tipo de conteúdo em seus Feeds. Assim, estamos ajustando nossos investimentos para que se alinhem melhor às preferências dos usuários.

A partir de 20 de abril de 2023, o posicionamento de anúncio em Instant Articles não estará mais disponível para a criação de novas campanhas no Gerenciador de Anúncios e na API Marketing. Depois dessa data, os conjuntos de anúncios anteriores que contenham exclusivamente o posicionamento em Instant Articles serão pausados. Todos os outros conjuntos de anúncios que incluam esse posicionamento serão atualizados automaticamente e excluirão o posicionamento.

Ocultar reações, comentários e marcações em conteúdo postado em perfis de usuários

Com esse lançamento, estamos implementando uma alteração que fará com que comentários, reações e marcações do usuário da sessão sejam ocultados. Os campos "via" e "sharedposts" também retornarão dados vazios para posts em perfis de usuários. Essa alteração afetará somente os conteúdos postados em perfis de usuários.

Descontinuação do suporte para versões do TLS anteriores à 1.2

Para melhorar nossa postura de segurança, vamos descontinuar o suporte das Graph APIs para versões do TLS anteriores à 1.2. Se você estiver usando o TLS 1.2, o acesso por meio de cifras RSA estáticas (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) também será descontinuado. As solicitações de API feitas com versões mais antigas do TLS resultarão em erro após 90 dias.

Rejeitaremos também o tráfego da web para developer.facebook.com depois de 1º de maio de 2023 a partir de navegadores que usem versões do TLS mais antigas (anteriores à TLS 1.2 e que usem cifras RSA estáticas [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] durante o uso de TLS1.2).

Categorias de modelo do WhatsApp

No ano passado, atualizamos os tipos de categorias de modelos no Gerenciador do WhatsApp e na API para capturar novos casos de uso enviados na Plataforma do WhatsApp Business. Em 2 de fevereiro de 2023, daremos um novo nome às categorias de modelo para refletir com mais precisão os casos de uso:

• Os modelos de marketing continuarão sendo chamados de marketing (sem alteração)
• Os modelos de transações serão renomeados para utility
• Os modelos de OTP serão renomeados para authentication

As empresas devem usar essas categorias de modelos atualizadas para criar ou editar modelos usando a Graph v16. Em 1º de maio, essa alteração será aplicada a todas as versões. Portanto, todas as tentativas de criar ou editar modelos usando qualquer versão deverão utilizar essas novas categorias. Para garantir que não haja interrupção no processo de criação ou edição de modelos, as empresas e os BSPs devem priorizar a atualização das suas chamadas de API para usar os novos valores de categoria e modelos até 1º de maio de 2023.

Veja abaixo algumas outras datas e considerações importantes:

• Migração de modelo: em 1º de abril, o WhatsApp migrará todos os modelos existentes para as novas categorias de modelos. As empresas podem ver a nova categorização dos modelos no Gerenciador do WhatsApp e terão até 15 de maio para analisá-los. Caso uma empresa discorde da categorização, ela pode fazer uma apelação até o dia 15 de maio. Todos os modelos recém-criados ou editados usando a Graph API v15 ou versões anteriores entre 1º de abril e 1º de maio serão migrados no dia 5 de maio. Portanto, recomendamos começar chamar a v16 para a criação de modelos a partir de 1º de abril. A partir de 1º de maio, todos os modelos criados no Gerenciador do WhatsApp ou em qualquer versão da Graph API refletirão as novas categorias de modelos.
• Criação de modelo nas novas categorias de modelos: a partir de 1º de abril, todos os modelos criados na Graph API v16 e no Gerenciador do WhatsApp exigirão a validação da categoria para aprovação. Os modelos recém-criados ou editados podem ser rejeitados se o WhatsApp detectar que uma categoria incorreta foi selecionada. O motivo da rejeição explicará que a categoria selecionada não corresponde ao conteúdo do modelo, de acordo com nossas diretrizes para modelos. As empresas poderão, então, optar por modificar a seleção da categoria e enviar novamente, editar o modelo ou fazer uma apelação da decisão. A partir de 1º de maio, os modelos recém-criados com variáveis precisarão incluir exemplos. A partir de 1º de junho, as empresas serão cobradas com base em novas tarifas por categoria de modelo.

Plataforma da Messenger API

Estamos simplificando as notificações recorrentes, removendo a opção de especificar a frequência das mensagens a partir da versão 16. Para ver mais informações, consulte Registro de alterações da plataforma do Messenger.

Descontinuações de versões de API:

Veja as versões da Graph API e da API de Marketing que ficarão obsoletas:

Graph API

• 23 de fevereiro de 2023: a Graph API v9.0 ficará obsoleta e será removida da plataforma
• 8 de junho de 2023: a Graph API v10.0 ficará obsoleta e será removida da plataforma
• 14 de setembro de 2023: a Graph API v11.0 ficará obsoleta e será removida da plataforma

API de Marketing

• 25 de abril de 2023: a API de Marketing v14.0 ficará obsoleta e será 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 obsoletos e as próximas interrupções:

• Junho de 2023: o SDK da plataforma do Facebook v9.0 ou anterior será interrompido
• 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