集成 Slack

部署 Slack 集成,为可能不是流量密集型但需要其成员关注的关键通道提供额外的监控功能。为了定制可供特定群组或部门使用的通道,请使用多个集成。

注意:

我们想要你的反馈!请在使 对此集成模板的反馈 用时提供。对 专用论坛 于任何问题,我们的团队也会每天监控我们的。

有关 Slack 的开箱即用微应用的全面详细信息,请参阅 使用 Slack

检查必备项

以下是您在 Citrix Workspace 微应用中输入的值:

  • 基本 URLhttps://slack.com/api
  • 授权 URLhttps://slack.com/oauth/authorize
  • 令牌 URLhttps://slack.com/api/oauth.access
  • 通道 ID:在 Slack 中创建新的收藏夹通道时,您会收集此信息。您需要这个来修改终端节点和服务操作。请参阅 创建收藏夹通道并收集通道 ID
  • OAuth 访问令牌:您在设置集成模板时将其作为 令牌 值输入。当您创建机器人时收集此令牌、客户端 ID 和客户端密钥。
  • 客户端 ID:客户端 ID 是表示授权服务器唯有的客户端注册信息的字符串。
  • 客户端密钥:客户端密码是设置目标应用程序集成时发出的唯一字符串。

注意:

建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

创建新的服务帐户

集成需要定期访问您的 Slack 实例。我们建议创建具有完全管理员权限的专用用户帐户。在这里注册: https://slack.com/get-started#/create.

启用 API

可以向特定资源发出的 API 请求数量是有限的。因此,我们建议以下内容:

创建机器人

机器人是与用户互动的 Slack 应用程序,能够发布、接收和回复来自用户的消息。创建 Slack 应用程序,然后选择要添加到应用程序的范围。

  1. 导航到 Slack Management UI 并创建一个应用程序(如果您尚未创建应用程序): https://api.slack.com/apps
  2. 输入 应用程序名称,然后选择将在其中安装应用程序的 开发 Slack Workspace
  3. 选择 创建应用程序
  4. 基本信息下,复制以下 应用凭证 信息:
    • 客户端 ID
    • 客户端密码
  5. 导航到左侧边栏 功能 下的 OAuth 和权限
  6. 在范 围/机器人令牌范围下,选择 范围部分下的添加 OAuth 范围 磁贴,确保将作用域添加到机器人令牌,而不是用户令牌。添加这些范围: channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
  7. 重定向 URL下,对于以下每个回调,选择 添加新的重定向 URL,输入值,然后选择完成后 保存 URL
    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

安装 Slack 应用

将应用程序安装到 Slack 工作区以测试应用并生成与 Slack API 交互所需的令牌。

  1. 导航到左侧边栏的设置下的安装应用程序
  2. 选择将应用程序安装到 Workspace,确保允许该应用程序在渠道和对话中执行操作,然后选择允许
  3. 复制机 器人用户 OAuth 访问令牌

创建收藏夹通道并收集通道 ID

创建跟踪收藏夹的通道。您需要从该通道的 URL 中收集通道 ID 才能修改集成。

注意:

如果使用多个 Slack 集成,请为每个集成使用单独/专用的收藏通道。

  1. 在 Slack 中创建一个名为 收藏夹的新频道。
  2. 选择 添加 {slackWorkSpaceName} 的所有成
  3. 复制通道链接。将 ID 保存在 URL 末尾。这是修改终端节点和服务操作所需的通道 ID。请参阅 修改终端节点和服务操作

将机器人添加到焦点和最喜欢的频道

现在,将机器人(Slack 应用程序)添加到您想要向订阅该应用程序的团队和上面创建的喜爱频道公开的任何频道中。请注意以下事项:

  • 不要将机器人添加到嘈杂的通道中。应将机器人添加到用于在选定组内进行不经常、时间关键的通信的通道中,例如销售组的紧急销售问题或普通员工的 IT 安全。
  • 多个集成可以指向同一个 Slack 应用程序。
  • 让通道列表专注于特定群组。
  • 我们只建议将机器人添加到公共通道。向私人通道添加机器人可能会允许其他人查看私人通道的成员资格。

将集成添加到 Citrix Workspace 微应用

将 Slack 集成添加到 Citrix Workspace 微应用程序以连接到应用程序。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。这将提供带有预先配置的通知和操作的开箱即用微应用,这些通知和操作可以在 Workspace 中使用。

请按照以下步骤进行操作:

  1. 微应用集成页面中,选择添加新集成从 Citrix 提供的模板添加新集成
  2. 选择 Slack 磁贴。
  3. 输入集成的集成名称
  4. 输入连接器参数
    • 输入实例 基本 URLhttps://slack.com/api
    • 图标 库中选择集成的图标,或将其保留为默认图标。

    连接参数

  5. 服务身份验证下,从身份验证方法菜单中选择持有者令牌并填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。
  6. 输入令牌。此值是您在创建机器人时收集的机器人用户 OAuth 访问令牌。请参阅 创建机器人

    身份验证

  7. 服务操作身份验证下,启用在操作中使用单独的用户身份验证开关。这将在维修操作级别进行身份验证。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。

    1. 从“身份验证方法”菜单中选择“OAuth 2.0”,然后完成身份验证详细信息。
    2. 授权类型流程菜单选择授权码
    3. 授权类型值输入 authorization_code回调 URL 已预填充。
    4. 令牌授权菜单中选择请求正文
    5. 令牌内容类型菜单中选择 URL 编码表单。 授权 URL 已预填充: https://slack.com/oauth/authorize令牌 URL 已预填充: https://slack.com/api/oauth.access
    6. 确保为范围输入以下内容: channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
    7. 输入您在 创建机器人 中获得的客户端 ID
    8. 输入您在创建机器人中获得的客户端密钥

    服务操作

  8. 启用请求速率限制开关,然后为每秒请求数输入 1
  9. 请求超时 字段中输入 120
  10. (可选)启用日志记录开关以保留 24 小时的日志记录以供支持。
  11. 选择保存

    请求率

微应用集成页面将打开,其中包含您添加的集成及其微应用。现在,通过按下一步骤中所述添加 channel 值来修改集成。

修改终端节点和服务操作

要完成此设置,您需要在 创建收藏夹通道并收集通道 ID 中收集的频道 ID 中添加 channel 值。修改 “最 喜欢的频 道” 端点以及 “ 收藏夹” 频道 和 “取 消收藏夹 ” 服务

替换数据加载端点

使用您的频道 ID 手动添加最喜欢的频道端点中的 channel 值。

  1. 微应用集成 页面中,选择 Slack 集成旁边的菜单,然后选择 编辑。此时将打开“数据加载”屏幕。如果您在配置屏幕中,请从左侧导航栏中选择数据加载
  2. 选择收藏的频道端点旁边的菜单,然后选择编辑,或选择端点的名称:收藏的频道

    喜欢的通道

  3. 编辑数据端点屏幕的完全同步下,在通道的值字段中输入通道 ID。
  4. 选择屏幕底部的应用并确认。

    通道值

替换维修操作变量

对于 “ 收藏夹” 频道 和 “取 消收藏夹 ” 服务操作,您必须为两个服务操作手动添加带有渠道 ID 的 channel 值两次。一次在操作执行下,一次在发布操作数据更新(可选) 下。

  1. 编辑集成配置时,从左侧导航栏中选择服务操作
  2. 选择需要编辑的其中一个服务操作旁边的菜单,然后选择编辑,或选择需要编辑的维修操作的名称。让我们从收藏通道开始。

    通道

  3. 操作序列 下的 编辑维修操作屏幕中,然后在 操作执行下,选择 BODY
  4. 通道的值字段中输入通道 ID。
  5. 发布操作数据更新(可选)下,再次在频道的值字段中输入 渠道ID。

    通道值

  6. 选择“保存”以完成。
  7. 现在对另一个维修操作重复此操作:取消收藏。将 channel 值与您的频道 ID 一起添加两次。一次在操作执行下,一次在发布操作数据更新(可选) 下。

有关 API 端点和表实体的更多详细信息,请参阅Slack 连接器规格

使用 Slack 微应用

现有的应用程序集成附带开箱即用的微应用。从这些微应用开始,并根据您的需求定制它们。

我最喜欢的通道:在收藏通道中接收活动通知。

通知或页面 用例工作流
通道列表页 提供收藏通道列表,并提供添加通道的选项。
通道详情页面 查看收藏通道的详细信息,包括过去的帖子。包括发布消息取消收藏通道的按钮选项。
消息详情页面 查看收藏通道的留言详细信息以及发件人的详细信息。包括竖起大拇指在 Slack 中查看回复的按钮选项。
发布消息页面 提供要撰写的表单和按钮将消息 发布 到收藏的通道。
添加频道详情页面 查看包括成员的通道的详细信息。包括 添加到收藏夹的按钮选项。
“添加频道列表” 页 提供可搜索的通道列表,并提供在通道详情页面上查看详细信息的选项。

发布到 Slack:在 Slack 中向选定的聚焦通道发布消息。

通知或页面 用例工作流
发布新消息页面 提供用于撰写和发布消息的表单。

设置我的 Slack 状态:设置您的松弛状态、创建提醒以及在设定的时间内启用请勿打扰

通知或页面 用例工作流
创建提醒页 提供用于设置提醒的表单。
暂停通知页 提供用于在设定时间内暂停通知的表单。
设置我的 Slack 状态页面 提供用于设置状态的表单,其中包含设置提醒请勿打扰选项。