Configurer les appels entrants, l’enregistrement d’appel et les services SMS
Azure Communication Services s’intègre à Azure Event Grid pour envoyer des notifications en temps réel pour les événements de conversation, de téléphonie, de SMS, de vidéo et d’appel vocal. Azure Event Grid, à son tour, utilise les abonnements aux événements pour acheminer les messages d’événement vers les abonnés.
Pour activer les services d’enregistrement des appels et de SMS, vous devez d’abord configurer vos applications pour écouter les événements Azure Communication Services en vous abonnant aux Rubriques système Event Grid. Ensuite, abonnez-vous aux événements d’appel entrant, d’enregistrement d’appel ou SMS spécifiques en créant des abonnements Event Grid sur le portail Azure.
Important
- Vous devez être propriétaire de l’Enregistrement de l’application pour créer des abonnements Event Grid.
- Vous ne pouvez définir qu’un seul point de terminaison de webhook à la fois en suivant la procédure suivante. Pour activer les appels entrants, les SMS et les services d’enregistrement des appels, vous devez répéter la procédure pour définir le point de terminaison du webhook pour chacun de ces services.
- Vous devez créer un abonnement à un événement pour chaque type d’événement. Ne mettez pas à jour un abonnement à un événement existant en modifiant le type d’événement.
- Lorsque vous connectez votre abonnement aux événements, vous devez utiliser le même ID d’application et le même ID de répertoire pour l’inscription de l’application que lors de votre première connexion à votre ressource Azure. Pour obtenir l’application Event Grid et les ID de client, accédez à Obtenir les ID d’application et de locataire à partir du portail Power Apps.
Créer une rubrique système Event Grid
Ouvrez le service Rubriques système Event Grid sur le portail Azure.
Créez une rubrique système Event Grid, puis dans l’onglet Notions de base, ajoutez les informations suivantes :
Type de rubrique : Azure Communication Services
Abonnement : sélectionnez votre abonnement.
Groupe de ressources : sélectionnez le groupe de ressources où votre ressource Azure Communication Services se situe.
Ressource : sélectionnez la ressource Azure Communication Services à laquelle vous souhaitez vous connecter à Dynamics 365 Customer Service.
Précisez le Nom dans la section Détails de la rubrique système.
En savoir plus dans la rubrique Créer et déployer une rubrique système Event Grid.
Sur la page Rubrique système Event grid, sélectionnez le lien Abonnement.
Dans la page d’abonnement à la ressource, sélectionnez Paramètres>Fournisseurs de ressources, puis vérifiez si le fournisseur Microsoft.EventGrid est répertorié comme Inscrit. Si Event Grid n’est pas inscrit, sélectionnez alors l’enregistrement, puis sélectionnez Réinscrire pour le réinscrire.
Configurer le webhook des appels entrants
Ouvrez la ressource sur le portail Azure. Sélectionnez Événements, puis Abonnement à l’événement.
Entrez les informations suivantes sous l’onglet Notions de base :
Nom : Entrez un nom pour l’abonnement à l’événement d’enregistrement.
Schéma d’événement : sélectionnez Schéma Event Grid dans la liste.
Types de sujet : sélectionnez Azure Communication Services dans la liste.
Abonnement : sélectionnez votre abonnement dans la liste.
Groupe de ressources : sélectionnez le groupe de ressources.
Ressource : sélectionnez la ressource.
Nom du sujet système : ce champ est automatiquement renseigné avec le nom du sujet système que vous avez créé. Cependant, si vous voyez plusieurs valeurs, sélectionnez le nom du sujet système spécifique dans la liste.
Filtrer par types d’événement : vous pouvez filtrer les événements pour l’enregistrement des appels, les appels entrants ou les services SMS.
- Pour filtrer les types d’événements pour les services appelants, sélectionnez Appel entrant dans la liste.
Type de point de terminaison : sélectionnez Webhook dans la liste.
Point de terminaison : sélectionnez Sélectionner un point de terminaison, puis entrez le point de terminaison de webhook de l’appel entrant à partir du centre d’administration Customer Service ou Contact Center. Accédez à Canaux>Numéros de téléphone>Avancé>Gérer Azure Communication Services pour obtenir les points de terminaison de webhook suivants :
Appel entrant du point de terminaison de webhook (version préliminaire) pour activer les appels entrants.
Sélectionnez l’onglet Fonctions supplémentaires. Sélectionnez la case à cocher Utiliser l’authentification Microsoft Entra, puis saisissez les informations suivantes. Pour en savoir plus sur ces valeurs, consultez la section Obtenir des ID d’application et de locataire à partir du portail Power Apps de cet article.
- ID de locataire Microsoft Entra : entrez l’ID de locataire (répertoire) de votre ressource Azure.
- ID ou URI de l’application Microsoft Entra : saisissez l’ID d’application (client) de votre ressource Azure.
Important
Assurez-vous de saisir le bon ensemble de valeurs d’ID de locataire Microsoft Entra et ID ou URI d’application Microsoft Entra qui correspondent aux valeurs définies dans votre organisation. La synchronisation peut prendre jusqu’à 15 minutes. Si vous obtenez une erreur telle que « Échec de la poignée de main de validation du webhook », vérifiez les informations d’identification, puis réessayez l’étape après quelques minutes.
Sélectionnez Créer pour créer le point de terminaison de l’abonnement à l’événement pour l’enregistrement.
Configurer le webhook de l’enregistrement des appels
Suivez les étapes de la section Configurer le webhook Appels entrants, mais dans le filtre par type d’événement, sélectionnez Sélectionner le statut du fichier d’enregistrement mis à jour dans la liste.
Pour Type de point de terminaison, sélectionnez Webhook dans la liste.
Pour Point de terminaison, sélectionnez Sélectionner un point de terminaison, puis entrez le point de terminaison de webhook de l’enregistrement à partir du centre d’administration Customer Service ou Contact Center. Accédez à Canaux>Numéros de téléphone>Avancé>Gérer Azure Communication Services>Point de terminaison du webhook d’enregistrement.
Sélectionnez l’onglet Fonctions supplémentaires. Sélectionnez la case à cocher Utiliser l’authentification Microsoft Entra, puis saisissez les informations suivantes. Pour plus d’informations sur ces valeurs, accédez à la section Obtenir les ID de l’application Event Grid et du locataire dans le portail Power Apps.
- ID de locataire Microsoft Entra : entrez l’ID de locataire (répertoire) de votre ressource Azure.
- ID ou URL de l’application Microsoft Entra : saisissez l’ID d’application (client) de votre ressource Azure.
Sélectionnez Créer pour créer le point de terminaison de l’abonnement à l’événement pour l’enregistrement.
La synchronisation peut prendre jusqu’à 15 minutes. Si vous obtenez une erreur du type « Webhook validation handshake failed », réessayez cette étape après quelques minutes.
Pour en savoir plus sur la configuration des enregistrements d’appels, consultez Configurer l’enregistrement des appels, la transcription et la traduction en temps réel. Pour créer des rôles d’utilisateur personnalisés pour fournir un accès aux enregistrements d’appels, reportez-vous à Gérer les personnes et les rôles de sécurité personnalisés dans Customer Service.
Configurer le webhook SMS
Suivez les étapes de la section Configurer le webhook Appels entrants, mais dans le filtre par type d’événement, sélectionnez SMS reçus et rapport de remise des SMS reçus dans la liste.
Pour Type de point de terminaison, sélectionnez Webhook dans la liste.
Pour Point de terminaison, sélectionnez Sélectionner un point de terminaison, puis entrez le point de terminaison de webhook de l’enregistrement à partir du centre d’administration Customer Service ou Contact Center. Accédez à Canaux>Numéros de téléphone>Avancé>Gérer Azure Communication Services>Point de terminaison du webhook SMS.
Sélectionnez l’onglet Fonctions supplémentaires. Sélectionnez la case à cocher Utiliser l’authentification Microsoft Entra, puis saisissez les informations suivantes. Pour plus d’informations sur ces valeurs, accédez à la section Obtenir les ID de l’application Event Grid et du locataire dans le portail Power Apps.
- ID de locataire Microsoft Entra : entrez l’ID de locataire (répertoire) de votre ressource Azure.
- ID ou URL de l’application Microsoft Entra : saisissez l’ID d’application (client) de votre ressource Azure.
Sélectionnez Créer pour créer le point de terminaison de l’abonnement à l’événement pour l’enregistrement.
La synchronisation peut prendre jusqu’à 15 minutes. Si vous obtenez une erreur du type « Webhook validation handshake failed », réessayez cette étape après quelques minutes.
Reconnecter la ressource Azure de la pile vocale existante à la pile vocale améliorée
Si vous migrez de la pile vocale existante vers la pile vocale améliorée, utilisez la vidéo suivante pour vous assurer que votre grille d’événements est correctement configurée pour les appels entrants et l’enregistrement.
Obtenir les ID d’application et de locataire Event Grid à partir du portail Power Apps
Note
Utilisez cette méthode uniquement lorsque vous rencontrez des problèmes pour obtenir les ID du portail Power Apps. Pour obtenir les ID à partir du portail Azure, recherchez « inscriptions d’applications » et recherchez l’inscription de votre ressource Azure Communication Services connectée. Copiez l’ID d’application (client) pour remplir la zone ID d’application Event Grid et l’ID d’annuaire (locataire) pour remplir la zone ID de locataire Event Grid.
Ouvrez le portail Power Apps et sélectionnez votre environnement.
Sur le plan de site, sélectionnez Dataverse>Tables>Tout.
Recherchez la table Entrée de paramètre de fournisseur de communications et ouvrez-la.
Dans la section Colonnes et données d’entrée des paramètres du fournisseur de communication, affichez les champs EventGridAppID et EventGripAppTenantID dans la colonne Clé et notez les valeurs d’ID correspondantes dans la colonne Valeurs.