Guia de 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 de push fácil de usar e que se expande. 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 são os Hubs de Notificação do Azure?.

Neste início rápido, você usará as configurações do sistema de notificação da plataforma (PNS) nos Hubs de Notificação para configurar notificações por push em várias plataformas. O 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.

Nota

Para obter informações sobre as etapas de descontinuação e migração do Firebase Cloud Messaging, consulte 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, consulte 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.

Serviço Apple Push Notification

Para configurar o Serviço de Notificação por Push da Apple (APNS):

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

2. Em Modo de autenticação, selecione Certificado ou Token.

   a. Se você selecionar Certificado:

   • Selecione o ícone de ficheiro e, em seguida, selecione o ficheiro .p12 que pretende carregar.

   • Introduza uma palavra-passe.

   • Selecione o modo Sandbox. Ou, para enviar notificações por push aos usuários que compraram seu aplicativo na loja, selecione Modo de produção .

     

     b. Se você selecionar Token:

   • Insira os valores para ID de chave, ID de pacote, ID de equipe e Token.

   • Selecione o modo Sandbox. Ou, para enviar notificações por push aos usuários que compraram seu aplicativo na loja, selecione Modo de produção .

     

Para obter mais informações, consulte Enviar notificações por push para aplicativos iOS usando os Hubs de Notificação do 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 (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 Guardar.

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

Mensagens na nuvem do Google Firebase (FCM)

Nota

O Firebase Cloud Messaging (FCM) foi preterido e não é mais suportado.

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 para o projeto do Google FCM que você salvou anteriormente.

3. Selecione Guardar.

   

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

CLI do Azure

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

Prepare o seu ambiente para o CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

• Este artigo requer a versão 2.0.67 ou posterior da CLI do Azure. Se estiver 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 se conectar 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 --query parâmetro 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 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, consulte Enviar notificações por push para dispositivos Android usando o Firebase.

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

Para 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 Guardar.

   

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

Baidu (Android China)

Para configurar notificações push para o 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 que você obteve do console do Baidu no projeto de push na nuvem do Baidu.

3. Insira a Chave Secreta que você obteve do console do Baidu no projeto de push na nuvem do Baidu.

4. Selecione Guardar.

   

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

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

Próximos passos

Neste guia de início rápido, você aprendeu como definir as configurações do 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 Azure
• Enviar notificações para dispositivos Android usando os Hubs de Notificação e o Google FCM
• Enviar notificações para um aplicativo UWP em execução em um dispositivo Windows
• Enviar notificações usando os Hubs de Notificação e o Baidu cloud push