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

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à terminé les activités Microsoft Office 365 ou si vous disposez d'une application enregistrée existante, vous pouvez accéder directement à la section Ajouter des autorisations d'API 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 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 :

   Aujourd’hui, la bibliothèque d’authentification Microsoft utilise urn:ietf:wg:oauth:2.0:oob comme URI de redirection par défaut. Cette valeur fonctionnera probablement pour vous lorsque vous utilisez le type d’authentification JetonInteractif (nous l’utilisons dans tous nos exemples et des guides de démarrage rapide). À l'avenir, Microsoft prévoit de modifier l'URI de redirection par défaut en https://Login.microsoftonline.com/common/oauth2/nativeclient, vous pouvez donc envisager de l'utiliser à la place.

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. Saisissez le nom,l'emplacement et la description du projet.

   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 bénéficier d'une expérience d'apprentissage pratique et 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 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.

• Équipe