在飞连管理后台的动态策略、管理员告警策略等功能模块中,您可以添加消息通知机器人用于接收 Slack 的消息通知。本文将为您介绍如何在飞连管理后台添加 Slack 机器人,使您可以通过 Slack 接收来自飞连的消息通知。
操作指引
在飞连内支持配置 Slack 应用或者频道用于接收飞连消息通知。
- 通过 Slack 应用接收消息通知。
该方式适用于飞连内的部门、员工信息来自 Slack 数据源的场景,飞连将通过 Slack 应用向指定员工推送消息通知。具体操作,请参见通过 Slack 应用接收消息通知。 - 通过 Slack 频道接收消息通知。
该方式无需关注企业员工信息的来源,只要您在 Slack 频道中添加应用并获取机器人的 WebHook,即可在飞连中添加相应的消息通知机器人,后续飞连将通过群机器人推送消息通知。具体操作,请参见通过 Slack 频道接收消息通知。
在 Slack 内创建应用
获取 Bot Token
- 登录 Slack API 平台。
- 在页面中部,单击 Create an App.
说明
如果您已经创建 Slack 应用,您可以使用现有应用,或者单击右上角 Create New App。
- 在 Create an app 对话框中,单击 From scratch。
- 在 Name app & choose workspace 对话框中,输入 App Name,并选择一个 workspace,然后单击 Create App。
页面会自动跳转到应用的设置页面。 - 在左侧导航栏,单击 OAuth & Permissions。
- 在 OAuth & Permissions 页面的 Scopes > Bot Token Scopes 区域中,添加 chat:write, user:read 以及 user:read.email 等三个 scopes。
- 在 OAuth & Permissions 页面的 OAuth Tokens for Your Workspace 区域中,单击 Install/Reinstall to Workspace。
- 安装完成后,复制 Bot User OAuth Token 用于 API 调用。
- 返回到 Slack Workspace,打开新创建的应用,并将应用程序添加到您希望它向其发送消息的频道。
说明
在选定的频道中,会有一条新消息提示您已经成功添加一个应用。
- 在频道页面,复制浏览器地址栏里链接上的频道 ID:
- CXXXXXXXXXX:代表频道。
- DXXXXXXXXXX:代表直接消息。
- 使用 Bot User OAuth Token 和频道 ID,您能够调用 API
chat:postMessage
,将消息发布到频道上https://api.slack.com/methods/chat.postMessage/test
。
获取 Webhook
- 登录 Slack API 平台。
- 在页面中部,单击 Create an App.
- 在 Create an app 对话框中,单击 From scratch。
说明
如果您已经创建 Slack 应用,您可以使用现有应用,或者单击右上角 Create New App。
- 在 Name app & choose workspace 对话框中,输入 App Name,并选择一个 workspace,然后单击 Create App。
页面会自动跳转到应用设置页面。 - 在应用设置页面的左侧导航栏,单击 Incoming Webhooks。
- 在 Incoming Webhooks 页面,开启 Activate Incoming Webhooks,并在页面底部,单击 Add New Webhook to Workspace,并选择一个应用发布频道。
说明
在选定的频道中,会有一条新消息提示您已经成功添加一个应用: added an integration to this channel:
- 返回 Incoming Webhooks 页面,在 Webhook URL 字段,单击 Copy 复制 webhook URL。
- 将 webhook URL 粘贴在 Sample curl request to post to a channel 字段中。
通过 Slack 应用接收消息通知
登录飞连管理后台。
在左侧导航栏,选择通用配置 > 通知配置。
在消息通知页面,单击第三方 IM 页签。
在页面右上角,单击新建机器人。
在新建机器人对话框,完成以下配置,并单击确定。
配置项 | 说明 |
---|
第三方 IM | 选择 Slack。 |
通知方式 | 选择应用。 |
名称 | 自定义名称,用于标识当前的消息通知机器人。 |
描述 | 自定义描述,可选填写。 |
Bot Token | 填写 Slack 应用的 Bot Token。 |
在第三方 IM 页签的通知模板区域,单击任一模板右侧的测试。
页面会弹出测试机器人对话框。
在测试机器人对话框,在发送机器人字段选择刚创建的 Slack 机器人,并在测试对象字段填入测试对象。
单击确定后,您可以在指定的 Slack 应用中接收到消息通知。
通过 Slack 频道接收消息通知
登录飞连管理后台。
在左侧导航栏,选择通用配置 > 通知配置。
在消息通知页面,单击第三方 IM 页签。
在页面右上角,单击新建机器人。
在新建机器人对话框,完成以下配置,并单击确定。
配置项 | 说明 |
---|
第三方 IM | 选择 Slack。 |
通知方式 | 选择 WebHook。 |
名称 | 自定义名称,用于标识当前的消息通知机器人。 |
描述 | 自定义描述,可选填写。 |
WebHook | 群机器人对应的 WebHook 地址。 |
在第三方 IM 页签的通知模板区域,单击任一模板右侧的测试,设置 Slack 消息通知机器人以及测试对象,进行消息通知测试。
在测试机器人对话框,在发送机器人字段选择刚创建的 Slack 机器人。
单击确定后,您可以在指定的 Slack 频道中接收到消息通知。