Einrichten

Einleitung

To enable the Microsoft Teams activities, your app must be integrated with the Microsoft identity platform and have the correct Microsoft Graph API permissions assigned to it.

To integrate your application, assign permissions, and start building your automation project, you will first need to decide if you will create your own app or use the UiPath app (for example, UiPathStudioO365App).

Wichtig:

If you are using the UiPath app then you will need to ensure that you add admin consent.

Wenn Sie keine Administratorzustimmung hinzufügen, wird der folgende Fehler angezeigt.

Wenn Sie Ihre eigene App erstellen, müssen Sie die folgenden Schritte ausführen.

After registering your Microsoft Office Teams application, Azure Active Directory assigns a unique application (client) ID that you enter in the Microsoft Office Teams Scope.

Hinweis:

If you already completed the Microsoft Office 365 Activities or have an existing registered application, you can go straight to the Add API permissions section and add the necessary permissions for the Microsoft Teams activities.

After adding the permissions, you'll be able to use the same ApplicationID in both the Microsoft Office 365 Scope and Microsoft Teams Scope activities.

Schritte

1. Registrieren Sie Ihre Anwendung

1. Sign in to the Azure portal using your personal, work, or school Microsoft Office 365 account.

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.

   • Weitere Informationen zur Auswahl der Option finden Sie in den Empfehlungen von Microsoft:
     • Nur Konten in diesem Organisationsverzeichnis – Verwenden Sie diese Option, wenn Ihre Zielgruppe innerhalb Ihrer Organisation liegt.
     • Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Azure AD-Verzeichnis – Mehrinstanzenfähig) – Verwenden Sie diese Option, wenn Ihre Zielgruppe Geschäfts- oder Bildungskunden sind, und um die Mehrmandantenfähigkeit zu aktivieren.
     • Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Azure AD-Verzeichnis – Mehrinstanzenfähig) und persönliche Microsoft-Konten (z. B. Skype, Xbox) – Verwenden Sie diese Option, um auf die breiteste Gruppe von Microsoft-Identitäten abzuzielen und die Mehrmandantenfähigkeit zu aktivieren.
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • Your selection is dependent on your authentication type. For more information on this topic, see the Unattended and Attended Automation in the Microsoft Teams Scope activity details page).
   • In unserem Beispiel unterstützt die Organisation die mandantenfähige Authentifizierung und kann nur den Authentifizierungstyp Interactive Token verwenden, der einen Umleitungs-URI erfordert.
   • Wenn Ihr Authentifizierungstyp Integrierte Windows-Authentifizierung oder Benutzername und Kennwort ist, müssen Sie keinen Umleitungs-URI für Ihre Anwendung registrieren. Diese Flows führen einen Roundtrip zum Microsoft Identity Platform v2.0-Endpunkt durch, und Ihre Anwendung wird nicht für einen bestimmten URI zurückgerufen.
   • For more information, see Desktop app-registration in the Microsoft identity platform documentation.

7. Click Register.

   

   Hinweis:

   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.

Fertig! Jetzt fügen wir Ihrer registrierten Anwendung API-Berechtigungen hinzu.

2. Add API permissions

1. From your registered application page (Azure portal > Azure Active Directory > App registrations > Office365App), click API permissions in the left-hand navigation panel.

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. Under What type of permissions does your application require?, click Delegated permissions to show the list of permissions.

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • For more information about permission types, see Configure a client application to access web APIs in the Microsoft Azure documentation.

6. Verwenden Sie die Suchleiste oder scrollen Sie in der alphabetischen Liste nach unten und wählen Sie die folgenden Berechtigungen aus:

   • Chat.ReadWrite
   • Group.ReadWrite.All
   • Benutzer.Alle.Lesen

7. Click Add permissions (returning you to your list of API permissions)

   

8. Verify your API permissions include your added Chat, Group, and User permissions.

   

3. Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   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. Klicken Sie auf Erstellen (Create).

      

2. Install the UiPath.MicrosoftTeamsActivities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. In the Search bar, enter Teams.
   4. Click, install and accept the license for the UiPath.Teams.Activities.

      • For more information about Uipath Studio packages, see Managing Packages in the Studio Guide.

        

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit dem Hinzufügen der Microsoft Teams-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

For a hands-on learning experience and to quickly start using the activities, see the Quickstart guides. These guides provide step-by-step instructions to help you create working samples of the different activities so that you can verify the connection to your registered app and get familiar with the input/output properties.

Weitere Informationen zu den Microsoft Teams-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf den folgenden Aktivitätsseiten mit einer vollständigen Aktivitätsliste und Links zu den Aktivitätsdetailseiten.

• Kanäle
• Chats
• Messages
• Teams