微应用

集成 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 工作区
  3. 选择 创建应用程序
  4. 基本信息下,复制以下 应用程序凭证 信息:
    • 客户端 ID
    • 客户端密码
  5. 导航到左侧边栏中 功能 下的 OAuth 和权限
  6. 在 “范围/机器人令牌范围” 下,选择 “范围” 部分下的 “添加 OAuth 范围” 磁贴,确保将范围添加到 Bot 令牌,而不是您的用户令牌。 添加这些范围: 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. 选择 将应用安装到工作区,确保允许该应用 在频道和对话中执行操作,然后选择 许。
  3. 复制机 器人用户 OAuth 访问令牌

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

创建用于跟踪收藏夹的频道。您需要从此频道的 URL 中收集频道 ID 才能修改集成。

注意:

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

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

将 Bot 添加到焦点和最喜欢的频道

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

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

将集成添加到 Citrix Workspace 微应用

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

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

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

    连接参数

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

    身份验证

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

    1. 身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。
    2. 选择 授权类型流程菜单的授权码
    3. 授权类型值输入授权_code回调 URL 已预先填充。
    4. 令牌授权 菜单中选择 请求正 文。
    5. 令牌内容类型 菜单中选择 URL 编码表 单。 授权 URL 已预先填充:https://slack.com/oauth/authorize令牌 URL 已预先填充:https://slack.com/api/oauth.access
    6. 确保为 Scope 输入以下内容: 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 收集的频道 ID添加 channel 值。修改 “ 收藏夹频道 ” 端点以及 “收 藏夹” 频道 和 “取 消收藏 ” 服务操作。

替换数据加载端点

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

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

    喜欢的频道

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

    渠道价值

替换维修操作变量

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

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

    通道

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

    渠道价值

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

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

使用 Slack 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。

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

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

发布到 Slack:在 slack 中向选定的焦点频道发布消息。

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

设置我的 Slack 状态:设置松弛状态,创建提醒,并在设定的时间内启用 “ 请勿打扰 ”。

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