Visão geral das notificações por push

O SDK de Chat dos Serviços de Comunicação do Azure e o SDK de Chamada criam um canal de mensagens em tempo real que permite que as mensagens de sinalização sejam enviadas por push para clientes conectados de maneira eficiente e confiável. Essa capacidade permite que você crie funcionalidades avançadas de comunicação em tempo real em seus aplicativos sem a necessidade de implementar uma lógica de sondagem HTTP complicada. No entanto, em aplicativos móveis, esse canal de sinalização permanece conectado somente quando o aplicativo está ativo em primeiro plano. Se desejar que os usuários recebam chamadas de entrada ou mensagens de chat com o aplicativo em segundo plano, você deverá usar notificações por push.

As notificações por push permitem que você envie informações do aplicativo para os dispositivos móveis dos usuários. Você pode usar notificações por push para mostrar uma caixa de diálogo, tocar um som ou exibir a interface do usuário de chamada de entrada. Os Serviços de Comunicação do Azure fornecem integrações com a Grade de Eventos do Azure e os Hubs de Notificação do Azure, que permitem adicionar notificações por push aos aplicativos.

Disparar notificações por push usando a Grade de Eventos do Azure

Os Serviços de Comunicação do Azure integram-se à Grade de Eventos do Azure para fornecer notificações de eventos em tempo real de maneira confiável, escalonável e segura. Você pode usar esta integração para criar um serviço de notificação que envie notificações por push aos seus usuários criando uma assinatura da Grade de Eventos que acione uma Função do Azure ou webhook.

Saiba mais sobre o processamento de eventos nos Serviços de Comunicação do Azure.

Entregar notificações por push pelos Hubs de Notificação do Azure

Você pode conectar um Hub de Notificações do Azure ao seu recurso de Serviços de Comunicação para enviar notificações por push automaticamente ao dispositivo móvel de um usuário quando ele receber uma chamada ou notificá-lo sobre a atividade de chat perdida. Use essas notificações por push para ativar o aplicativo em segundo plano e exibir a interface do usuário que permite aos usuários aceitar ou recusar a chamada ou ler a mensagem de chat recém chegada.

Os Serviços de Comunicação usam o Hub de Notificação do Azure como um serviço de passagem para comunicar-se com os vários serviços de notificação por push específicos da plataforma usando a API de Envio Direto. Esse recurso permite reutilizar seus recursos e configurações existentes do Hub de Notificação do Azure para fornecer notificações confiáveis e de baixa latência aos seus aplicativos.

Provisionamento do Hub de Notificação

Para entregar notificações por push a dispositivos cliente usando Hubs de Notificação, crie um Hub de Notificação na mesma assinatura que o recurso de Serviços de Comunicação. Você deve configurar o Hub de Notificações do Azure para o Sistema de Notificação de Plataforma que deseja usar. Para saber como obter notificações por push em seu aplicativo cliente desde Hubs de Notificação, veja Introdução aos Hubs de Notificação e selecione a plataforma de cliente de destino na lista suspensa na parte superior da página.

A plataforma de APNs precisa ser configurada com o modo de autenticação de token. De agora em diante, o modo de autenticação de certificado não é mais compatível.

Depois que o hub de notificações estiver configurado, você poderá associá-lo ao recurso de Serviços de Comunicação fornecendo uma cadeia de conexão para o hub usando o Cliente do Azure Resource Manager ou por meio do portal do Azure. A cadeia de conexão deve conter permissões para Send. É recomendável criar outra política de acesso com permissões para Send apenas para o hub. Saiba mais sobre políticas de acesso e segurança dos Hubs de Notificação

Como usar o cliente do Azure Resource Manager para vincular o Hub de Notificações

Para fazer logon no Azure Resource Manager, execute o comando a seguir e entre usando suas credenciais.

armclient login

Depois de fazer logon com êxito, execute o seguinte para provisionar o hub de notificação:

armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"

Como usar o portal do Azure para vincular o Hub de Notificações

1. No portal, acesse o recurso dos Serviços de Comunicação do Azure.

2. Dentro do recurso dos Serviços de Comunicação, selecione Notificações por Push no menu à esquerda da página Serviços de Comunicação e conecte o Hub de Notificações provisionado antes.

3. Selecione Conectar hub de notificações. Você verá uma lista de hubs de notificação disponíveis para conexão.

4. Selecione o hub de notificações que você deseja usar para este recurso.

   • Se você precisar criar um hub, selecione Criar hub de notificações para obter um novo hub provisionado para este recurso.

   

Agora você vê o hub de notificação vinculado ao estado conectado.

Se você quiser usar um hub diferente para o recurso, selecione Desconectar e repita as etapas para vincular o hub de notificações diferente.

Registro de dispositivos

Confira o guia de início rápido de chamada de voz e o guia de início rápido de chat para saber como registrar seu identificador de dispositivo com os Serviços de Comunicação.

Guia de solução de problemas de notificações por push

Quando você não vê notificações por push em seu dispositivo, há três locais em que as notificações podem ser descartadas:

• Os Hubs de Notificação do Azure não aceitaram a notificação dos Serviços de Comunicação do Azure
• O Sistema de Notificação de Plataforma (por exemplo, APNs e FCM) não aceitou a notificação dos Hubs de Notificação do Azure
• O Sistema de Notificação de Plataforma não entregou a notificação ao dispositivo.

O primeiro lugar em que uma notificação pode ser removida (os Hubs de Notificação do Azure não aceitaram as notificações dos Serviços de Comunicação do Azure) é abordado na descrição a seguir. Para obter mais informações, consulte Diagnosticar notificações descartadas nos Hubs de Notificação do Azure.

Uma forma de ver se o recurso de serviços de comunicação envia notificações para os Hubs de Notificação do Azure é examinar a métrica incoming messages das métricas do hub de notificações do Azure vinculadas.

A seguir estão algumas configurações incorretas comuns que podem ser a causa pela qual o Hub de Notificações do Azure não aceita as notificações do recurso de Serviços de Comunicação.

Hub de Notificações do Azure não vinculado ao recurso de Serviços de Comunicação

Pode haver o caso em que você não vinculou o Hub de Notificações do Azure ao recurso de Serviços de Comunicação. Você pode examinar a Seção de provisionamento do Hub de Notificações para ver como vincular.

O Hub de Notificações do Azure vinculado não está configurado

Você precisa configurar o Hub de Notificações vinculado com as credenciais do Sistema de Notificação de Plataforma da plataforma (por exemplo, iOS ou Android) que deseja usar. Para obter mais detalhes sobre como isso pode ser feito, você pode examinar Configurar notificações por push em um hub de notificações.

O Hub de Notificações do Azure vinculado não existe

O Hub de Notificações do Azure vinculado ao recurso de Serviços de Comunicação não existe mais. Verifique se o Hub de Notificações vinculado ainda existe.

A plataforma APNs do Hub de Notificações do Azure está configurada com o modo de autenticação de certificado

Caso deseje usar a plataforma APNs com o modo de autenticação de certificado, ela não tem suporte no momento. Você deve configurar a plataforma APNs com o modo de autenticação de token, conforme especificado em Configurar notificações por push em um hub de notificações.

A cadeia de conexão vinculada não tem a permissão Send

A cadeia de conexão que você usou para vincular o Hub de Notificações ao recurso de Serviços de Comunicação precisa ter a permissão Send. Para obter mais detalhes sobre como você pode criar uma nova cadeia de conexão ou ver a cadeia de conexão atual do Hub de Notificação do Azure, consulte políticas de segurança e acesso dos Hubs de Notificação

A cadeia de conexão vinculada ou a ID de recurso do Hub de Notificações do Azure não é válida

Configure o recurso de Serviços de Comunicação com a cadeia de conexão correta e a ID de recurso apropriada do hub de notificações do Azure

A cadeia de conexão vinculada é regenerada

Se você regenerou a cadeia de conexão do seu Hub de Notificação do Azure vinculado, será necessário atualizar a cadeia de conexão com a nova no seu recurso dos Serviços de Comunicação, vinculando novamente o Hub de Notificação.

Próximas etapas

• Para ver uma introdução à Grade de Eventos do Azure, confira O que é uma Grade de eventos?.
• Para saber mais sobre os conceitos do Hub de Notificação do Azure, consulte a documentação dos Hubs de Notificação do Azure.