Notifications Communication Services

Les kits de développement logiciel (SDK) Azure Communication Services Chat et Calling créent un canal de messagerie en temps réel qui permet l’envoi (push) des messages de signalisation aux clients connectés de manière efficace et fiable. Cela vous permet de créer des fonctionnalités de communication riches en temps réel dans vos applications sans avoir à implémenter une logique d’interrogation HTTP compliquée. 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 à partir de votre application vers les 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 tirer parti de cette intégration pour créer un service de notification qui fournisse 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

Important

Microsoft Azure Notification Hubs a annoncé que l’API héritée Firebase Cloud Messaging (FCM) sera déconseillée en juillet 2024. Cette opération affectera toutes les applications d’appel et de conversation Azure Communication Services qui envoient des notifications Push Android. Les clients affectés doivent migrer leurs inscriptions de FCM hérité vers FCM v1 et peuvent commencer à le faire en mars 2024. Si vous souhaitez découvrir plus d’informations, notamment les étapes de migration, veuillez consulter la documentation Notification Hub.

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. Cela vous permet de réutiliser vos ressources et configurations Azure Notification Hub existantes pour fournir à vos applications des notifications fiables et à faible latence.

Remarque

Actuellement, les notifications Push d’appel et de conversation sont prises en charge pour Android et iOS.

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.

Remarque

Les plateformes APNs et FCM sont prises en charge. 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. La liste des hubs de notification disponibles pour la connexion s’affiche.

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.

   

Le hub de notification que vous avez lié à l’état connecté est à présent affiché.

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.

Remarque

Toute modification relative à la façon dont le hub est lié est reflétée dans le plan de données (par exemple lors de l’envoi d’une notification) pendant une période maximale de 10 minutes. Ce même comportement s’applique lorsque le hub est lié pour la première fois, si des notifications ont été envoyées avant la modification.

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

Quand vous ne voyez pas de notifications Push sur votre appareil, il existe trois emplacements où elles ont pu ê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 emplacement où une notification peut être supprimée (Azure Notification Hubs n’a pas accepté les notifications d’Azure Communication Services) est décrit ci-dessous. Pour les deux autres emplacements, consultez Diagnostiquer les problèmes de perte des notifications 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, celui-ci n’est pas pris en charge pour le moment. 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 de créer une chaîne de connexion ou d’afficher la chaîne de connexion actuelle à partir de votre hub de notification Azure, vous pouvez consulter 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 regé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 liant à nouveau le hub de notification.

Étapes suivantes

• Pour une présentation d’Azure Event Grid, consultez Présentation d’Event Grid.
• Pour en savoir plus sur les concepts d’Azure Notification Hub, consultez Documentation Azure Notification Hubs