Partilhar via

Notificações dos Serviços de Comunicação

  • Artigo

Os SDKs de chat e chamada dos Serviços de Comunicação do Azure 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. Isso permite que você crie uma funcionalidade de comunicação rica e 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 só permanece conectado quando seu aplicativo está ativo em primeiro plano. Se você quiser que seus usuários recebam chamadas ou mensagens de bate-papo enquanto seu aplicativo está em segundo plano, você deve usar notificações por push.

As notificações push permitem-lhe enviar informações da sua aplicação para os dispositivos móveis dos utilizadores. Você pode usar notificações por push para mostrar uma caixa de diálogo, reproduzir um som ou exibir a interface do usuário da 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 seus aplicativos.

Acionar notificações por push por meio da Grade de Eventos do Azure

Os Serviços de Comunicação do Azure integram-se com a Grelha de Eventos do Azure para fornecer notificações de eventos em tempo real de uma forma fiável, escalável e segura. Você pode aproveitar essa integração para criar um serviço de notificação que forneça notificações por push móveis aos seus usuários criando uma assinatura de grade de eventos que aciona uma Função do Azure ou um webhook.

Diagrama mostrando como os Serviços de Comunicação se integram à Grade de Eventos.

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

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

Importante

Os Hubs de Notificação do Azure anunciaram que a API herdada do Firebase Cloud Messaging (FCM) será preterida em julho de 2024. Isso afetará todos os aplicativos de Chamada e Chat dos Serviços de Comunicação do Azure que enviam notificações por push do Android. Os clientes afetados precisarão migrar seus registros do legado do FCM para o FCM v1, e podem começar a fazê-lo em março de 2024. Para obter mais informações, incluindo etapas de migração, consulte a documentação do Hub de Notificação.

Você pode conectar um Hub de Notificação do Azure ao seu recurso de Serviços de Comunicação para enviar automaticamente notificações por push para o dispositivo móvel de um usuário quando ele receber uma chamada de entrada ou para notificá-lo sobre atividades de bate-papo perdidas. Você deve usar essas notificações por push para despertar seu aplicativo a partir do plano de fundo e exibir a interface do usuário que permite que o usuário aceite ou recuse a chamada ou leia a mensagem de bate-papo recém-recebida.

Diagrama mostrando como os serviços de comunicação se integram aos Hubs de Notificação do Azure.

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

Nota

Atualmente, as notificações push de chamadas e bate-papo são compatíveis com Android e iOS.

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 dentro da mesma assinatura que seu recurso de Serviços de Comunicação. Você deve configurar o Hub de Notificação 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 dos Hubs de Notificação, consulte Introdução aos Hubs de Notificação e selecione sua plataforma de cliente de destino na lista suspensa na parte superior da página.

Nota

Atualmente, as plataformas APNs e FCM são suportadas. A plataforma APNs precisa ser configurada com o modo de autenticação de token. O modo de autenticação de certificado não é suportado a partir de agora.

Depois que o hub de Notificação estiver configurado, você poderá associá-lo ao recurso dos 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 Send permissões. Recomendamos a criação de outra política de acesso apenas com Send permissões específicas para o seu hub. Saiba mais sobre as políticas de segurança e acesso dos Hubs de Notificação

Para iniciar sessão no Azure Resource Manager, execute o seguinte e inicie sessão utilizando as suas credenciais.

armclient login

Uma vez conectado 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>'}"

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

  2. Dentro do recurso Serviços de Comunicação, selecione Notificações por Push no menu esquerdo da página Serviços de Comunicação e conecte o Hub de Notificação que você provisionou anteriormente.

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

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

    • Se você precisar criar um novo hub, selecione Criar novo hub de notificação para obter um novo hub provisionado para esse recurso.

    Captura de ecrã a mostrar as definições de Notificações Push no portal do Azure.

Agora você verá 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ção diferente.

Nota

Qualquer alteração na forma como o hub está vinculado é refletida no plano de dados (ou seja, ao enviar uma notificação) dentro de um período máximo de 10 minutos. Esse mesmo comportamento se aplica quando o hub é vinculado pela primeira vez, se as notificações foram enviadas antes da alteração.

Registo de dispositivos

Consulte o início rápido de chamadas de voz e o início rápido de bate-papo para saber como registrar o identificador do dispositivo com os Serviços de Comunicação.

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

Quando não vê notificações push no seu dispositivo, existem três locais onde as notificações podem ter sido 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 da Plataforma não entregou a notificação ao dispositivo.

O primeiro local onde uma notificação pode ser descartada (os Hubs de Notificação do Azure não aceitaram as notificações dos Serviços de Comunicação do Azure) é abordado abaixo. Para os outros dois locais, consulte Diagnosticar notificações descartadas nos Hubs de Notificação do Azure.

Uma maneira de ver se seu recurso de Serviços de Comunicação envia notificações para os Hubs de Notificação do Azure é examinando a incoming messages métrica das métricas vinculadas do Hub de Notificação do Azure.

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

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

Pode haver o caso de você não vincular seu Hub de Notificação do Azure ao recurso dos Serviços de Comunicação. Você pode dar uma olhada na seção de provisionamento do Hub de Notificação para ver como vinculá-los.

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

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

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

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

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

Caso você queira usar a plataforma APNs com o modo de autenticação de certificado, ela não é suportada 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ção.

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

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

A cadeia de conexão vinculada ou o resourceId do Hub de Notificação do Azure não são válidos

Certifique-se de configurar o recurso dos Serviços de Comunicação com a cadeia de conexão correta e o resourceId do Hub de Notificação do Azure

A cadeia de conexão vinculada é regenerada

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

Próximos passos