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 à créer votre projet d'automatisation, vous devrez d'abord décider si vous allez créer votre propre application ou utiliser l'application UiPath (par exemple, UiPathStudioO365App).

Important :

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 identifiant d'application (client) unique que vous saisissez dans l' activité Microsoft Office Teams.

Remarque :

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

Après avoir ajouté les autorisations, vous pourrez utiliser le même ID d’application dans les activités Étendue Microsoft Office 365 et Étendue 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. In the left-hand navigation panel, click Azure Active Directory.

3. After the Azure Active Directory page opens, click App registrations.

4. Click + New registration in the top navigation bar.

   

5. Enter a Name for your application (e.g., "Office365App").

6. Under Supported account types, select the option that applies to you.

   • 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.
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • Votre sélection dépend de votre type d’authentification. Pour plus d’informations à ce sujet, consultez l’ automatisation Unattended et Attended sur la page des détails de l’activité Étendue Microsoft Teams .
   • 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 de l'application de bureau dans la documentation de la plateforme d’identité Microsoft.

7. Click Register.

   

   Remarque :

   Today the Microsoft Authentication Library (MSAL.NET) uses urn:ietf:wg:oauth:2.0:oob as the default redirect URI and this value will likely work for you when using the InteractiveToken authentication type (we use this in all of our examples and Quickstart guides).

   In the future, Microsoft plans to change the default redirect URI to https://login.microsoftonline.com/common/oauth2/nativeclient, so you may consider using this instead.

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

2. Add API permissions

1. À partir de votre page d'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. After the API permission page opens, click + Add a permission (this opens the Request API permissions window).

3. Under Select an API, click Microsoft APIs (may be open by default).

4. Under Commonly used Microsoft APIs, click Microsoft Graph.

   

5. Sous Quel type d’autorisations votre application requiert-elle ?, cliquez sur Autorisations déléguées pour afficher la liste des autorisations.

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • 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. Click Add permissions (returning you to your list of API permissions)

   

8. Vérifiez que vos autorisations d’API incluent vos autorisations de chat, de groupe et d’utilisateur ajoutées.

   

3. Construisez votre projet

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

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Cliquez sur Créer (Create).

      

2. Installez le paquet UiPath.MicrosoftTeamsActivities .
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. Dans la barre de recherche , saisissez Équipes.
   4. Cliquez, installez et acceptez la licence pour le package 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 exemples pratiques des différentes activités afin que vous puissiez vérifier la connexion à votre application enregistrée et vous familiariser 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