集成松弛
部署Slack集成,为关键通道提供额外的监控功能,这些通道可能不是流量密集的,但需要其成员的关注。为了为特定的组或部门定制可用的渠道,请使用多个集成。
注意:
我们需要你的反馈!请提供该集成模板的反馈当你使用它的时候。对于任何问题,我们的团队也会监督我们的专门的论坛每天都是这样。
有关Slack的开箱即用微应用程序的全面细节,请参见使用松弛.
检查先决条件
这些是您在Citrix Workspace Microapps中输入的值:
- 基URL:
https://slack.com/api
- 授权URL:
https://slack.com/oauth/authorize
- 标记的URL:
https://slack.com/api/oauth.access
- 通道标识:当你在Slack中创建一个新的收藏夹频道时,你会收集这个。您需要它来修改端点和服务操作。看到创建收藏夹通道并收集通道ID.
- OAuth访问令牌:你输入这个作为令牌设置集成模板时的值。您收集这个令牌、客户端ID和客户端秘密创建机器人.
- 客户机ID:客户端ID是表示授权服务器唯一的客户端注册信息的字符串。
- 客户的秘密:客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
注意:
建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。
创建一个新的服务帐户
集成需要定期访问您的Slack实例。我们建议创建一个具有完全管理员权限的专用用户帐户。在这里注册:https://slack.com/get-started#/create.
使api
可以向特定资源发出的API请求的数量是有限的。因此,我们建议如下:
- 每个链接的Slack API限制:https://api.slack.com/docs/rate-limits#overview
- Slack API层:https://api.slack.com/docs/rate-limits
- Slack API计划:只提供一个
创建机器人
机器人是Slack应用程序,可以与用户互动,能够发布、接收和回复用户的消息。创建Slack应用程序并选择要添加到应用程序的范围。
- 导航到Slack管理界面,如果你还没有创建一个应用程序,就创建一个应用程序:https://api.slack.com/apps
- 输入一个应用程序名称,并选择开发松弛工作区应用程序将被安装在哪里。
- 选择创建应用程序.
- 下基本信息,复制以下文件应用证书信息:
- 客户机ID
- 客户的秘密
- 导航到OAuth & Permissions下特性在左边栏。
- 下范围/Bot令牌范围中,选择添加OAuth作用域下面的瓷砖作用域部分,确保您向Bot令牌添加范围,而不是您的用户令牌。添加这些作用域:
通道:历史通道:加入通道:读组:历史组:读mpim:历史mpim:读团队:读用户。Profile:读用户:读用户:read.email
- 下重定向url,对于下面的每个回调,请选择添加新的重定向URL,输入后选择保存url当你完成的时候。
https:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext
https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调
安装Slack应用程序
将应用程序安装到您的Slack工作区以测试应用程序并生成与Slack API交互所需的令牌。
- 导航到安装应用程序下设置在左边栏。
- 选择将App安装到工作区,确保应用程序被允许在频道和对话中执行动作,并选择允许.
- 复制Bot用户OAuth访问令牌.
创建收藏夹通道并收集通道ID
创建一个跟踪收藏夹的通道。您需要从该通道的URL中收集Channel ID,以便修改集成。
注意:
如果使用多个Slack集成,请为每个集成使用单独/专用的收藏频道。
- 在Slack中创建一个名为最喜欢的.
- 选择添加{SlackWorkspaceName}的所有成员
- 复制通道链接。将ID保存在URL的末尾。这是修改端点和服务操作所需的Channel ID。看到修改端点和服务操作.
添加机器人的焦点和喜爱的频道
现在,将Bot (Slack应用程序)添加到您想要向订阅该应用程序的团队和上面创建的最喜欢的频道公开的任何频道。考虑以下几点:
- 不要在有噪声的信道中添加Bot。应该将机器人添加到用于特定组内不频繁的、时间紧迫的通信的通道中,例如销售组的紧急销售问题或普通员工的IT安全问题。
- 多个集成可以指向同一个Slack应用程序。
- 保持频道列表集中在一个特定的群体。
- 我们只建议将机器人添加到公共频道。将机器人添加到私有通道可以允许其他人查看私有通道的成员。
将集成添加到Citrix Workspace Microapps
将Slack集成添加到Citrix Workspace Microapps以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选中了这些选项。这提供了开箱即用的微应用程序,具有预先配置的通知和操作,可以在您的工作区中使用。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成而且从citrix提供的模板中添加新的集成.
- 选择Slack贴图。
- 输入一个集成的名字对于积分。
- 输入连接器参数.
- 输入实例基URL:
https://slack.com/api
- 选择一个图标从图标库集成,或保留此为默认图标。
- 输入实例基URL:
- 下服务认证中,选择不记名的令牌从身份验证方法菜单并完成身份验证详细信息。已预先选择身份验证选项。确保在完成流程时选中了这些选项。
进入令牌.此值是创建Bot时收集的Bot用户OAuth访问令牌。看到创建机器人.
下服务动作认证,启用在操作中使用独立用户身份验证切换。这在服务操作级别进行身份验证。已预先选择身份验证选项。确保在完成流程时选中了这些选项。
- 选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。
- 选择授权代码为Grant型流程菜单。
- 输入authorization_code为授权类型值.回调URL肾上腺素。
- 选择请求体从令牌授权菜单。
- 选择URL编码表单从令牌内容类型菜单。的授权URL肾上腺素:
https://slack.com/oauth/authorize
.的标记的URL肾上腺素:https://slack.com/api/oauth.access
. - 确保在Scope中输入以下内容:
通道:历史通道:加入通道:读组:历史组:读mpim:历史mpim:读团队:读用户。Profile:读用户:读用户:read.email
- 进入客户机ID你在创建机器人.
- 进入客户的秘密你在创建机器人.
- 启用请求速率限制切换并进入1为请求数每秒。
- 输入120在请求超时字段。
- (可选)使日志记录切换以保持24小时的日志记录用于支持目的。
选择保存.
的Microapp集成页面打开与您添加的集成及其微应用程序。现在修改集成,添加通道
下一个过程中所描述的值。
修改端点和服务操作
要完成此设置,需要添加通道
值与您的通道ID收集创建收藏夹通道并收集通道ID.修改最喜欢的频道端点和最喜欢的频道而且讨厌服务操作。
替换数据加载端点
手动添加通道
的价值最喜欢的频道端点与您的通道ID。
- 从Microapp集成页面,选择Slack集成旁边的菜单,然后编辑.的数据加载屏幕上打开。如果在配置界面,选择数据加载从左侧导航栏。
控件旁边的菜单最喜欢的频道端点,然后选择编辑,或选择端点的名称:最喜欢的频道.
- 在编辑数据端点屏幕,下完全同步在值字段中输入Channel ID通道.
选择应用在屏幕底部,并确认。
替换Service Action变量
为最喜欢的频道而且讨厌服务动作时,必须手动添加通道
为两个服务操作两次使用Channel ID。一次下行动的执行一旦在动作后数据更新(可选).
- 在编辑集成配置时,选择服务的行动从左侧导航栏。
选择需要编辑和选择的服务操作之一旁边的菜单编辑,或选择需要编辑的服务操作的名称。让我们从最喜欢的频道.
- 在编辑服务动作屏幕下动作序列然后在下面行动的执行中,选择身体.
- 在的值字段中输入Channel ID通道.
下动作后数据更新(可选),再次在值字段中输入Channel ID通道.
- 选择保存完成。
- 现在对另一个服务操作重复此操作:讨厌.添加
通道
值与您的通道ID两次。一次下行动的执行一旦在动作后数据更新(可选).
有关API端点和表实体的详细信息,请参见松弛接头规格.
使用Slack微应用
现有的应用集成带有开箱即用的微应用。从这些微应用程序开始,并根据您的需要定制它们。
我最喜欢的频道:接收收藏频道的活动通知。
通知或页面 | 用例的工作流 |
---|---|
渠道列表页面 | 提供收藏频道列表,并提供选项添加渠道. |
通道详情页面 | 查看收藏频道的详细信息,包括过去的帖子。包括按钮选项发布消息而且讨厌通道. |
详细信息页面 | 从收藏频道查看邮件详细信息,包括发件人的详细信息。包括按钮选项竖起大拇指而且在Slack中查看回复. |
发布消息页面 | 提供要组合和按钮扣到的表单帖子发送到喜爱频道的消息。 |
添加通道详细信息页面 | 查看通道的详细信息,包括成员。的按钮选项添加到收藏夹. |
添加频道列表页面 | 提供可搜索的通道列表,并提供在“通道详细信息”页面上查看详细信息的选项。 |
发布到Slack:在slack中向所选的重点频道发布消息。
通知或页面 | 用例的工作流 |
---|---|
发布新消息页面 | 提供用于撰写和发布消息的表单。 |
设置我的松弛状态:设置你的空闲状态,创建提醒,并启用请勿打扰在规定的时间内。
通知或页面 | 用例的工作流 |
---|---|
创建一个提醒页面 | 提供用于设置提醒的表单。 |
暂停通知页面 | 提供一个表单,在一段时间内暂停通知。 |
设置我的Slack状态页面 | 提供用于设置状态的表单,选项为设置提醒而且请勿打扰. |