视频讲解：

此处为语雀视频卡片，点击链接查看：如何进行告警推送设置（飞书）.mov

文字讲解：

一、选择对接群的版本

根据使用场景的不同，分为基础版和升级版2个版本。注意飞书移动端暂不支持此操作，请前往PC端设置。

  1. 基础版：只支持将告警消息推送到群内；
  2. 升级版：不仅支持将告警消息推送到飞书群内，还支持@指定人及时关注，直接在群内进行风险事件的处理（无需处理、已处理）。

二、新建基础版的告警群

步骤1：配置webhook地址

基础版的告警群只需要配置webhook地址，具体操作如下：

  1. 找到需告警消息推送的群，点击【...】>【设置】；
  2. 点击【群机器人】>【添加机器人】，选择添加【自定义机器人】；
  3. 确定机器人信息。点击【添加】，成功后会自动生成webhook地址，复制到质检后台的配置中；

注意：请妥善保管webhook地址，不要发布在如Gitlab、博客等其他公开查阅的网站上，避免地址泄露后可能被恶意调用发送垃圾信息的情况。

步骤2：查看是否存在机器人

三、新建升级版的告警群

注意：配置升级版的对接群时，我们会默认生成一个新的告警群聊，暂不支持已有群聊添加机器人。

步骤1：创建企业自建应用

登录飞书开放平台，在首页，先点击【创建应用】

点击【创建企业自建应用】，输入机器人的名称和描述，修改机器人的应用图标。再点击【创建】，创建成功后点击【添加机器人能力】。

步骤2：申请机器人的权限

选择【权限管理】 ，再选择【API权限】，搜索并勾选以下全部的权限：

  1. 搜索并勾选“contact:user.id:readonly”
  2. 搜索并勾选“im:chat”
  3. 搜索并勾选“im:chat.group_info:readonly”
  4. 搜索并勾选“im:message:send_as_bot”
  5. 搜索并勾选“im:chat:readonly”
  6. 搜索并勾选“im:chat:operate_as_owner”
  7. 搜索并勾选“im:chat:create”（最新更新）

最后点击有右上角的【批量开通（7）】按钮，再点击【确认】按钮。

步骤3：进行事件与回调

  • 首先点击【事件与回调】，再点击【事件配置】，在【配置订阅方式处】，点击【编辑icon】

  • 然后将以下这段【回调地址】，输入进去并保存

复制并输入该地址：https://xh-mc.xiaoduoai.com/api/v1/notify_robot/feishu_callback

  • 然后再选择【回调配置】，划到下方，找到最下方的【已订阅的回调】，然后点击右边的【添加回调】

  • 在回调中找到【消息卡片回传交付（旧）】并【确认添加】

  • 再而，选择【事件与回调】中的【加密策略】

  • 找到下方的【Encrypt Key】和【Verification Token】，点击【编辑icon】

  • 并且确保，这两处地方，都为【空值】，如下图；确定为【空值】之后，各点击【保存】

  • 保存成功之后，呈现的样子如下：

步骤4：申请线上发布

  • 点击顶部提示栏中的创建版本，输入版本号。同时选择可用范围为所有员工，点击【保存】并申请线上发布

步骤5：等待企业内部的管理员审核通过

  • 管理员会收到审核通知，选择进入管理后台审核>审核，点击通过，机器人上线成功

步骤6：获取App ID和APP Secret

  • 上线后，在【飞书开放平台】的【凭证与基础信息】查看App ID和APP Secret

注意：仔细核对群设置的所有修改均已发布，包括机器人的权限申请、回调地址等。否则，我们在质检系统进行规则配置时会容易出现飞书端口报错的400。

  • 并确认，【当前修改均已发布】。

  • 现在我们准备进入【明察质检】，进行告警群的设置。

步骤7：进行告警群的设置

  • 进入【明察质检】，点击左侧的【实时告警】>【店铺实时告警】
  • 再点击【告警信息通知店铺主管，前往设置】

点击【新建告警群】，在弹窗中选择IM的渠道为【飞书】>【升级版】

输入告警群的信息，点击【确认】按钮提示新建告警群成功。

其中，App ID和APP Secret为【步骤六】中所获取到的信息。

设置升级版每次是系统自动新建一个告警群，所以需要填写告警群的初始化群名称和群主手机号。注意告警群名称未与飞书群做绑定，仅首次创建名称用，后边修改不会同步，以AppSecret为唯一性判断。

步骤7：查看是否存在新的群和机器人

系统会自动新建一个告警群，群机器人已自动拉入，无需再次操作。