Bot d’appel et de réunion Teams
Le bot d’appel et de réunion Microsoft Teams fournit des fonctionnalités de base telles que créer un appel, rejoindre un appel, transférer ou rediriger un appel, rejoindre une réunion planifiée et inviter les participants en intégrant les communications cloud API Graph.
Les bots peuvent interagir avec les appels et les réunions Teams à l’aide de la voix, de la vidéo et du partage d’écran en temps réel. Les applications Teams peuvent interagir avec les utilisateurs à l’aide de la voix et de la vidéo pour améliorer leur expérience avec les API Microsoft Graph pour les appels et les réunions en ligne. Ces API vous permettent d’ajouter les nouvelles fonctionnalités suivantes :
- Utilisez la réponse vocale interactive (IVR).
- Utilisez le contrôle d’appel.
- Fournir l’accès aux flux audio et vidéo en temps réel, y compris le partage de bureau et d’application.
Créez un bot et spécifiez des informations et des autorisations supplémentaires pour utiliser ces API Graph dans une application Teams.
Ce guide pas à pas vous aide à configurer le bot d’appel et de réunion Teams. Vous verrez la sortie suivante :
Configuration requise
Veillez à installer les outils suivants et à configurer votre environnement de développement :
| Installer | Pour l’utilisation... | |
|---|---|---|
| Compte de développeur Microsoft 365 | Accès au compte Teams avec les autorisations appropriées pour installer une application. | |
| Visual Studio 2022 | Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail de développement ASP.NET et web. Utilisez la dernière version. | |
| SDK .NET Core | Liaisons personnalisées pour le débogage local et les déploiements d’applications Azure Functions. Utilisez la dernière version ou installez la version portable. | |
| Microsoft Teams | Microsoft Teams vous permet de collaborer avec toutes les personnes avec lesquelles vous travaillez via des applications pour la conversation, les réunions et les appels au même endroit. | |
| Windows PowerShell | Installez en exécutant toutes les commandes. | |
| Tunnel de développement | Les fonctionnalités de l’application Teams (bots conversationnels, extensions de message et webhooks entrants) ont besoin de connexions entrantes. Un tunnel connecte votre système de développement à Teams. Le tunnel de développement est un outil puissant pour ouvrir en toute sécurité votre localhost sur Internet et contrôler qui a accès. Le tunnel de développement est disponible dans Visual Studio 2022 version 17.7.0 ou ultérieure. Vous pouvez également utiliser ngrok comme tunnel pour connecter votre système de développement à Teams. Elle n’est pas obligatoire pour les applications qui incluent uniquement des onglets. Ce package est installé dans le répertoire du projet (à l’aide de npm devDependencies). |
Remarque
Après avoir téléchargé ngrok, inscrivez-vous et installez authtoken.
Configurer l’environnement local
Ouvrez Microsoft-Teams-Samples.
Sélectionnez Code.
Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.
Sélectionnez Cloner.
Inscrire Microsoft Entra application
Pour inscrire une application à l’aide de l’Portail Azure Microsoft pour que votre application s’intègre au Plateforme d'identités Microsoft et appelez Microsoft API Graph, procédez comme suit :
- Créez un tunnel ngrok vers les points de terminaison de votre serveur web.
- Créez une ressource de bot Azure pour inscrire le bot auprès d’Azure Bot Service.
- Créez une clé secrète client qui active l’authentification unique (SSO) du bot.
- Créez une stratégie pour un utilisateur client de démonstration afin de créer des réunions en ligne à l’aide de PowerShell.
- Ajoutez des autorisations d’API pour les appels en aval.
- Créez une inscription de canal de bot dans un compte Azure.
- Ajoutez un canal Microsoft Teams pour déployer le bot sur un canal Teams.
- Ajoutez un point de terminaison de messagerie au tunnel ngrok que vous avez créé.
Ajouter une inscription d’application
Accédez au portail Azure.
Sélectionner les inscriptions d’applications.
Sélectionnez + Nouvelle inscription.
Entrez le nom de votre application.
Sélectionnez Comptes dans n’importe quel annuaire organisationnel (n’importe quel locataire Microsoft Entra ID - Multilocataire).
Sélectionner Inscription.
Votre application est inscrite dans Microsoft Entra ID. La page vue d’ensemble de l’application s’affiche.
Remarque
Enregistrez l’ID d’application à partir de l’ID d’application (client) et de l’ID d’annuaire (locataire) pour une utilisation ultérieure.
Créer un tunnel
Ouvrez Visual Studio.
Sélectionnez Créer un projet.
Dans la zone de recherche, entrez ASP.NET. Dans les résultats de la recherche, sélectionnez ASP.NET Core’application web.
Sélectionnez Suivant.
Entrez Nom du projet , puis sélectionnez Suivant.
Sélectionnez Créer.
Une fenêtre de vue d’ensemble s’affiche.
Dans la liste déroulante de débogage, sélectionnez Dev Tunnels (aucun tunnel actif)>Créer un tunnel....
Une fenêtre contextuelle apparaît.
Mettez à jour les détails suivants dans la fenêtre contextuelle :
- Compte : entrez un compte Microsoft ou GitHub.
- Nom : entrez un nom pour votre tunnel.
- Type de tunnel : dans la liste déroulante, sélectionnez Temporaire.
- Accès : dans la liste déroulante, sélectionnez Public.
Sélectionnez OK.
Une fenêtre contextuelle s’affiche pour indiquer que le tunnel de développement a été créé avec succès.
Sélectionnez OK.
Vous trouverez le tunnel que vous avez créé dans la liste déroulante de débogage comme suit :
Sélectionnez F5 pour exécuter l’application en mode débogage.
Si une boîte de dialogue Avertissement de sécurité s’affiche, sélectionnez Oui.
Une fenêtre contextuelle apparaît.
Cliquez sur Continuer.
La page d’accueil du tunnel de développement s’ouvre dans une nouvelle fenêtre de navigateur et le tunnel de développement est maintenant actif.
Accédez à Visual Studio, puis sélectionnez Afficher la > sortie.
Dans le menu déroulant Console de sortie, sélectionnez Tunnels de développement.
La console de sortie affiche l’URL du tunnel de développement.
Ajouter une authentification web
Dans le volet gauche, sous Gérer, sélectionnez Authentification.
Sélectionnez Ajouter une plateforme>web.
Entrez l’URI de redirection de votre application en ajoutant
auth-endau nom de domaine complet. Par exemple :https://your-devtunnel-domain/auth-endouhttps://your-ngrok-domain/auth-end.Sous Octroi implicite et flux hybrides, cochez les cases Jetons d’accès et jetons d’ID .
Sélectionnez Configurer.
Sous Web, sélectionnez Ajouter un URI.
Entrez
https://token.botframework.com/.auth/web/redirect.Sélectionnez Enregistrer.
Créer une clé secrète client
Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.
Sous Clés secrètes client, sélectionnez + Nouvelle clé secrète client.
La fenêtre Ajouter une clé secrète client s’affiche.
Entrez Description.
Sélectionnez Ajouter.
Sous Valeur, sélectionnez Copier dans le Presse-papiers pour enregistrer la valeur de clé secrète client en vue d’une utilisation ultérieure.
Ajouter des autorisations d’API pour les appels en aval
Dans le volet gauche, sous Gérer, sélectionnez Autorisations d’API.
Sélectionnez + Ajouter une autorisation.
Sélectionnez Microsoft Graph.
Sélectionnez Autorisations d’application.
Sélectionnez les autorisations suivantes :
Calls.AccessMedia.AllCalls.Initiate.AllCalls.InitiateGroupCall.AllCalls.JoinGroupCall.AllCalls.JoinGroupCallAsGuest.AllOnlineMeetings.ReadWrite.All
Sélectionnez Ajouter des autorisations.
Remarque
- Si une application ne reçoit pas le consentement de l’administrateur informatique, les utilisateurs doivent fournir le consentement la première fois qu’ils utilisent une application.
- Les utilisateurs doivent donner leur consentement aux autorisations d’API uniquement si l’application Microsoft Entra est inscrite dans un autre locataire.
Ajouter une étendue
Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.
Sélectionnez + Ajouter une étendue.
Entrez access_as_user comme nom de l’étendue.
Sous Qui peut donner son consentement ?, sélectionnez Administrateurs et utilisateurs.
Mettez à jour les valeurs du reste des champs comme suit :
Entrez Teams peut accéder au profil de l’utilisateur en tant que nom d’affichage de consentement Administration.
Entrez Permet à Teams d’appeler les API web de l’application en tant qu’utilisateur actuelAdministration description du consentement.
Entrez Teams peut accéder au profil utilisateur et effectuer des demandes au nom de l’utilisateur en tant que nom d’affichage du consentement de l’utilisateur.
Entrez Autoriser Teams à appeler les API de cette application avec les mêmes droits que l’utilisateur comme description du consentement de l’utilisateur.
Vérifiez que State est défini comme Enabled.
Sélectionnez Ajouter une étendue.
L’image suivante montre les champs et les valeurs :
Remarque
Le nom de l’étendue doit correspondre à l’URI d’ID d’application avec
/access_as_userajouté à la fin.
Ajouter une application cliente
Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.
Sous Applications clientes autorisées, identifiez les applications que vous souhaitez autoriser pour l’application web de votre application.
Sélectionnez + Ajouter une application cliente.
Ajoutez Teams mobile ou de bureau et l’application web Teams.
Pour Teams mobile ou de bureau : entrez l’ID client sous la forme
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
Pour le web Teams : entrez l’ID client en tant que
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Cochez la case Étendues autorisées .
Sélectionnez Ajouter une application.
L’image suivante affiche l’ID client :
Créer une stratégie
Pour créer une stratégie qui permet à un utilisateur client de démonstration de créer des réunions en ligne à l’aide d’un script PowerShell, procédez comme suit :
Exécutez Windows PowerShell PSI en tant qu’administrateur et exécutez le script.
New-CsApplicationAccessPolicy -Identity "<<policy-identity/policy-name>>" -AppIds "<<azure-client-id>>" -Description "Policy-description" Grant-CsApplicationAccessPolicy -PolicyName "<<policy-identity/policy-name>>" -Identity "<<object-id-of-the-user-to-whom-policy-need-to-be-granted>>"Remarque
Si vous utilisez l’Windows PowerShell PSI pour la première fois, exécutez les commandes suivantes :
- Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
- Exécuter Install-Module -Name MicrosoftTeams -Force -AllowClobber
Remplacez les champs suivants dans Windows PowerShell script :
Field Description policy-identity/policy-name Nom de la stratégie. azure-client-id ID d’application Microsoft, que vous avez généré lors de l’inscription de l’application dans Portail Azure. Description de la stratégie Description de la stratégie. object-id-of-the-user-to-whom-policy-need-to-be-granted ID de l’utilisateur pour lequel vous devez générer la stratégie à l’aide de l’Explorateur de graphiques. Pour générer l’ID d’objet, connectez-vous à Microsoft Graph Explorer à l’aide des informations d’identification auxquelles la stratégie doit être accordée.
Sélectionnez Graph Explorer dans la barre d’outils.
Sélectionnez Exécuter la requête. Une réponse est générée sous Aperçu de la réponse.
Copiez la valeur de la
idpropriété à partir de l’aperçu de la réponse et remplacez par l’ID d’objet dans le script PowerShell.
Exécutez le script PowerShell.
Exécutez
Connect-MicrosoftTeamset connectez-vous avec les informations d’identification auxquelles la stratégie doit être accordée.
Exécutez la commande suivante dans PowerShell pour vérifier si la stratégie a été créée correctement ou non. Remplacez le nom de la stratégie par le nom de votre stratégie définie.
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
Remarque
Vérifiez que les scripts en cours d’exécution ne sont pas désactivés dans votre système. Pour plus d’informations, consultez Stratégies d’exécution.
Créer votre bot
Créer une ressource de bot Azure
Remarque
Si vous testez déjà votre bot dans Teams, déconnectez-vous de cette application et de Teams. Pour voir cette modification, reconnectez-vous.
Accéder à l’Accueil
Sélectionnez + Créer une ressource.
Dans la zone de recherche, entrez Azure Bot.
Ensuite, sélectionnez Entrée.
Sélectionnez Azure Bot.
Sélectionnez Créer.
Entrez le nom du bot dans Descripteur de bot.
Sélectionnez votre abonnement dans la liste déroulante.
Sélectionnez votre groupe de ressources dans la liste déroulante.
Si vous n’avez pas de groupe de ressources existant, vous pouvez en créer un. Pour créer un groupe de ressources, procédez comme suit :
- Sélectionnez Créer.
- Entrez le nom de la ressource et sélectionnez OK.
- Sélectionnez un emplacement dans la liste déroulante Nouvel emplacement du groupe de ressources .
Sous Tarification, sélectionnez Modifier le plan.
Sélectionnez FO Free>Select.
Sous ID d’application Microsoft, sélectionnez Type d’applicationcomme multilocataire.
Dans Type de création, sélectionnez Utiliser l’inscription d’application existante.
Entrez l’ID d’application.
Remarque
Vous ne pouvez pas créer plusieurs bots avec le même ID d’application Microsoft.
Sélectionnez Examiner et créer.
Une fois la validation réussie, sélectionnez Créer.
L’approvisionnement du bot prend quelques minutes.
Sélectionnez Accéder à la ressource.
Vous avez créé votre bot Azure.
Ajouter un canal Teams
Dans le volet gauche, sélectionnez Canaux.
Sous Canaux disponibles, sélectionnez Microsoft Teams.
Cochez la case pour accepter les conditions d’utilisation du service.
Sélectionnez Accepter.
Sélectionnez Appliquer.
Pour ajouter un point de terminaison de messagerie
Utilisez l’URL du tunnel de développement dans la console de sortie comme point de terminaison de messagerie.
Dans le volet gauche, sous Paramètres, sélectionnez Configuration.
Mettez à jour le point de terminaison de messagerie au format
https://your-devtunnel-domain/api/messages.
Sélectionnez Appliquer.
Vous avez correctement configuré un bot dans Azure Bot Service.
Remarque
Si la clé d’instrumentation Application Insights affiche une erreur, mettez à jour avec l’ID d’application.
Configurer les paramètres d’application et les fichiers manifestes
Obtenez le
tenantIdouUserIdà partir de Teams. Pour obtenir letenantId, procédez comme suit :Sélectionnez Teams.
Sélectionnez Plus d’options (...).
Sélectionnez Obtenir le lien vers l’équipe.
Vous pouvez obtenir le
displayNameetidà partir du site :Connectez-vous à Microsoft Graph Explorer à l’aide de votre compte de locataire Teams.
Ajoutez
Usersà la fin de l’URL dans la zone de recherche.Sélectionnez Exécuter la requête.
Les noms d’affichage et les ID d’utilisateur liés à votre compte sont générés.
Sélectionnez trois comptes et ajoutez-les
DisplayNameau etUserIddans le fichier appsettings.json.
Remarque
TenantIdouUserIddu compte Teams indique à partir duquel vous souhaitez lancer l’appel, etDisplayNameUserIddes utilisateurs indiquent vers qui vous souhaitez rediriger ou transférer l’appel.
Mettre à jour les paramètres de l’application
Accédez au fichier appsettings.json dans le dépôt cloné.
Ouvrez le fichier appsettings.json dans Visual Studio et mettez à jour les informations suivantes :
- Remplacez
MicrosoftAppId,ClientIdetAppIdpar l’ID d’application Microsoft de votre bot. - Remplacez
MicrosoftAppPassword,ClientSecretet parAppSecretValeur de la clé secrète client de votre bot. - Remplacez par
BotBaseUrlle nom de domaine ngrok ou dev tunnel. - Remplacez par
TenantId.UserId - Remplacez par
DisplayName.Id
- Remplacez
Sélectionnez Enregistrer.
Mettre à jour le manifeste de l’application
Accédez au fichier manifest.json dans le dépôt cloné.
Ouvrez le fichier manifest.json dans Visual Studio et apportez les modifications suivantes :
- Remplacez
{id}`` and{BotId} par votre ID d’application Microsoft. - Remplacez toutes les occurrences de par votre nom de
{{domain-name}}domaine ngrok ou de tunnel de développement.
- Remplacez
Générer et exécuter le service
Pour générer et exécuter le service, utilisez Visual Studio :
Ouvrez Visual Studio.
Accédez à Fichier>Ouvrir>le projet/la solution...
Sélectionnez le fichier CallingBotSample.sln dans le dossiersourcecsharp>.
Appuyez sur F5 pour exécuter le projet.
Une page web s’ouvre avec un message Votre bot est prêt !.
Ajouter un bot d’appel et de réunion à Teams
Dans votre dépôt cloné, accédez à csharp > Source > AppManifest.
Créez un fichier .zip avec les fichiers suivants présents dans le dossier AppManifest :
- manifest.json
- outline.png
- color.png
Remarque
le
manifest.zipne doit pas contenir de dossiers supplémentaires. Le fichier source,colorl’icône etoutlinel’icône doivent figurermanifest jsondans le dossier zip.Dans le client Teams, sélectionnez l’icône Applications .
Sélectionnez Gérer vos applications.
Sélectionnez Charger une application.
Dans la fenêtre contextuelle, sélectionnez Charger une application personnalisée. Si vous voyez l’option , le chargement d’applications personnalisées est activé.
Accédez à csharp > Source > AppManifest.
Sélectionnez Ouvrir pour charger le fichier .zip que vous avez créé dans le dossier AppManifest .
Sélectionnez Ajouter pour installer l’application de bot d’appel dans Teams.
Interagir avec le bot d’appel et de réunion
Bot vous permet d’accéder aux services et au contenu dans un espace dédié au sein d’un canal ou dans une conversation.
Interagissons avec l’application dans Teams !
Dans le volet gauche de Teams, sélectionnez Afficher plus d’applications (...) et sélectionnez votre application dans la liste.
Le bot envoie un texte de bienvenue avec la carte adaptative.
Sélectionnez Créer un appel.
Sélectionnez Transférer l’appel.
Vous pouvez demander au bot de planifier une réunion et d’inviter les participants.
Relever le défi
Avez-vous trouvé une sortie comme celle-ci ?
Félicitations !
Vous avez terminé le tutoriel pour commencer à utiliser l’application d’appel de bot et de réunion pour Microsoft Teams.
Vous avez un défi avec cette section ? Si c'est le cas, faites-nous part de vos commentaires pour que nous puissions l'améliorer.