设置

简介

要启用 Microsoft Teams 活动，您的应用程序必须与Microsoft 身份平台集成，并获配正确的Microsoft Graph API 权限。

要集成您的应用程序、分配权限并开始构建自动化项目，您首先需要决定是要创建自己的应用程序还是使用 UiPath 应用程序（例如 UiPathStudioO365App）。

重要提示：

如果您使用的是 UiPath 应用程序，则需要确保添加管理员同意。

如果您未添加管理员同意，您将看到以下错误。

如果您要创建自己的应用程序，则需要按照以下步骤操作。

注册 Microsoft Office Teams 应用程序后，Azure Active Directory 会分配您在Microsoft Office Teams 作用域中输入的唯一应用程序（客户端）ID 。

备注：

如果您已完成 Microsoft Office 365 活动或已有已注册的应用程序，则可以直接转到“添加 API 权限”部分，为 Microsoft Teams 活动添加必要的权限。

添加权限后，您将能够在Microsoft Office 365 作用域和Microsoft Teams 作用域活动中使用相同的应用程序 ID 。

步骤

1. 注册您的应用程序

1. 使用您的个人、工作或学校 Microsoft Office 365 帐户登录到Azure 门户。

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.

   • 有关选择哪个选项的更多信息，请参阅以下 Microsoft 的建议：
     • 仅限此组织目录中的帐户 - 如果您的目标受众是组织内部的，请使用此选项。
     • 任何组织目录中的帐户（任何 Azure AD 目录 - 多租户）- 如果您的目标受众是企业或教育客户，请使用此选项并启用多租户。
     • 任何组织目录（任何 Azure AD 目录 - 多租户）中的帐户和个人 Microsoft 帐户（例如 Skype、Xbox）- 使用此选项可定位最广泛的 Microsoft 身份集并启用多租户。
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • 您的选择取决于您的身份验证类型。有关此主题的更多信息，请参阅“Microsoft Teams 作用 域中的 无人值守和有人值守的自动化” 活动详细信息页面。
   • 在我们的示例中，组织支持多租户身份验证，并且只能使用需要重定向 URI 的交互式令牌身份验证类型。
   • 如果您的身份验证类型为“集成 Windows 身份验证”或“用户名和密码”，则无需为应用程序注册重定向 URI。 这些流往返于 Microsoft 标识平台 v2.0 端点，并且不会在任何特定 URI 上回调您的应用程序。
   • 有关更多信息，请参阅 Microsoft 身份平台文档中的桌面应用程序注册。

7. Click Register.

   

   备注：

   目前，Microsoft 身份验证库 (MSAL.NET) 使用urn:ietf:wg:oauth:2.0:oob作为默认重定向 URI，在使用“交互式令牌”身份验证类型时，此值可能适用（我们在所有示例和快速入门指南中都会使用此值）。未来，Microsoft 计划将默认重定向 URI 更改为https://login.microsoftonline.com/common/oauth2/nativeclient ，因此您可以考虑改用此 URI。

操作完毕！ 现在，我们向已注册的应用程序添加 API 权限。

2. Add API permissions

1. 在已注册的应用程序页面（ Azure 门户 > Azure Active Directory > 应用注册 > Office365App ）中，单击左侧导航面板中的“API 权限” 。

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. 在“您的应用程序需要什么类型的权限？”下，单击“委派权限”以显示权限列表。

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • 有关权限类型的更多信息，请参阅 Microsoft Azure 文档中的配置客户端应用程序以访问网页 API 。

6. 使用搜索栏或向下滚动按字母顺序排列的列表，然后选择以下权限：

   • Chat.ReadWrite
   • 组、读写、全部
   • 用户读取全部

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

   

8. 验证您的API 权限包括您添加的“聊天” 、 “组”和“用户”权限。

   

3. 构建项目

1. 创建一个新的自动化项目。

   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. 单击“创建”。

      

2. 安装UiPath.MicrosoftTeamsActivities包。
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. 在搜索栏中，输入Teams 。
   4. 单击，安装并接受UiPath.Teams.Activities的许可证。

      • 有关 Uipath Studio 包的更多信息，请参阅 Studio 指南中的管理包。

        

操作完毕！

现在，您已完成设置，可以开始将 Microsoft Teams 活动添加到项目中。

后续步骤

要获得动手学习体验并快速开始使用活动，请参阅快速入门指南。这些指南提供分步说明，以帮助您创建不同活动的工作示例，以便您可以验证与已注册应用程序的连接并熟悉输入/输出属性。

要了解有关 Microsoft Teams 活动（包括示例属性输入/输出）的更多信息，请参阅以下活动页面以获取完整的活动列表以及指向活动详细信息页面的链接。

• 频道
• 聊天
• 消息
• 团队