Compartilhar via

Hubs de Notificação do Azure e a migração para o Google Firebase Cloud Messaging

  • Artigo

As principais funcionalidades da integração dos Hubs de Notificação do Azure com o FCM (Firebase Cloud Messaging) v1 estão disponíveis. Como lembrete, a Google deixará de dar suporte ao HTTP herdado do FCM em 20 de junho de 2024, portanto, antes dessa data, você deve migrar seus aplicativos e conteúdos de notificação para o novo formato.

Importante

A partir de junho de 2024, as APIs legadas do FCM não terão mais suporte e serão descontinuadas. Para evitar qualquer interrupção no seu serviço de notificação push, você deve migrar para o protocolo FCM v1 o mais rápido possível.

Conceitos do FCM v1

  • Um novo tipo de plataforma chamado FCM v1 tem suporte.
  • Novas APIs, credenciais, instalações e registros são usados para o FCM v1.

Etapas da migração

A API herdada do FCM (Firebase Cloud Messaging) será preterida até julho de 2024. Você pode começar a migrar do protocolo HTTP herdado para o FCM v1 agora. É necessário concluir a migração até junho de 2024.

Perguntas frequentes

Esta seção fornece respostas a perguntas frequentes sobre a migração da FCM herdada para a FCM v1.

Como criar registros de modelo FCM v1 com SDKs ou APIs REST?

Para obter instruções sobre como criar registros de modelo FCM v1, consulte Hubs de Notificação do Azure e a migração do Google Firebase Cloud Messaging (FCM) usando SDKs.

Preciso armazenar as credenciais herdadas da FCM e da FCM v1?

Sim, FCM herdado e FCM v1 são tratados como duas plataformas separadas nos Hubs de Notificação do Azure, portanto, você deve armazenar credenciais FCM herdadas e FCM v1 separadamente. Para obter mais informações, consulte as instruções para configurar credenciais.

Como posso verificar se as operações de envio estão passando pelo pipeline da FCM v1 em vez do pipeline herdado da FCM?

A resposta de envio de depuração contém uma propriedade results, que é uma matriz de resultados de registro para o envio de depuração. Cada resultado de registro especifica a plataforma do aplicativo. Além disso, oferecemos telemetria por mensagem para hubs de notificação de camada padrão. Essa telemetria apresenta GcmOutcomeCounts e FcmV1OutcomeCounts, o que pode ajudá-lo a verificar qual plataforma é usada para operações de envio.

Preciso criar novos registros para a FCM v1?

Sim, mas você pode usar importação/exportação. Depois de atualizar o SDK do cliente, ele cria tokens de dispositivo para registros FCM v1.

A documentação do Google Firebase diz que nenhuma alteração do lado do cliente é necessária. Preciso fazer alterações nos Hubs de Notificação para garantir que minhas notificações sejam enviadas por meio da FCM v1?

Para operações de envio direto, não há alterações específicas dos Hubs de Notificação que precisam ser feitas no dispositivo cliente. Se você armazenar instalações ou registros com os Hubs de Notificação do Azure, deverá informar aos Hubs de Notificação que deseja escutar a plataforma migrada (FCM v1). Independentemente de você usar os Hubs de Notificação ou o Firebase diretamente, as alterações de conteúdo são necessárias. Consulte a documentação sobre como migrar para a FCM v1.

Meus comentários de PNS mostram "erro desconhecido" ao enviar uma mensagem FCM v1. O que devo fazer para corrigir esse erro?

Os Hubs de Notificação do Azure estão trabalhando em uma solução que reduz o número de vezes que o "erro desconhecido" é mostrado. Enquanto isso, os clientes da camada padrão podem usar a API de comentários de notificação para examinar as respostas.

Como os clientes do Xamarin podem migrar para a FCM v1?

No momento, o Xamarin está preterido. Os clientes do Xamarin devem migrar para o .NET MAUI, mas o MAUI não tem suporte atualmente pelos Hubs de Notificação do Azure. Os aplicativos MAUI podem usar o SDK do Hub de Notificação do Android nativo ou lógicoAPI REST. É recomendável que os clientes do Xamarin abandonem os Hubs de Notificação se precisarem de envios de FCM v1.

Próximas etapas