Charger un fichier dans Teams à l’aide d’un bot

Le bot utilise l’API Microsoft Teams pour envoyer et recevoir des fichiers avec des utilisateurs dans des conversations personnelles. Les fichiers partagés dans Teams peuvent apparaître sous forme de cartes et permettre un affichage enrichi dans l’application. Le bot aide également à implémenter des fonctionnalités, telles que les notes de frais, la reconnaissance d’images, l’archivage de fichiers et les signatures électroniques qui impliquent la modification du contenu du fichier.

Fonctionnalités clés pour charger un fichier dans Teams à l’aide du bot :

• Chargez des fichiers dans Teams à l’aide d’un bot.
• Recevoir un fichier envoyé au bot en tant que pièce jointe.
• Récupérer les images inline envoyées dans le message.

Ce guide pas à pas vous aide à charger un fichier dans Teams à l’aide d’un bot. Vous verrez la sortie suivante :

Configuration requise

• 21 minutes restantes

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

Configurer l’environnement local

• 20 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 l’application Microsoft Entra

• 19 minutes restantes

Les étapes suivantes vous aident à créer et à inscrire votre bot dans le portail Azure :

• Créez et inscrivez votre application Azure.
• Créez une clé secrète client pour activer l’authentification unique 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 d’ID Microsoft Entra - Multilocataire).

6. Sélectionner Inscription.

   

   Votre application est inscrite dans l’ID Microsoft Entra. 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

ngrok http --host-header=localhost 3978

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éléguées.

5. Sélectionnez User>User.Read.

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 du consentement administrateur.

   • Entrez Autoriser Teams à appeler les API web de l’application en tant qu’utilisateur actuel comme description du consentement administrateur.

   • 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 :

   

Mise à jour du manifeste

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

2. Définissez la valeur de sur accessTokenAcceptedVersion2 et sélectionnez Enregistrer.

   

Créer votre bot

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

Ajouter des paramètres de connexion OAuth

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

2. Sélectionnez le bouton Ajouter des paramètres de connexion OAuth.

3. Sous Nouveau paramètre de connexion, mettez à jour les informations suivantes :

   • Nom : entrez un nom pour votre nouveau paramètre de connexion. Vous pouvez utiliser le nom dans les paramètres de votre code de service de bot.
   • Fournisseur de services : dans la liste déroulante, sélectionnez Azure Active Directory v2.
   • ID client : Mettez à jour votre ID d’application Microsoft.
   • Clé secrète client : Mettez à jour la valeur des secrets client.
   • URL d’échange de jetons : mettez à jour l’URI de l’ID d’application.
   • ID de locataire : entrez Commun.
   • Étendues : entrez User.Read.

4. Sélectionnez Enregistrer.

   

Configurer les paramètres d’application et les fichiers manifestes

• 9 minutes restantes

1. Accédez au fichier appsettings.json dans le dépôt cloné.

   

2. Ouvrez le fichier appsettings.json et mettez à jour les informations suivantes :

   • Définissez "MicrosoftAppType"sur Multi-locataire.

   • Définissez sur "MicrosoftAppId"l’ID d’application Microsoft de votre bot.

   • Définissez sur "MicrosoftAppPassword"la valeur des secrets clients de votre bot.

     

3. Accédez au fichier manifest.json dans le dépôt cloné.

   

4. Ouvrez le fichier manifest.json et mettez à jour les modifications suivantes :

   Remplacez toutes les occurrences de par votre ID d’application<<YOUR-MICROSOFT-APP-ID>> Microsoft.

   

Générer et exécuter le service

• 7 minutes restantes

Pour générer et exécuter le service à l’aide de Visual Studio ou de la ligne de commande.

dotnet run

Charger le bot dans Teams

• 5 minutes restantes

1. Dans votre dépôt cloné, accédez à Microsoft-Teams-Samples>samples>bot-file-upload>csharp>TeamsAppManifest.

2. Créez un fichier .zip avec les fichiers suivants présents dans le dossier TeamsAppManifest :

   • manifest.json
   • icon-outline.png
   • icon-color.png

   

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

4. Sélectionnez Gérer vos applications.

5. Sélectionnez Charger une application.

6. Recherchez l’option Charger une application personnalisée. Si vous voyez l’option , le chargement d’applications personnalisées est activé.

   

7. Sélectionnez le fichier .zip que vous avez créé dans le dossier TeamsAppManifest , puis sélectionnez Ouvrir.

   

8. Sélectionnez Ajouter.

   

Interaction avec le bot dans Teams

• 3 minutes restantes

1. Dans la zone de composition du message, entrez hi , puis sélectionnez Envoyer. Le bot envoie une carte adaptative avec l’autorisation de charger le fichier.

   

2. Sélectionnez Autoriser. Le fichier teams-logo.png est chargé dans le répertoire de fichiers et prêt à être téléchargé.

   

3. Joignez n’importe quel fichier à votre message, puis sélectionnez Envoyer. Le bot répond par un message indiquant que le fichier est reçu et enregistré.

   

   Vous pouvez afficher la pièce jointe à partir de l’onglet Fichiers .

4. Joignez une image à votre message et sélectionnez Envoyer. Le bot répond par un message indiquant que l’image est reçue et enregistrée.

   

   Vous pouvez afficher l’image dans la fenêtre de conversation et à partir de l’onglet Fichiers .

   Remarque

   Une fois le bot installé dans l’étendue personnelle, l’utilisateur entre dans une conversation personnelle avec le bot.

Relever le défi

• 1 minutes restantes

Tu as trouvé quelque chose comme ça ?

Félicitations !

• Tout est terminé !

Vous avez terminé le tutoriel. Vous pouvez désormais charger des fichiers dans Teams à l’aide d’un bot.