Vue d’ensemble des notifications Push

Le Kit de développement logiciel (SDK) Conversation Azure Communication Services et le Kit de développement logiciel (SDK) d’appel créent un canal de messagerie en temps réel qui permet d’envoyer des messages de signalisation à des clients connectés de manière efficace et fiable. Cette fonctionnalité vous permet de créer des fonctionnalités de communication en temps réel enrichies dans vos applications sans avoir à implémenter une logique d’interrogation HTTP complexe. Toutefois, sur les applications mobiles, ce canal de signalisation reste connecté uniquement quand votre application est active au premier plan. Si vous souhaitez que vos utilisateurs reçoivent des appels entrants ou des messages de conversation lorsque votre application est en arrière-plan, vous devez utiliser des notifications Push.

Les notifications Push vous permettent d’envoyer des informations de votre application aux appareils mobiles des utilisateurs. Vous pouvez utiliser des notifications Push pour afficher une boîte de dialogue, émettre un signal sonore ou afficher l’interface utilisateur des appels entrants. Azure Communication Services fournit des intégrations avec Azure Event Grid et Azure Notification Hubs qui vous permettent d’ajouter des notifications Push à vos applications.

Déclencher des notifications Push via Azure Event Grid

Azure Communication Services s'intègre à Azure Event Grid pour fournir des notifications d'événements en temps réel de manière fiable, scalable et sécurisée. Vous pouvez utiliser cette intégration pour créer un service de notification qui remet des notifications Push mobiles à vos utilisateurs en créant un abonnement Event Grid qui déclenche une fonction Azure ou un webhook.

Apprenez-en davantage sur la gestion des événements dans Azure Communication Services.

Envoyer des notifications Push via Azure Notification Hubs

Vous pouvez connecter un hub de notification Azure à votre ressource Communication Services afin d’envoyer automatiquement des notifications Push à l’appareil mobile d’un utilisateur lors de la réception d’un appel entrant, ou de l’informer d’une activité de conversation manquée. Vous devez utiliser ces notifications Push pour réveiller votre application à partir de l’arrière-plan et afficher l’interface utilisateur permettant à l’utilisateur d’accepter ou de refuser l’appel, ou de lire le message de conversation nouvellement reçu.

Communication Services utilise Azure Notification Hub en tant que service direct pour communiquer avec les différents services de notification Push spécifiques à la plateforme à l’aide de l’API Envoi direct. Cette fonctionnalité vous permet de réutiliser vos ressources et configurations Azure Notification Hub existantes pour fournir des notifications fiables et à faible latence à vos applications.

Provisionnement des hubs de notification

Pour envoyer des notifications Push aux appareils clients à l’aide de Notification Hubs, créez un hub de notification dans le même abonnement que votre ressource Communication Services. Vous devez configurer le hub de notification Azure pour le système Platform Notification System que vous souhaitez utiliser. Pour savoir comment obtenir des notifications Push dans votre application cliente provenant de Notification Hubs, consultez Prise en main de Notification Hubs et sélectionnez votre plateforme de client cible dans la liste déroulante en haut de la page.

La plateforme APNs doit être configurée avec le mode d’authentification par jeton. Le mode d’authentification par certificat n’est pas pris en charge pour le moment.

Une fois que votre hub de notification est configuré, vous pouvez l’associer à votre ressource Communication Services en fournissant une chaîne de connexion pour le hub à l’aide du client Azure Resource Manager ou par le biais du portail Azure. La chaîne de connexion doit contenir des autorisations Send. Nous vous recommandons de créer une autre stratégie d’accès avec des autorisations Send uniquement, spécifiquement pour votre hub. Découvrez plus en détail les stratégies de sécurité et d’accès de Notification Hubs

Utilisation du client Azure Resource Manager pour lier votre hub de notification

Pour vous connecter à Azure Resource Manager, exécutez la commande suivante et connectez-vous à l’aide de vos informations d’identification.

armclient login

Une fois connecté, exécutez la commande suivante pour provisionner le hub de notification :

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>'}"

Utilisation du portail Azure pour lier votre hub de notification

1. Dans le portail, accédez à votre ressource Azure Communication Services.

2. Dans la ressource Communication Services, sélectionnez Notifications Push dans le menu de gauche de la page Communication Services et connectez le hub de notification que vous avez approvisionné précédemment.

3. Sélectionnez Connecter le hub de notification. Vous voyez la liste des hubs de notification disponibles pour vous connecter.

4. Sélectionnez le hub de notification que vous souhaitez utiliser pour cette ressource.

   • S’il vous faut créer un hub, sélectionnez Créer un hub de notification pour obtenir un nouveau hub approvisionné pour cette ressource.

   

Vous voyez maintenant le hub de notification que vous avez lié à l’état connecté.

Si vous souhaitez utiliser un autre hub pour la ressource, sélectionnez Déconnecter, puis répétez les étapes pour lier cet autre hub de notification.

Enregistrement de l’appareil

Pour découvrir comment inscrire votre descripteur d’appareil auprès de Communication Services, consultez le guide de démarrage rapide des appels vocaux et le guide de démarrage rapide de conversation.

Guide de résolution des problèmes pour les notifications Push

Lorsque vous ne voyez pas de notifications Push sur votre appareil, il existe trois emplacements où les notifications peuvent être supprimées :

• Azure Notification Hubs n’a pas accepté la notification d’Azure Communication Services
• Le système Platform Notification System (par exemple APNs et FCM) n’a pas accepté la notification d’Azure Notification Hubs
• Le système Platform Notification System n’a pas remis la notification à l’appareil.

Le premier endroit où une notification peut être supprimée (Azure Notification Hubs n’a pas accepté les notifications d’Azure Communication Services) est abordée dans la description suivante. Pour plus d’informations, consultez Diagnostiquer les notifications supprimées dans Azure Notification Hubs.

Pour savoir si votre ressource Communication Services envoie des notifications à Azure Notification Hubs, examinez la métrique incoming messages dans les métriques Azure Notification Hub liées.

Voici quelques erreurs de configuration courantes qui peuvent constituer la raison pour laquelle Azure Notification Hub n’accepte pas les notifications de votre ressource Communication Services.

Le hub de notification Azure n’est pas lié à la ressource Communication Services

Il se peut que vous n’ayez pas lié le hub de notification Azure à la ressource Communication Services. Vous pouvez consulter la section Provisionnement des hubs de notification pour voir comment les lier.

Le hub de notification Azure lié n’est pas configuré

Vous devez configurer le hub de notification lié avec les informations d’identification du système Platform Notification System pour la plateforme (par exemple, iOS ou Android) que vous souhaitez utiliser. Pour plus d’informations sur la façon de procéder, consultez Configurer les notifications Push dans un hub de notification.

Le hub de notification Azure lié n’existe pas

Le hub de notification Azure lié à votre ressource Communication Services n’existe plus. Vérifiez que le hub de notification lié existe toujours.

La plateforme APNs Azure Notification Hub est configurée avec le mode d’authentification par certificat

Si vous souhaitez utiliser la plateforme APNs avec le mode d’authentification par certificat, elle n’est actuellement pas prise en charge. Vous devez configurer la plateforme APNs avec le mode d’authentification par jeton comme indiqué dans Configurer les notifications Push dans un hub de notification.

La chaîne de connexion liée n’a pas d’autorisation Send

La chaîne de connexion que vous avez utilisée pour lier le hub de notification à la ressource Communication Services doit disposer de l’autorisation Send. Pour plus d’informations sur la façon dont vous pouvez créer une nouvelle chaîne de connexion ou voir la chaîne de connexion actuelle à partir de votre hub de notification Azure, consultez les stratégies de sécurité et d’accès Notification Hubs

La chaîne de connexion liée ou l’ID de ressource du hub de notification Azure ne sont pas valides

Veillez à configurer la ressource Communication Services avec la chaîne de connexion correcte et l’ID de ressource du hub de notification Azure

La chaîne de connexion liée est regénérée

Si vous avez régénéré la chaîne de connexion de votre hub de notification Azure lié, vous devez mettre à jour la chaîne de connexion avec la nouvelle dans votre ressource Communication Services en relinkant le hub de notification.

Étapes suivantes

• Pour découvrir Azure Event Grid, consultez Présentation d’Event Grid.
• Pour en savoir plus sur les concepts d’Azure Notification Hub, consultez la documentation d’Azure Notification Hubs.