You need to enable JavaScript to run this app.
导航

添加 Slack 机器人

最近更新时间2024.01.22 11:43:11

首次发布时间2024.01.22 11:43:11

在飞连管理后台的动态策略、管理员告警策略等功能模块中,您可以添加消息通知机器人用于接收 Slack 的消息通知。本文将为您介绍如何在飞连管理后台添加 Slack 机器人,使您可以通过 Slack 接收来自飞连的消息通知。

操作指引

在飞连内支持配置 Slack 应用或者频道用于接收飞连消息通知。

  • 通过 Slack 应用接收消息通知。
    该方式适用于飞连内的部门、员工信息来自 Slack 数据源的场景,飞连将通过 Slack 应用向指定员工推送消息通知。具体操作,请参见通过 Slack 应用接收消息通知
  • 通过 Slack 频道接收消息通知。
    该方式无需关注企业员工信息的来源,只要您在 Slack 频道中添加应用并获取机器人的 WebHook,即可在飞连中添加相应的消息通知机器人,后续飞连将通过群机器人推送消息通知。具体操作,请参见通过 Slack 频道接收消息通知

在 Slack 内创建应用

获取 Bot Token

  1. 登录 Slack API 平台
  2. 在页面中部,单击 Create an App.

    说明

    如果您已经创建 Slack 应用,您可以使用现有应用,或者单击右上角 Create New App

  3. Create an app 对话框中,单击 From scratch
  4. Name app & choose workspace 对话框中,输入 App Name,并选择一个 workspace,然后单击 Create App
    页面会自动跳转到应用的设置页面。
  5. 在左侧导航栏,单击 OAuth & Permissions。
  6. OAuth & Permissions 页面的 Scopes > Bot Token Scopes 区域中,添加 chat:write, user:read 以及 user:read.email 等三 scopes。
  7. OAuthPermissions 页面的 OAuth Tokens for Your Workspace 区域中,单击 Install/Reinstall to Workspace
  8. 安装完成后,复制 Bot User OAuth Token 用于 API 调用。
  9. 返回到 Slack Workspace,打开新创建的应用,并将应用程序添加到您希望它向其发送消息的频道。

    说明

    在选定的频道中,会有一条新消息提示您已经成功添加一个应用。

  10. 在频道页面,复制浏览器地址栏里链接上的频道 ID:
  • CXXXXXXXXXX:代表频道。
  • DXXXXXXXXXX:代表直接消息。
  1. 使用 Bot User OAuth Token 和频道 ID,您能够调用 API chat:postMessage,将消息发布到频道上https://api.slack.com/methods/chat.postMessage/test
    图片

获取 Webhook

  1. 登录 Slack API 平台
  2. 在页面中部,单击 Create an App.
  3. Create an app 对话框中,单击 From scratch

    说明

    如果您已经创建 Slack 应用,您可以使用现有应用,或者单击右上角 Create New App

  4. Name appchoose workspace 对话框中,输入 App Name,并选择一个 workspace,然后单击 Create App
    页面会自动跳转到应用设置页面。
  5. 在应用设置页面的左侧导航栏,单击 Incoming Webhooks
  6. Incoming Webhooks 页面,开启 Activate Incoming Webhooks,并在页面底部,单击 Add New Webhook to Workspace,并选择一个应用发布频道。

    说明

    在选定的频道中,会有一条新消息提示您已经成功添加一个应用: added an integration to this channel:

  7. 返回 Incoming Webhooks 页面,在 Webhook URL 字段,单击 Copy 复制 webhook URL。
  8. 将 webhook URL 粘贴在 Sample curl request to post to a channel 字段中。
    图片

通过 Slack 应用接收消息通知
  1. 登录飞连管理后台。

  2. 在左侧导航栏,选择通用配置通知配置

  3. 消息通知页面,单击第三方 IM 页签。

  4. 在页面右上角,单击新建机器人

  5. 新建机器人对话框,完成以下配置,并单击确定

    配置项

    说明

    第三方 IM

    选择 Slack

    通知方式

    选择应用

    名称

    自定义名称,用于标识当前的消息通知机器人。

    描述

    自定义描述,可选填写。

    Bot Token

    填写 Slack 应用的 Bot Token。

  6. 第三方 IM 页签的通知模板区域,单击任一模板右侧的测试。
    页面会弹出测试机器人对话框。

  7. 测试机器人对话框,在发送机器人字段选择刚创建的 Slack 机器人,并在测试对象字段填入测试对象。

  8. 单击确定后,您可以在指定的 Slack 应用中接收到消息通知。

通过 Slack 频道接收消息通知
  1. 登录飞连管理后台。

  2. 在左侧导航栏,选择通用配置通知配置

  3. 消息通知页面,单击第三方 IM 页签。

  4. 在页面右上角,单击新建机器人

  5. 新建机器人对话框,完成以下配置,并单击确定

    配置项

    说明

    第三方 IM

    选择 Slack

    通知方式

    选择 WebHook

    名称

    自定义名称,用于标识当前的消息通知机器人。

    描述

    自定义描述,可选填写。

    WebHook

    群机器人对应的 WebHook 地址。

  6. 第三方 IM 页签的通知模板区域,单击任一模板右侧的测试,设置 Slack 消息通知机器人以及测试对象,进行消息通知测试。

  7. 测试机器人对话框,在发送机器人字段选择刚创建的 Slack 机器人。

  8. 单击确定后,您可以在指定的 Slack 频道中接收到消息通知。