Slack package 中的连接操作

使用 Control Room OAuth2 连接对 Slack 进行身份验证,并创建一个可重复使用的 Slack 会话,以便在自动化中执行后续操作。

先决条件

在使用连接 操作前,必须通过完成以下前提条件,先创建并配置一个 Slack 应用,生成所需的机器人令牌,并在 Control Room 中设置 OAuth 连接:

创建 Slack 应用
  • 前往 Slack 开发者门户:https://api.slack.com/apps
  • 导航到您的应用 > 创建新应用
  • 选择从头开始

    创建应用

  • 输入以下内容:
    • 应用名称: 例如,AA Slack integration
    • 选择一个工作区来开发您的应用:选择将要使用该应用的 Slack 工作区

    选择工作区

  • 单击创建应用
配置 OAuth 和权限
  • 创建应用后,在左侧面板中,导航到 OAuth 与权限
  • 导航到重定向 URL 部分。 在重定向 URL 字段中,输入回调 URL。该回调 URL 来自 Control Room 连接设置。
  • 导航到范围部分。

添加机器人令牌范围: 在范围部分,根据您的场景添加所需权限。 要添加,请单击添加 OAuth 范围

以下是一些示例:
  • chat:write → 以 @AA Slack integration 的身份发送消息
  • channels:read → 查看工作区中公共频道的基本信息
  • channels:history → 查看已添加 AA Slack integration 的公共频道中的消息和其他内容
  • groups:read → 查看已添加 AA Slack integration 的私有频道的基本信息
  • im:read → 查看已添加 AA Slack integration 的直接消息的基本信息。
注:
  • 请务必谨慎选择您的范围,因为范围不足可能会导致后续操作失败。
  • 目前仅支持机器人令牌认证。

配置 OAuth 2.0 连接: 有关创建自定义提供程序的更多信息,请参阅 在 Control Room 中配置 OAuth 2.0 连接

设置

  • OAuth 连接字段中单击选择,以从可用的 Control Room 管理的 OAuth2 凭据中进行选择。
    注: 确保 OAuth2 连接有效且在 Control Room 中处于活动状态。
  • 单击提供程序类型下拉菜单以选择可用或自定义的提供程序。
  • 连接名称字段,选择特定的 OAuth 连接对象

    该字段在选择提供程序类型之前处于禁用状态。

  • 令牌类型字段中,根据运行时将使用的令牌选择以下选项之一。
    • 共享:用于全局令牌。

      当与 Control Room 建立连接时,会创建一个共享类型的访问令牌。 此访问令牌存储为凭据。 当您运行自动化时,访问令牌会在使用在 Control Room 中设置的企业应用程序提供程序类型的自动化中被引用。

    • 用户特定:用于特定用户的令牌。
  • Slack 会话字段中,使用以下选项卡之一来创建会话:
    • 本地会话:用于指定一个只能在当前机器人中使用的会话名称。
    • 全局会话:指定一个可以在多个机器人中使用的会话名称,例如父机器人、子机器人,以及父机器人的所有其他子机器人

      建议: 父和子机器人应具有相同的软件包版本。

    • 变量:用于指定 Slack 会话变量。

      单击右侧的图标创建变量,然后在出现的窗口中选择 Slack 会话作为会话类型。 请参阅 创建变量