Créer un bot de conversation Teams

Le bot de conversation Microsoft Teams permet aux utilisateurs d’interagir avec votre service web via du texte, des cartes interactives et des dialogues (appelés modules de tâche dans TeamsJS v1.x). Les conversations de base sont gérées via le connecteur Bot Framework, une seule API REST. Cette API permet à votre bot de communiquer avec Teams et d’autres canaux.

Principales fonctionnalités du Kit de développement logiciel (SDK) Bot Builder

• Fournit l’accès au connecteur Bot Framework.
• Gère le flux de conversation et l’état.
• Incorpore les services cognitifs, tels que le traitement du langage naturel (NLP).

Lorsque votre bot est ajouté à un groupe ou à une équipe, un message de présentation est envoyé. Le message fournit une brève description des fonctionnalités du bot et de leur utilisation.

Ce guide pas à pas vous aide à créer un bot de conversation dans l’application Teams. Vous pouvez voir la sortie suivante :

Configuration requise

• 16 minutes restantes

Veillez à installer les outils suivants et à configurer votre environnement de développement :

Configurer l’environnement local

• 15 minutes restantes

1. Ouvrez Microsoft-Teams-Samples.

2. Sélectionnez Code.

3. Dans le menu déroulant, sélectionnez Ouvrir avec GitHub Desktop.

   

4. Sélectionnez Cloner.

Inscrire Microsoft Entra application

• 14 minutes restantes

Inscrivez votre bot auprès d’Azure Bot Service lorsque vous le développez et l’hébergez dans Azure. Voici les étapes :

• Inscrivez votre bot auprès d’Azure Bot Service.

• Créez une clé secrète client qui active l’authentification unique (SSO) du bot.

• Ajoutez un canal Teams pour déployer le bot.

• Créez un tunnel vers les points de terminaison de votre serveur web à l’aide du tunnel de développement (recommandé) ou de ngrok.

• Ajoutez un point de terminaison de messagerie au tunnel de développement que vous avez créé.

  Ajouter une inscription d’application

  1. Accédez au portail Azure.

  2. Sélectionner les inscriptions d’applications.

     

  3. Sélectionnez + Nouvelle inscription.

     

  4. Entrez le nom de votre application.

  5. Sélectionnez Comptes dans n’importe quel annuaire organisationnel (n’importe quel locataire Microsoft Entra ID - Multilocataire).

  6. 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

  • tunnel de développement
  • ngrok

  1. Ouvrez Visual Studio.

  2. Sélectionnez Ouvrir un projet ou une solution.

     

  3. Accédez à Microsoft-Teams-Samples > samples > bot-conversation > csharp.

  4. Sélectionnez TeamsConversationBot.sln fichier.

  5. Une fenêtre de vue d’ensemble s’affiche.

     

  6. 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.

  7. Mettez à jour les détails suivants dans la fenêtre contextuelle :

     1. Compte : entrez un compte Microsoft ou GitHub.
     2. Nom : entrez un nom pour votre tunnel.
     3. Type de tunnel : dans la liste déroulante, sélectionnez Temporaire.
     4. Accès : dans la liste déroulante, sélectionnez Public.

  8. Sélectionnez OK.

     

     Une fenêtre contextuelle s’affiche pour indiquer que le tunnel de développement a été créé avec succès.

  9. Sélectionnez OK.

     

     Vous trouverez le tunnel que vous avez créé dans la liste déroulante de débogage comme suit :

     

  10. Sélectionnez F5 pour exécuter l’application en mode débogage.

  11. Si une boîte de dialogue Avertissement de sécurité s’affiche, sélectionnez Oui.

      

      Une fenêtre contextuelle apparaît.

  12. 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.

      

  13. Accédez à Visual Studio, puis sélectionnez Afficher la > sortie.

  14. 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

1. Dans le volet gauche, sous Gérer, sélectionnez Authentification.

2. Sélectionnez Ajouter une plateforme>web.

   

3. Entrez l’URI de redirection de votre application en ajoutant auth-end au nom de domaine complet. Par exemple : https://your-devtunnel-domain/auth-end ou https://your-ngrok-domain/auth-end.

4. Sous Octroi implicite et flux hybrides, cochez les cases Jetons d’accès et jetons d’ID .

5. Sélectionnez Configurer.

   

6. Sous Web, sélectionnez Ajouter un URI.

7. Entrez https://token.botframework.com/.auth/web/redirect.

8. Sélectionnez Enregistrer.

   

Créer une clé secrète client

1. Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.

2. Sous Clés secrètes client, sélectionnez + Nouvelle clé secrète client.

   

   La fenêtre Ajouter une clé secrète client s’affiche.

3. Entrez Description.

4. Sélectionnez Ajouter.

   

5. 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

1. Dans le volet gauche, sélectionnez Autorisations d’API.

2. Sélectionnez + Ajouter une autorisation.

   

3. Sélectionnez Microsoft Graph.

4. Sélectionnez Autorisations d’application.

5. SélectionnezUser.Read.All>.

6. Sélectionnez Ajouter des autorisations.

   

Ajouter un URI d’ID d’application

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. En regard de URI d’ID d’application, sélectionnez Ajouter.

   

3. Mettez à jour l’URI de l’ID d’applicationapi://your-devtunnel-domain/botid-{AppID} au format ou et api://your-ngrok-domain/botid-{AppID} sélectionnez Enregistrer.

   

   L’image suivante montre le nom de domaine :

   

Ajouter une étendue

1. Dans le volet gauche, sous Gérer, sélectionnez Exposer une API.

2. Sélectionnez + Ajouter une étendue.

   

3. Entrez access_as_user comme nom de l’étendue.

4. Sous Qui peut donner son consentement ?, sélectionnez Administrateurs et utilisateurs.

5. 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.

6. Vérifiez que State est défini comme Enabled.

7. 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_user ajouté à la fin.

   

Ajouter une application cliente

1. 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.

2. Sélectionnez + Ajouter une application cliente.

   

3. Ajoutez Teams mobile ou de bureau et l’application web Teams.

   1. Pour Teams mobile ou de bureau : entrez l’ID client sous la forme 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. Pour le web Teams : entrez l’ID client en tant que 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Cochez la case Étendues autorisées .

5. Sélectionnez Ajouter une application.

   

   L’image suivante affiche l’ID client :

   

Créer votre bot

• 9 minutes restantes

Créer une ressource de bot Azure

1. Accéder à l’Accueil

2. Sélectionnez + Créer une ressource.

3. Dans la zone de recherche, entrez Azure Bot.

4. Ensuite, sélectionnez Entrée.

5. Sélectionnez Azure Bot.

6. Sélectionnez Créer.

   

7. Entrez le nom du bot dans Descripteur de bot.

8. Sélectionnez votre abonnement dans la liste déroulante.

9. 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 :

   1. Sélectionnez Créer.
   2. Entrez le nom de la ressource et sélectionnez OK.
   3. Sélectionnez un emplacement dans la liste déroulante Nouvel emplacement du groupe de ressources .

   

10. Sous Tarification, sélectionnez Modifier le plan.

    

11. Sélectionnez FO Free>Select.

    

12. Sous ID d’application Microsoft, sélectionnez Type d’applicationcomme multilocataire.

13. Dans Type de création, sélectionnez Utiliser l’inscription d’application existante.

14. Entrez l’ID d’application.

    Remarque

    Vous ne pouvez pas créer plusieurs bots avec le même ID d’application Microsoft.

15. Sélectionnez Examiner et créer.

    

16. Une fois la validation réussie, sélectionnez Créer.

    L’approvisionnement du bot prend quelques minutes.

17. Sélectionnez Accéder à la ressource.

    

    Vous avez créé votre bot Azure.

    

Ajouter un canal Teams

1. Dans le volet gauche, sélectionnez Canaux.

2. Sous Canaux disponibles, sélectionnez Microsoft Teams.

   

3. Cochez la case pour accepter les conditions d’utilisation du service.

4. Sélectionnez Accepter.

   

5. Sélectionnez Appliquer.

   

Pour ajouter un point de terminaison de messagerie

Configurer la connexion au service de bot

• 4 minutes restantes

Configurez le bot pour comprendre comment authentifier le bot de conversation dans Teams, créer le package d’application Teams et le charger dans le organization.

1. Mettez à jour le fichier appsettings.json dans Visual Studio.
2. Mettez à jour le fichier manifest.json dans Visual Studio et compressez-le dans le fichier zip dans le Explorateur de fichiers.
3. Exécutez votre solution dans Visual Studio.
4. Chargez le bot dans Teams.

Pour mettre à jour les paramètres d’application

1. Dans le Explorateur de fichiers, accédez à Microsoft-Teams-Samples>samples>bot-conversation>csharp.

2. Ouvrez le fichier appsettings.json dans Visual Studio et mettez à jour la configuration du bot.

   • Définissez "MicrosoftAppType"sur Multilocataire.
   • Définissez sur "MicrosoftAppId"l’ID d’application Microsoft de votre bot.
   • Définissez sur "MicrosoftAppPassword"la valeur des secrets clients de votre bot.
   • Définissez votre "MicrosoftAppTenantId" sur votre ID de locataire.

   

3. Sélectionnez Enregistrer.

Pour mettre à jour le manifeste

1. Dans le Explorateur de fichiers, accédez à Microsoft-Teams-Samples>samples>bot-conversation>csharp>TeamsApplication>d’applicationPackage.

   

2. Ouvrez le fichier manifest.json dans Visual Studio et apportez les modifications suivantes :

   • Remplacez et "botId" par "id"l’ID d’application Microsoft de votre bot.
   • Remplacez par "validDomains" votre domaine ngrok à l’exception https://de .

   

3. Compressez le contenu du dossier appPackage pour créer manifest.zip.

   Remarque

   Le manifest.zip ne doit pas contenir d’autres dossiers. Le fichier source, color l’icône et outline l’icône doivent figurer manifest json dans le dossier zip. Exécutez votre solution dans Visual Studio et chargez votre manifeste dans votre locataire de démonstration pour organization ou votre compte Teams.

Pour exécuter la solution dans Visual Studio

1. Ouvrez Visual Studio.

2. Sélectionnez Fichier>Ouvrir le>projet/la solution.....

   

3. Accédez à Microsoft-Teams-Samples>samples>bot-conversation>csharp.

4. Sélectionnez TeamsConversationBot.c#proj file.

   

5. Sélectionnez F5 pour exécuter le projet.

6. Sélectionnez Oui pour installer le certificat.

   

   Une page web s’affiche avec un message Votre bot est prêt !

   

Pour charger l’application dans Teams

1. Dans le client Teams, sélectionnez l’icône Applications .

2. Sélectionnez Gérer vos applications.

3. Sélectionnez Charger une application.

4. Recherchez l’option Charger une application personnalisée. Si l’option est visible, le chargement de l’application personnalisée est activé.

   

   Remarque

   Si vous ne trouvez pas l’option de charger une application personnalisée, contactez votre administrateur Teams.

5. Sélectionnez Ouvrir pour charger le fichier .zip que vous avez créé dans le dossier appPackage .

   

6. Sélectionnez Ajouter.

   

   Vous pouvez interagir avec le bot.

Interagir avec le bot de conversation

• 3 minutes restantes

Vous pouvez interagir avec le bot dans Teams en lui envoyant un message ou en sélectionnant une commande dans la liste des commandes. Le bot répond aux chaînes.

Dans le volet gauche de Teams, sélectionnez Autres applications ajoutées (●●●), puis sélectionnez votre application dans la liste. Le bot affiche les suggestions comme suit :

• MentionMe
• Afficher la bienvenue
• MessageAllMembers
• MessageAllMembersUsingAadId

MentionMe	Afficher la bienvenue	MessageAllMembers
Résultat: Le bot répond au message et mention l’utilisateur.	Résultat: Le bot envoie le carte de bienvenue avec lequel vous pouvez interagir.	Résultat: Le bot envoie un message un-à-un à chaque membre de la conversation actuelle.
Étendues valides : personnel, conversation de groupe, conversation d’équipe.	Étendues valides : personnel, conversation de groupe, conversation d’équipe.	Étendues valides : personnel, conversation de groupe, conversation d’équipe.

Vous pouvez sélectionner une option dans la liste de commandes en tapant @TeamsConversationBot ou Que puis-je faire ? du texte dans la zone de composition et en l’envoyant.

Relever le défi

• 1 minutes restantes

Tu as trouvé quelque chose comme ça ?

Félicitations !

• Tout est terminé !

Vous avez terminé le tutoriel pour bien démarrer avec le bot de conversation pour Microsoft Teams.