Slack 身份验证

先决条件

根据您选择的身份验证类型，您可能需要以下凭据之一：

• OAuth 2.0 授权代码：用户作用域、机器人作用域和 Slack 凭据。
• 请自带 OAuth 2.0 应用程序：客户端 ID、客户端密码、用户作用域、机器人作用域。
• API 密钥：访问令牌（例如机器人令牌、用户令牌等）。有关更多详细信息，请参阅 Slack文档。

要创建私有 OAuth2 应用程序，请按照 Slack文档中描述的步骤操作。

备注：

在 Slack 中注册 OAuth 应用程序时，请确保将回调 URL设置为连接创建页面上显示的值，例如https://cloud.uipath.com/provisioning_/callback表示 Automation Cloud。

要创建连接，您必须是 Slack 工作区的成员或访客。

备注：

如果您使用“自带 OAuth 2.0 应用程序”创建连接，则在使用“单击了按钮”事件时还必须执行一些其他步骤。有关更多详细信息，请参阅结合使用单击的按钮和自带 OAuth 2.0 应用程序身份验证。

为 Slack 添加连接

要创建与 Slack 实例的连接，请执行以下步骤：

1. 从左侧栏中选择“Integration Service”。

2. 从“连接器”列表中选择“Slack” 。您也可以使用搜索栏来缩小连接器的范围。

3. 选择“连接到 Slack”按钮。

4. 输入首选身份验证方法所需的凭据。您可以选择三种身份验证类型：OAuth 2.0 授权代码、自带 OAuth 2.0 应用程序或 API 密钥。

   1. 如果您选择 “自带 OAuth 2.0 应用程序”方法，请输入所需的凭据，然后选择“连接” 。

      对于任何密码类型字段，您可以选择该字段旁边的菜单，然后选择“使用凭据资产” ，以引用链接到外部保险库的 Orchestrator 凭据资产，而不是直接输入值。有关更多信息，请参阅使用凭据资产进行连接。

   2. 如果选择 API 密钥方法，请输入 API 密钥，然后选择“连接” 。

      对于任何密码类型字段，您可以选择该字段旁边的菜单，然后选择“使用凭据资产” ，以引用链接到外部保险库的 Orchestrator 凭据资产，而不是直接输入值。有关更多信息，请参阅使用凭据资产进行连接。

   3. 如果您选择默认的 OAuth 2.0 授权代码方法，请继续执行步骤 4。

5. 根据您的要求或用例审核或更改机器人作用域和/或用户作用域。chat:write机器人作用域是必需的，无法删除 — 删除它会导致连接创建失败。所有其他作用域都是可选的。

6. Select Connect.

7. 从屏幕的右上角选择正确的工作区。 连接仅对此选定的工作区及其相应的频道执行操作。

   

8. Select Allow. With access to your Slack account, UiPath can do the following:

   • 查看有关您的内容和信息。
   • 查看有关频道和对话的内容和信息。
   • 查看有关工作区的内容和信息。
   • 请像您一样执行操作。
   • 在频道和对话中执行操作。
   • 在工作区中执行操作。

9. 已添加您的连接。

作用域和权限

您可以使用该连接在 UiPath Studio 中启用Slack 活动，为用户和频道管理、计划的消息传递以及其他协作方式构建自动化。

强制机器人作用域

无论采用何种身份验证方法，以下机器人作用域对所有 Slack 连接都是必需的。将其删除将导致连接创建无法完成。

范围	用途
chat:write	需要在创建连接确认消息后将其发布到 Slack 工作区

备注：

从机器人作用域中删除chat:write会导致连接创建失败。

所有作用域

使用下表检查使用 Slack 活动可以实现的各种基于权限的用例：

表 1.每个活动所需的 Slack 权限

作用域/权限	Use case	活动
chat:write（用户令牌和机器人令牌）	以机器人或用户身份在频道中发送消息。以机器人或用户身份回复频道中的消息。当用户单击频道中的按钮时，系统将向用户发送临时消息或我消息 。	向频道发送消息 发送回复
chat:write:customize（仅限机器人令牌）	使用自定义的机器人名称和图标向频道发送消息或向用户发送消息。	向频道发送消息向用户发送消息
chat:write:public（仅限机器人令牌）	即使机器人不是频道成员，也可以以机器人身份向公共频道发送通知/公告。	向频道发送消息
link:write（用户令牌和机器人令牌）	以机器人或用户身份发送带有链接预览的消息，例如 Jira 工单或 GitHub 问题等。	向频道发送消息向用户发送消息
channels:write（仅限用户令牌）	作为用户，根据需求/主题/目标为不同的团队和用户创建公共频道。关闭或重新打开支持工单时，以用户身份动态存档或取消存档或关闭临时频道/对话。	存档频道设置频道主题
channels:manage（仅限机器人令牌）	作为机器人，根据需求/主题/目标为不同的团队和用户创建公共频道。关闭或重新打开支持工单时，以用户身份动态存档或取消存档或关闭临时频道/对话。	创建频道存档频道设置频道主题
channels:join（仅限机器人令牌）	首先加入频道，然后以机器人身份将媒体文件作为 Slack 消息上传到频道中。	加入频道
groups:write（用户令牌和机器人令牌）	作为机器人或用户，根据需求/主题/目标为不同的团队和用户创建私人频道。	创建频道
IM:write（用户令牌和机器人令牌）	以机器人或用户身份发送单条消息 (IM)。	向用户发送消息
mpim:write（用户令牌和机器人令牌）	以机器人或用户身份在 MPIM 组中发送消息。以机器人或用户身份回复 MPIM 组中的消息。通过添加多个用户来打开 MPIM 对话，以便以机器人或用户身份发送消息。	向频道发送消息 发送回复
channels:read（用户令牌和机器人令牌）	检索已连接工作区的公共频道列表，以便以机器人或用户身份发送消息或管理用户。以机器人或用户身份读取公共频道信息，以发送消息或管理用户。	向频道发送消息向用户发送文件到频道发送回复邀请用户加入频道从频道中删除用户列出所有频道获取频道信息列出所有频道成员
groups:read（用户令牌和机器人令牌）	检索已连接工作区的私人频道列表，以便以机器人或用户身份发送消息或管理用户。以机器人或用户身份读取私人频道信息，以发送消息或管理用户。	向频道发送消息向用户发送文件到频道发送回复邀请用户加入频道从频道中删除用户列出所有频道获取频道信息列出所有频道成员
im:read（用户令牌和机器人令牌）	检索已连接工作区的 IM 对话列表，以便以机器人或用户身份发送消息。检索用户所属的 IM 对话列表。	列出所有频道获取频道信息
mpim:read（用户令牌和机器人令牌）	检索已连接工作区的 MPIM 组列表，以便以机器人或用户身份发送消息。检索用户所属的 MPIM 对话列表。	列出所有频道获取频道信息
files:read（仅限机器人令牌）	以机器人或用户身份通过 Slack 消息检索文件信息（例如公共 URL）并从 URL 下载重要文件（例如季度业绩）。	获取文件信息
files:write（用户令牌和机器人令牌）	通知某个用户组的所有用户有关重要更新的信息。例如，以机器人或用户身份，将季度销售业绩通知整个销售/营销团队。以机器人或用户身份在频道中上传媒体文件作为 Slack 消息。	将文件发送到频道
usergroups:read（仅限用户令牌）	检索用户组中的用户列表，以便将用户更新或添加为机器人或用户。	列出所有用户组
usergroups:write（仅限用户令牌）	以机器人或用户身份为多个频道创建用户组。每当将新用户添加到频道时，将用户作为机器人或用户添加到现有用户组中。每当存档/取消存档临时频道时，动态启用或禁用临时频道的用户组。	创建用户组将用户添加到用户组
users:read（用户令牌和机器人令牌）	以机器人或用户身份检索已连接工作区的用户列表，以便发送消息。	列出所有用户邀请用户加入频道从频道中删除用户向用户发送消息
users:read.email（用户令牌和机器人令牌）	以机器人或用户身份读取用户信息，例如姓名、电子邮件等，以发送通知。	通过电子邮件获取用户
Reactions:read（仅限机器人令牌）	侦听应用程序可以访问的频道中的消息的回应事件。将“已添加回应”触发器与“自带 OAuth 2.0 应用程序身份验证”一起使用时为必需。	已添加回应