Configuration

Introduction

Pour activer les activités Microsoft Teams, votre application doit être intégrée à la Plateforme d’ identités Microsoft et disposer des autorisations d'API Microsoft Graph appropriées.

Pour intégrer votre application, attribuer des autorisations et commencer à construire votre projet d'automatisation, vous devez d'abord décider si vous allez créer votre propre application ou utiliser l'application UiPath (par ex. UiPathStudioO365App).

Attention : si vous utilisez l'application UiPath, vous devrez vous assurer d'ajouter le consentement de l'administrateur.

Si vous n'ajoutez pas le consentement de l'administrateur, l'erreur ci-dessous s'affichera.

Si vous créez votre propre application, vous devrez suivre les étapes ci-dessous.

Après avoir enregistré votre application Microsoft Office Teams, Azure Active Directory lui attribue un ID d'application (client) unique que vous saisissez dans le champ Étendue Microsoft Office Teams (Microsoft Office Teams Scope).

Remarque :

Si vous avez déjà effectué les activités Microsoft Office 365 ou si vous avez une application enregistrée existante, vous pouvez accéder directement à la section Ajouter des autorisations d'API ( Add API permissions ) et ajouter les autorisations nécessaires pour les activités Microsoft Teams.

Après avoir ajouté les autorisations, vous pourrez utiliser le même IDApplication dans les activités Étendue Microsoft Office 365 (Microsoft Office 365 Scope) et Étendue Microsoft Teams (Microsoft Teams).

Étapes

1. Enregistrez votre application

1. Connectez-vous au portail Azure à l’aide de votre compte Microsoft Office 365 personnel, professionnel ou scolaire.
2. Dans le panneau de navigation de gauche, cliquez sur Azure Active Directory.
3. Une fois la page Azure Active Directory ouverte, cliquez sur Inscriptions d'applications ( App registrations) .

4. Cliquez sur + Nouvelle inscription (New registration) dans la barre de navigation supérieure.

   
   

   

   
   
5. Saisissez un nom pour votre application (par exemple, «Office365App»).

6. Sous Types de compte pris en charge ( Supported account types), sélectionnez l'option qui s'applique à vous.

   • Pour plus d'informations sur l'option à sélectionner, vous trouverez ci-dessous les recommandations de Microsoft :

     • Comptes uniquement dans cet annuaire de l'organisation (Accounts in this organization directory only) : utilisez cette option si votre public cible est interne à votre organisation.
     • Comptes dans n'importe quel annuaire de l'organisation (Tous les annuaires Azure AD - Multilocataire) : utilisez cette option si votre public cible est constitué de clients professionnels ou éducatifs et pour activer l'architecture mutualisée.
     • Les comptes dans n'importe quel annuaire de l'organisation (N'importe quel annuaire Azure AD - Multitenant) et les comptes Microsoft personnels (par exemple, Skype, Xbox) - Utilisez cette option pour cibler l'ensemble le plus large d'identités Microsoft et pour activer l'architecture multilocataire.
   • Sous URI de redirection (facultatif), saisissez une adresse URI (le cas échéant).
   • Votre sélection dépend de votre type d'authentification. Pour plus d'informations à ce sujet, consultez la page des détails de l'activité Unattended and Attended Automation in the Microsoft Teams Scope ).
   • Dans notre exemple, l'organisation prend en charge l'authentification multi-locataires et ne peut utiliser que le type d'authentification par jeton interactif qui nécessite un URI de redirection.
   • Si votre type d'authentification est Authentification Windows intégrée ou Nom d'utilisateur et mot de passe, vous n'avez pas besoin d'enregistrer un URI de redirection pour votre application. Ces flux font un aller-retour vers le point de terminaison v2.0 de la plate-forme d'identité Microsoft, et votre application ne sera pas rappelée sur un URI spécifique.
   • Pour plus d’informations, consultez Enregistrement d’applications de bureau ( Desktop app-registration ) dans la documentation de la plate-forme d’identités Microsoft.

7. Cliquez sur Enregistrer ( Inscrire).

   
   

   

   
   
   Remarque :

   Aujourd'hui, la bibliothèque d'authentification Microsoft (MSAL.NET) utilise urn:ietf:wg:oauth:2.0:oob comme URI de redirection par défaut et cette valeur fonctionnera probablement pour vous lorsque vous utiliserez le type d'authentification InteractiveToken (nous l'utilisons dans tous nos exemples) et guides de démarrage rapide).

   À l'avenir, Microsoft prévoit de remplacer l'URI de redirection par défaut par https://<span>login.microsoftonline.com/common/oauth2/nativeclient</span>, vous pouvez donc envisager de l’utiliser à la place.

Vous avez terminé ! Maintenant, ajoutons des autorisations API à votre application enregistrée.

2. Ajouter des autorisations d'API

1. Sur la page de votre application enregistrée (Portail Azure > Azure Active Directory > Inscriptions d'applications > Office365App), cliquez sur Autorisations d'API dans le panneau de navigation de gauche.
2. Une fois la page d'autorisation de l'API ouverte, cliquez sur + Ajouter une autorisation (cela ouvre la fenêtre Demander les autorisations de l'API ).
3. Sous Sélectionner une API, cliquez sur API Microsoft (peut être ouvert par défaut).

4. Sous API Microsoft couramment utilisées, cliquez sur Microsoft Graph.

   
   

   

   
   

5. Sous Quel type d'autorisations votre application requiert-il ?, cliquez sur Autorisations déléguées ( Delegated permissions ) pour afficher la liste des autorisations.

   • Bien que les autorisations d'application fonctionnent également, les activités sont conçues pour les applications avec des autorisations déléguées attribuées aux API Microsoft Graph.
   • Pour plus d'informations sur les types d'autorisations, consultez Configurer une application cliente pour accéder aux API Web dans la documentation Microsoft Azure.

6. Utilisez la barre de recherche ou faites défiler la liste alphabétique vers le bas et sélectionnez les autorisations suivantes :

   • Chat.Lecture-Écriture (Chat.Lecture-Écriture)
   • Grouper.Lecture.Écriture.Tout
   • Lire.Tout. par l’utilisateur

7. Cliquez sur Ajouter des autorisations (pour revenir à votre liste d' autorisations API)

   
   

   

   
   

8. Vérifiez que vos autorisations d'API incluent vos autorisations Chat, Groupe et Utilisateur ajoutées.

   
   

   

   
   

3. Créez votre projet

1. Créez un nouveau projet d'automatisation.

   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un Nom, unEmplacementet une Descriptionde projet .

   4. Cliquez sur Créer (Create).

      
      

      

      
      

2. Installez le package UiPath.MicrosoftTeamsActivities .

   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Go!
   3. Dans la barre de recherche , saisissez Équipes.

   4. Cliquez sur, installez et acceptez la licence pour le fichier UiPath.Teams.Activities.

      • Pour plus d’informations sur les packages UiPath Studio, consultez la section Gestion des packages dans le guide de Studio.

        
        

        

        
        

Vous avez terminé !

Maintenant que vous avez terminé la configuration, vous pouvez commencer à ajouter les activités Microsoft Teams à votre projet.

Prochaines étapes

Pour une expérience d'apprentissage pratique et pour commencer rapidement à utiliser les activités, consultez les guides de démarrage rapide . Ces guides fournissent des instructions étape par étape pour vous aider à créer des échantillons fonctionnels des différentes activités afin que vous puissiez vérifier la connexion à votre application enregistrée et familiarisez-vous avec les propriétés d'entrée/de sortie.

Pour en savoir plus sur les activités Microsoft Teams (y compris des exemples d’entrées/sorties de propriétés), consultez les pages d’activités suivantes pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.

• Canaux
• Chats
• Messages
• Équipe