View a markdown version of this page

Slack 集成 - Amazon Quick
开始前的准备工作配置 Slack在 Amazon Quick 中设置连接器可用操作管理和故障排除

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Slack 集成

使用 Slack 操作连接器，你可以通过自然语言直接在 Amazon Quick 中访问 Slack 平台。您无需离开 Amazon Quick 即可发送消息、管理频道、搜索内容以及与用户和用户组互动。

Amazon Quick 支持 Slack 的多种身份验证方法。选择最适合您组织安全要求的方法。

  • 默认 OAuth 应用程序-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。您可以直接使用您的 Slack 工作区进行身份验证。

  • 自定义 OAuth 应用程序-使用客户管理的 Slack 应用程序。此选项可让您的组织完全控制 OAuth 配置。

  • 不记名令牌 — 使用 Slack 机器人令牌进行身份验证。此方法适用于对工作区的机器人级访问。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

  • 一个 Slack 工作区，可以访问您要使用的频道和数据。

  • 对于自定义 OAuth 应用程序：访问 Slack 网站上的 Slack API 控制面板以创建应用程序。

  • 对于持有者令牌：来自 Slack 应用程序的机器人令牌（开头为xoxb-）。有关更多信息，请参阅 Slack 网站上的快速入门应用程序设置。

  • 有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

配置 Slack

如果您使用默认 OAuth 应用程序身份验证，请跳过此部分并转至。在 Amazon Quick 中设置连接器

对于自定义 OAuth 应用程序或持有者令牌身份验证，请在配置 Amazon Quick 之前在 Slack 中完成相应的步骤。

为自定义 OAuth 应用程序或持有者令牌创建 Slack 应用程序

创建 Slack 应用程序以获取 Amazon Quick 所需的客户凭证或机器人令牌。

  1. 前往 Slack 网站上的 Slack API 控制面板，然后选择创建新应用程序。

  2. 选择 “从头开始”。

  3. 输入应用程序名称并选择您的 Slack 工作空间。选择 Create App（创建应用程序）。

  4. 在左侧边栏中，选择 OAuth 和权限。

  5. 在 “重定向网址” 下，选择 “添加新的重定向 URL”，然后输入 Amazon 快速回传 URL：https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    选择 “添加”，然后选择 “保存 URL”。

  6. 在 “范围” 下，添加您的集成所需的机器人令牌作用域。有关推荐的范围，请参阅推荐瞄准镜。

  7. 在左侧边栏中，选择 “基本信息”。在 “应用程序凭证” 下，记录以下值：

    • 客户端 ID

    • 客户端密钥

  8. 对于持有者令牌：从 OAuth 和权限页面将应用程序安装到您的工作区。安装后，复制 Bot 用户 OAuth 令牌（开头xoxb-为）。

推荐瞄准镜

当你连接到 Slack 时，需要以下范围。创建自定义 Slack 应用程序时，请在 OAuth 和权限页面上添加这些范围。对于自定义 OAuth 应用程序，请将其添加为用户令牌范围。对于持有者代币，请将其添加为机器人代币范围。

Slack 推荐瞄准镜
Scope 说明
calls:read 读取通话信息。
calls:write 创建和管理呼叫。
channels:history 阅读公共频道中的消息历史记录。
channels:read 阅读有关公共频道的信息。
channels:write 管理公共频道。
chat:write 向频道和对话发送消息。
dnd:read 读取 “请勿打扰” 设置。
dnd:write 更新 “请勿打扰” 设置。
emoji:read 读取自定义表情符号。
files:read 读取频道中共享的文件。
files:write 上传和管理文件。
groups:history 在私人频道中读取消息历史记录。
groups:read 读取有关私人频道的信息。
groups:write 管理私人频道。
im:history 读取私信中的消息历史记录。
im:read 读取私信的相关信息。
im:write 开始私信。
links:read 读取链接预览。
links:write 管理链接预览。
mpim:history 读取群组私信中的留言历史记录。
mpim:read 读取有关群组私信的信息。
mpim:write 开始群组私信。
pins:read 读取已置顶的消息。
pins:write 固定和取消置顶消息。
reactions:read 读取消息上的表情符号反应。
reactions:write 添加和移除表情符号反应。
reminders:read 阅读提醒。
reminders:write 创建提醒。
remote_files:read 读取远程文件。
remote_files:share 共享远程文件。
search:read 搜索消息和文件。
stars:read 阅读已加星标的物品。
stars:write 星星和取消星标的物品。
team:read 读取工作空间信息。
usergroups:read 读取用户组信息。
usergroups:write 管理用户组。
users:read 读取用户信息。
users:read.email 读取用户的电子邮件地址。
users:write 更新用户信息。
users.profile:read 读取用户个人资料信息。
users.profile:write 更新用户个人资料信息。
注意

并非所有作用域都适用于用户令牌作用域和机器人令牌作用域。某些作用域（例如search:read和stars:read）仅可用作用户令牌作用域。在为持有者令牌身份验证配置范围时，请在 Slack 网站上的 Slack API 作用域参考中验证范围的可用性。

在 Amazon Quick 中设置连接器

从 “可用” 选项卡连接

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “可用” 选项卡进行连接。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 在 “可用” 选项卡上，找到 Slack，然后选择 Connect。

  3. 完成 Slack 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序或 Bearer Token 配置连接器，请使用为你的团队创建选项卡，如下所述。

从 “为你的团队创建” 选项卡创建

完成所有必需的 Slack 配置后，请在 Amazon Quick 中创建连接器。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. 找到并选择 Slack。

    注意

    如果 Slack 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “否，新建”。

  4. 输入连接器的名称。（可选）选择 + 添加描述以添加描述。

  5. 在 “连接类型” 中，选择 “公共网络”。

  6. 对于 OAuth 配置，请选择以下身份验证方法之一并配置必填字段。

    1. 对于默认 OAuth 应用程序：

      无需其他凭证。选择下一步以继续。

    2. 对于自定义 OAuth 应用程序，请配置以下字段：

      • 基本网址（可选）— Slack API 基础网址。示例：https://slack.com/api

      • 客户端 ID — 来自你的 Slack 应用程序的客户端 ID。

      • 客户密钥-来自你的 Slack 应用程序的客户端密钥。

      • 令牌网址-令牌端点。示例：https://slack.com/api/oauth.v2.access

      • 授权 URL-授权端点。示例：https://slack.com/oauth/v2/authorize

      • 重定向 URL — Pre-filled 使用 Amazon 快速回传网址。

    3. 对于不记名令牌，请配置以下字段：

      • 基本网址（可选）— Slack API 基础网址。示例：https://slack.com/api

      • 机器人令牌 — 您的 Slack 机器人令牌（开头为xoxb-）。

  7. 选择下一步。

  8. 如果您选择默认 OAuth 应用程序或自定义 OAuth 应用程序，则会打开 Slack 授权窗口。查看请求的权限，选择您的工作空间，然后选择允许。

  9. 在 “查看” 页面上，查看连接器的可用操作。选择下一步。

  10. 在 “发布” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

  11. 选择发布。

可用操作

设置连接器后，可以执行以下操作。

Slack 可用操作
类别 处理建议 说明
消息 聊天帖子消息 向频道、私信或私人群组发布消息。
消息 给我发消息 向频道发送第三人称操作消息。
消息 获取消息固定链接 检索特定消息的永久链接 URL。
渠道 对话创建 创建公共或私人频道。
渠道 对话记录 从频道检索消息历史记录。仅返回主时间轴消息，不返回主题回复。
渠道 对话回复 检索对特定家长消息的主题回复。
渠道 对话邀请 邀请用户访问现有频道。
渠道 对话加入 加入现有频道。
渠道 对话大放异彩 将用户从频道中移除。
渠道 对话离开 离开频道。
渠道 对话成员 列出频道的成员 ID。
渠道 对话已打开 打开或恢复私信或多人私信。
渠道 对话设定主题 设置或更新频道的主题。
渠道 获取对话 按 ID 检索频道的元数据。
渠道 列出频道 列出用户可用的频道。
渠道 列出用户的对话 列出用户可访问的频道和私信。
反应 创建反应 为消息添加表情符号反应。
反应 删除反应 移除消息中的表情符号反应。
反应 列出反应 列出对消息、文件或文件评论的回应。
文件 上传或创建文件 将文件或媒体上传到频道或话题。
文件 上传到外部网址 添加对外部文件的引用，以便在 Slack 中共享。
文件 下载文件 下载在 Slack 中共享的文件。
文件 文件信息 检索文件的元数据和注释。
文件 文件清单 使用可选筛选器列出工作区中的文件。
Search 搜索全部 在整个工作区中搜索消息和文件。
Search 搜索消息 使用日期范围和过滤器搜索邮件。
Search 搜索频道 按名称、主题或目的搜索频道。
Search 搜索用户 按电子邮件、姓名或显示名称搜索用户。
Search 搜索上下文 跨消息、文件、频道和用户进行搜索。支持使用 Slack 人工智能在工作空间上进行语义搜索。
Search 获取搜索配置 检查工作区中是否提供语义搜索。
Users 获取用户详细信息 按 ID 检索用户信息。
Users 获取用户个人资料 检索用户的个人资料信息。
Users 用户配置文件集 更新用户的个人资料字段。
Users 用户名单 列出工作区中的所有用户。
用户组 用户组创建 创建新的用户组。
用户组 用户组列表 列出工作区中的用户组。
用户组 用户组用户更新 替换用户组的所有成员。
提醒 提醒事项添加 使用指定的文本和时间创建提醒。
Workspace 获取队伍 检索有关 Slack 工作空间的元数据。
注意

您可以使用的操作取决于为 Slack 应用程序配置的范围以及经过身份验证的用户可访问的频道。

管理和故障排除

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）— 确认您的 Slack 工作区处于活动状态，并且可以直接登录 Slack 网站。对于自定义 OAuth 应用程序，请确认您的 Slack 应用程序中的重定向网址与 Amazon Quick 回传网址相匹配。

  • 无效的客户端凭证（自定义 OAuth 应用程序）-验证客户端 ID 和客户端密钥是否与 Slack 应用程序的 “基本信息” 部分中的值相匹配。

  • 不记名令牌被拒绝 — 验证您的机器人令牌是否处于活动状态且开头xoxb-为。可以从 Slack API 控制面板中撤消代币。

  • 权限不足-验证为 Slack 应用程序配置的范围是否包含您要使用的操作所需的权限。请参阅推荐瞄准镜。

  • 频道未找到或不在频道中-验证机器人是否已添加到频道中。在尝试发布消息或阅读历史记录之前，请邀请机器人加入频道。