活动

设置

简介

要启用 Slack 活动，您必须在“ Slack 作用域 ”活动中输入身份验证详细信息。这些身份验证详细信息使机器人能够代表您执行 Actions 并访问您允许的数据。

要生成和授予身份验证详细信息，并开始构建自动化项目，请完成以下步骤：

创建应用程序后，Slack 会为其分配一个唯一的客户端 ID，即客户端密码（即应用程序凭据）和一个 OAuth 访问令牌（用于无人值守自动化），您将在 Slack 作用域 活动的身份验证属性中输入该令牌。

步骤

在使用“Slack”活动之前，请按照以下步骤生成或收集“ Slack 作用域 ”活动所需的输入数据。

1. 创建 Slack 应用程序

要使用 Slack 活动，您可以创建一个简单的单一工作区应用程序。下面的步骤和示例假定您拥有现有工作区，并且是现有工作区的成员。

登录Slack 工作区或打开 Slack 桌面应用程序。
- 如果您使用上面的 URL 登录，则需要工作区 Slack URL 。
转到您的 Apps ，然后单击“新建应用程序”按钮。
输入您的 应用程序名称，选择“ 开发 Slack 工作区 ”，然后单击“ 创建应用程序 ”按钮。

创建应用程序后，您将转到“ 基本信息 ” 页面。您可以在此处找到在“松弛作用域”活动中进行有人值守的自动化身份验证所需的 客户端 ID 和 客户端密码 。

在将这些内容复制并粘贴到活动中之前，您应该按照下一部分中的步骤配置 OAuth 和权限 功能。

备注：

虽然技术上可以，但不建议这样做，因为您需要与他们共享客户端密码。

如果您有兴趣与团队成员共享应用程序，则可以使用无人值守自动化模式，因为它依赖于可共享的 OAuth 访问令牌。

2. 添加应用程序权限

使用作用域为应用程序添加权限。作用域定义此应用程序可以调用的 API 方法，以及它可以在安装它的工作区中访问的信息。许多作用域仅限于特定资源，例如频道或文件。

备注：

如果您计划仅运行有人值守的自动化，则不需要将作用域直接添加到您的应用程序。如果您运行有人值守的自动化，则可以使用“ Slack 作用域 ”活动中的“作用域”属性选择作用域。

由于在应用程序中设置作用域可同时启用无人值守和有人值守的自动化，因此我们建议您在开始使用活动包之前完成以下步骤；这使您可以在模式之间自由切换。

在左侧导航栏中，单击 OAuth 和权限。
在“ 重定向 URL ” 部分中，单击“ 添加新的重定向 URL” 按钮，然后输入您的 URL。
- 如果您不知道应输入的 URL，可以暂时将其留空。
- 当您首次尝试使用 Slack 作用域 活动（使用有人值守的自动化）连接到您的应用程序时，该活动将打开一个新网页，其中显示 OAuth 错误。此错误包括您的工作区正在使用的重定向 URL（即“传递的 URI”）。您可以复制此 URL，并将其输入为“重定向 URL”。
在“ 作用域 ”部分中，添加要分配给应用程序的权限作用域，然后单击“ 保存更改 ”按钮（请参阅下一部分中要添加的完整作用域列表）。

要添加的作用域

以下是不同 Slack 活动所需的作用域。表格中还包括每个作用域到“ Slack 作用域 ”活动中“作用域”属性值的映射。

范围	活动	“作用域”属性
channels:write ^{修改公共频道}	创建频道邀请加入频道加入频道离开频道从频道中删除发送消息	PublicChannels
组：写入 ^{修改您的私人频道}	邀请加入频道离开频道从频道中删除发送消息	PrivateChannels
我：写 ^{修改用户的直接消息}	邀请加入频道离开频道从频道中删除发送消息	DirectMessages
mpim:write ^{更改用户的群组消息}	邀请加入频道离开频道从频道中删除发送消息	GroupMessages
文件：写入：用户 ^{以用户身份上传和修改文件}	发送消息	文件
文件:读取 ^{访问工作区的文件、注释和关联信息}	下载文件发送消息	文件
channels:read ^{访问有关用户公共频道的信息}	获取消息	PublicChannels
组:读取 ^{访问有关用户私人频道的信息}	获取消息	PrivateChannels
im:read ^{访问有关用户直接消息的信息}	获取消息	DirectMessages
mpim:读取 ^{访问有关用户的群组消息的信息}	获取消息	GroupMessages
channels:history ^{访问用户的公共频道}	获取回复	PublicChannels
组：历史记录 ^{访问用户私人频道中的内容}	获取回复	PrivateChannels
im:history ^{访问用户直接消息中的内容}	获取回复	DirectMessages
mpim:历史记录 ^{访问用户的群组消息}	获取回复	GroupMessages
聊天：写入：用户 ^{以用户身份发送消息}	回复发送消息	聊天
搜索:已读 ^{搜索工作区的内容}	搜索	（包含在 DirectMessage 和/或 GroupMessage 中）
users.profile: 写入 ^{修改用户的个人资料}	更新状态	用户
用户:read.email ^{查看工作区成员的电子邮件地址}	邀请加入频道从频道中删除	用户
users:read ^{查看工作区的成员列表及其联系信息}	邀请加入频道从频道中删除	用户

选择作用域后，即可按照下一部分中的步骤将应用程序安装到工作区。

3. 将您的应用程序安装到工作区

根据工作区的管理方式，您可能需要请求安装应用程序。

在“ OAuth 令牌和重定向 URL ” 部分中，单击“ 将应用程序安装到 Workspace ” 按钮或“ 请求安装” 按钮。
安装应用程序后，系统会生成 OAuth 访问令牌 。
- 与 客户端 ID 和 客户端密码类似， OAuth 访问令牌 用于身份验证。运行自动化项目时，两者之间的差异将适用。
  - 如果运行有人值守的自动化，则“ 松弛作用域 ”活动需要“ 客户端 ID”、“ 客户端密码”和“ 作用域 ”属性中的值。
  - 如果运行无人值守自动化，则“ 松弛作用域 ”活动仅需要“OAuth 访问令牌 ”属性中的值。

4. 构建项目

创建一个新的自动化项目。
1. 打开 UiPath Studio。
2. 在“ 新建项目”下，单击“ 流程 ”（这将打开 “新建空白流程” 窗口）。
3. 输入项目名称、位置和说明。
4. 单击“创建”。
安装 UiPath.Slack.Activities 包。
1. 在“ 设计 ”功能区中，单击“ 管理包 ”（这将打开“ 管理包 ”窗口）。
2. 在“ 所有包” 下，单击 “开始!
3. 在搜索栏中，输入 Slack。
4. 单击、安装并接受 UiPath.Slack.Activities的许可证。
  - 有关 Uipath Studio 包的更多信息，请参阅《Studio 指南》中的管理包。