IBM Cloud Docs
与 Slack 集成

与 Slack 集成

IBM Cloud

Slack 是一种基于云的消息传递应用程序,可帮助人们相互进行协作。

创建操作后,可以将助手与 Slack 集成。

集成后,根据对助手配置支持的事件,助手可以响应直接消息中询问的问题,或响应在直接提及该助手的通道中询问的问题。

有关如何使用 watsonx Assistant,Slack 和 Db2 创建 Slackbot 的示例和指示信息在解决方案教程 构建数据库驱动的 Slackbot 中提供。

准备工作

要将 Slack 与助理集成,您必须拥有一个 Slack 应用程序以及必要的角色和权限:

角色 许可权
工作空间或
组织所有者
查看信息
发布信息
执行操作

要创建 slack 应用程序,请参阅 快速入门:启动工作流

有关角色和权限的更多信息,请参阅 Slack-Getting started

添加 Slack 集成

  1. 通过单击左侧菜单中的集成图标 (集成图标),转至“集成”页面。

  2. 单击 Slack 磁贴上的 添加

  3. 然后,再次点击 “添加”。

开始

设置 Slack 有四个步骤:

  • 设置你的 Slack 机器人
  • watsonx Assistant 连接到Slack
  • 配置你的 Slack 机器人
  • 连接您的助手

设置你的 Slack 机器人

  1. 访问 Slack 网站上的 Your Apps 页面,然后单击要使用的应用程序或创建一个新的应用程序。

watsonx Assistant 连接到Slack

  1. 在Slack应用设置页面,进入基本信息选项卡,向下滚动到应用凭证部分

  2. 复制您的验证令牌并将其粘贴到 助手设置页面。

  3. Slack 应用程序设置页面中,转到 Features > OAuth & Permissions 并向下滚动到 Bot Token Scopes 部分。

  4. 点击添加OAuth范围,并选择以下范围:

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write
  5. 向上滚动页面至 OAuth Tokens for Your Workspace 部分,然后单击 Install App to Workspace,再单击 Allow.

    您将被重定向到 OAuth & Permissions 页面。

  6. 助手设置页面中复制并粘贴您的 Bot 用户 OAuth 访问令牌。

  7. 单击下一步以继续。

配置你的 Slack 机器人

  1. 复制生成的URL

  2. Slack 应用程序设置页面中,转到 Features > Event Subscriptions 并切换 Enable Events 开关 on

  3. URL 下粘贴 URL。

    请耐心等待,直到看到 URL 旁边出现绿色的勾号,表示验证成功

  4. 向下滚动并单击 订阅机器人事件

  5. 选择您想订阅的活动类型。 您必须至少选择下列其中一种类型:

    • message.im:侦听在直接消息通道中发布的消息事件。

    • app_mention:仅侦听提及应用程序或机器人的消息事件。

      选择正常字体的 app_mention 条目,而不是以粗体字体显示的 app_mention 条目。

  6. 单击保存更改

  7. 助手设置页面,单击下一步

连接您的助手

  1. Slack 应用程序设置页面中,转到 Features > AppHome 并单击 Edit 旁边的 App Display Name

  2. 完成更改后,单击 保存

  3. 始终将我的机器人显示为在线切换到 on

  4. 转到 Show Tabs 部分,将 Messages Tab 切换为 on

  5. 选中 Allow users to send Slash commands and messages from the messages tab 复选框。

  6. 如果要在 Slack 应用程序中添加对显示按钮、菜单和消除歧义选项的支持,请执行以下步骤:

    1. 转到 Interactivity & Shortcuts 选项卡并启用该功能
    2. 请将您的请求 URL 粘贴到提供的文本输入字段中。
    3. 单击保存更改
  7. 助手设置页面,单击完成

如果更改了认证所需的 token 字段,那么必须重新填充并验证相关字段中的所有条目。

操作注意事项

您在操作中添加的丰富回复会显示在Slack频道中,但以下情况除外:

  • 连接到真人客服:此回复类型将被忽略。

  • 选项:此响应类型显示用户可以选择的选项列表。

    • 用户点击其中一个选项后,现有的选择就会消失,取而代之的是由用户选择产生的用户输入。 如果在单个回复中包含多个回复类型,则必须将选项回复类型放在最后,以避免因回复和用户输入混合而造成混淆。

    • 如果选项显示在下拉列表中,那么每个选项值的长度必须为 75 个字符或更少。 当列表包含5个或更多选项时,将以下拉列表的形式显示。

与助手聊天

要开始与助手聊天,请完成以下步骤:

  1. 打开 Slack,然后转至与应用程序关联的工作空间。
  2. 单击在“应用程序”部分中创建的应用程序。
  3. 与助手聊天。

Slack 集成不会处理欢迎操作。 欢迎消息不会像在助手预览中那样显示在 Slack 通道中。 它不会从此处触发,因为在用户启动的操作流程中,具有 welcome 特殊条件的节点会被跳过。 Slack 会等待用户启动交谈。

当前会话在60分钟(精简版和标准版为5分钟)不活动后自动重启。 这意味着,如果用户停止与助手进行交互,那么在 60 分钟(或 5 分钟)后,先前交谈期间设置的所有上下文变量值都会设置为 null 或恢复为其缺省值。