设置

简介

要启用 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. 在左侧导航面板中，单击“ Azure Active Directory”。
3. Azure Active Directory 页面打开后，单击“ 应用程序注册” 。

4. 单击顶部导航栏中的“ + 新注册 ”。

   
   

   

   
   
5. 输入应用程序的 名称 （例如，“Office365App”）。

6. 在“支持的帐户类型”下，选择适用于您的选项。

   • 有关选择哪个选项的更多信息，请参阅以下 Microsoft 的建议：

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

7. 单击 “注册”。

   
   

   

   
   
   备注：

   现在，Microsoft 身份验证库 (MSAL.NET) 使用 urn:ietf:wg:oauth:2.0:oob 作为默认重定向 URI，当您使用“交互式令牌”身份验证类型时（我们在所有示例中都使用该类型），和快速入门指南）。

   Microsoft 计划将来将默认重定向 URI 更改为 https://<span>login.microsoftonline.com/common/oauth2/nativeclient</span> ， 因此，您可以考虑改用此选项。

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

2. 添加 API 权限

1. 在已注册的应用程序页面（“Azure 门户”>“Azure Active Directory”>“应用程序注册”> “Office365App”）中，单击左侧导航面板中的“ API 权限 ”。
2. “API 权限”页面打开后，单击“ + 添加权限 ”（这将打开“ 请求 API 权限 ”窗口）。
3. 在“ 选择 API” 下，单击“ Microsoft API ”（默认情况下可能处于打开状态）。

4. 在“ 常用 Microsoft API”下，单击“ Microsoft Graph”。

   
   

   

   
   

5. 在 您的应用程序需要什么类型的权限？在，单击“委派权限”以显示权限列表。

   • 虽然 应用程序权限 也适用，但这些活动是为已向 Microsoft Graph API 分配了 委派权限 的应用程序设计的。
   • 有关权限类型的更多信息，请参阅 Microsoft Azure 文档中的配置客户端应用程序以访问网页 API 。

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

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

7. 单击“ 添加权限 ”（返回到 API 权限列表）

   
   

   

   
   

8. 验证您的 API 权限 包括您添加的 Chat 、 Group和 User 权限。

   
   

   

   
   

3. 构建您的项目

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

   1. 打开 UiPath Studio。
   2. 在“ 新建项目”下，单击“ 流程 ”（这将打开 “新建空白流程” 窗口）。
   3. 输入项目 “名称”、“位置”和 “说明”。

   4. 单击“创建”。

      
      

      

      
      

2. 安装 UiPath.Microsoft TeamsActivities 包。

   1. 在“ 设计 ”功能区中，单击“ 管理包 ”（这将打开“ 管理包 ”窗口）。
   2. 在“ 所有包” 下，单击 “开始!
   3. 在 搜索 栏中，输入 Teams 。

   4. 单击，安装并接受 UiPath.Teams.Activities的许可证。

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

        
        

        

        
        

操作完毕！

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

后续步骤

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

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

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