Início Rápido: Configurar notificações por push em um hub de notificação

Os hubs de notificação do Azure fornecem um mecanismo por push que é fácil de usar e que pode ser dimensionado. Use os Hubs de Notificação para enviar notificações para qualquer plataforma (iOS, Android, Windows, Baidu) e de qualquer back-end (nuvem ou local). Para obter mais informações, consulte O que Hubs de Notificações do Microsoft Azure?.

Neste início rápido, você usará as configurações do sistema de notificação de plataforma (PNS) nos Hubs de Notificação para configurar as notificações em várias plataformas. O guia de início rápido mostra as etapas a serem executadas no portal do Azure. O Google Firebase Cloud Messaging inclui instruções para usar a CLI do Azure.

Observação

Para obter informações sobre as etapas de substituição e migração do Firebase Cloud Messaging, confira Migração do Google Firebase Cloud Messaging.

Se você ainda não criou um hub de notificação, crie um agora. Para obter mais informações, confira Criar um hub de notificação do Azure no portal do Azure ou Criar um hub de notificação do Azure usando a CLI do Azure.

Apple Push Notification Service

Para configurar p Apple Push Notification Service (APNS):

1. No portal do Azure, na página Hub de Notificação selecione Apple (APNS) no menu esquerdo.

2. Para o Modo de Autenticação, selecione Certificado ou Token.

   a. Se você selecionar Certificado:

   • Selecione o ícone de arquivo, e em seguida, o arquivo .p12 que você deseja carregar.

   • Digite uma senha.

   • Selecione o modo Sandbox. Ou, para enviar notificação por push aos usuários que compraram seu aplicativo da loja, selecione o modo Produção.

     

     b. Se você selecionar Token:

   • Insira os valores de Identificação da chave, ID do pacote, ID da equipe e Token.

   • Selecione o modo Sandbox. Ou, para enviar notificação por push aos usuários que compraram seu aplicativo da loja, selecione o modo Produção.

     

Para obter mais informações, confira Enviar notificações por push para aplicativos iOS usando os Hubs de Notificação do Microsoft Azure.

Google Firebase Cloud Messaging V1 (FCMv1)

Para configurar notificações por push para o Google FCMv1:

1. No portal do Azure, na página Hub de Notificação, selecione Google (GCM/FCMv1) no menu à esquerda.
2. Atualize os valores de Chave Privada, ID do Projeto e Email do Cliente do arquivo JSON da conta de serviço obtido do Console do Firebase.
3. Selecione Salvar.

Quando você concluir essas etapas, um alerta indica que o hub de notificação foi atualizado com êxito. O botão Salvar está desabilitado.

Google FCM (Firebase Cloud Messaging)

Observação

O FCM (Firebase Cloud Messaging) foi preterido e não tem mais suporte.

Portal

Para configurar notificações por push para o Google FCM:

1. No portal do Azure, na página Hub de Notificação, selecione Google (GCM/FCM) no menu à esquerda.

2. Cole a chave de API do projeto do Google FCM salva anteriormente.

3. Selecione Salvar.

   

Quando você concluir essas etapas, um alerta indica que o hub de notificação foi atualizado com êxito. O botão Salvar está desabilitado.

CLI do Azure

Você precisará da Chave de API para seu projeto do Google FCM (Firebase Cloud Messaging).

Preparar o ambiente para a CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Este artigo exige a versão 2.0.67 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

Configurar notificações por push para o Google FCM

1. Use o comando az notification-hub credential gcm update para adicionar sua chave de API do Google ao hub de notificação.

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. O aplicativo Android precisa de uma cadeia de conexão para conectar-se ao Hub de notificação. Use o comando az notification-hub authorization-rule list para listar as políticas de acesso disponíveis. Use o comando az notification-hub authorization-rule list-keys para obter as cadeias de conexão da política de acesso. Especifique primaryConnectionString ou secondaryConnectionString no parâmetro --query para obter a cadeia de conexão primária diretamente.

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. Use o comando az notification-hub test-send para testar o envio de mensagens para o aplicativo Android.

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

Obtenha as referências da CLI do Azure para outras plataformas com o comando az notification-hub credential.

Para obter mais informações sobre como enviar notificações para um aplicativo Android, confira Enviar notificações por push para dispositivos Android usando o Firebase.

Serviço de Notificação por Push do Windows

Configurar o Serviço de Notificação por Push do Windows (WNS):

1. No portal do Azure, na página Hub de Notificação, selecione Windows (WNS) no menu à esquerda.

2. Insira valores para SID do Pacote e Chave de Segurança.

3. Selecione Salvar.

   

Para obter mais informações, consulte Enviar notificações para aplicativos UWP usando os Hubs de Notificações do Microsoft Azure.

Baidu (Android China)

Configurar notificações por push para Baidu:

1. No portal do Azure, na página Hub de Notificação, selecione Baidu (Android China) no menu à esquerda.

2. Insira a chave de API obtida do console do Baidu no projeto de push da nuvem Baidu.

3. Insira a chave secreta obtida do console do Baidu no projeto de push da nuvem Baidu.

4. Selecione Salvar.

   

Quando você concluir essas etapas, um alerta indica que o hub de notificação foi atualizado com êxito. O botão Salvar está desabilitado.

Para obter mais informações, consulte Introdução aos Hubs de Notificações usando Baidu.

Próximas etapas

Neste Início Rápido, você aprendeu a configurar as definições de sistema de notificação da plataforma para um hub de notificação no portal do Azure.

Para saber mais sobre como enviar notificações por push para várias plataformas, consulte estes tutoriais:

• Enviar notificações por push para aplicativos iOS usando os Hubs de Notificação do Microsoft Azure
• Enviar notificações para os dispositivos Android usando os Hubs de Notificação do Microsoft Azure e o Google FCM
• Enviar notificações para um aplicativo UWP em um dispositivo Windows
• Enviar notificações usando os Hubs de Notificação e o push da nuvem Baidu