0. 在飞书群组中创建机器人

根据飞书官方文档在群组中创建机器人

1. 获取飞书机器人 Webhook 和 Secret

feishu-webhook-secret

2. 加载飞书消息卡片模板

  • 打开飞书卡片搭建工具
  • 导入卡片,从这里下载feishu-card-template.cardfeishu-card-import
  • 发布卡片,默认发布时会指定版本为1.0.0 feishu-card-publish
  • 绑定卡片到webhook,填写上一步骤获取到的webhook,或者直接选择所有自定义机器人。 feishu-card-bind
  • 复制卡片 id feishu-card-id

3. 配置 EMQX-Guard-Pro

在 EMQX 的 etc 目录下创建一个 feishu.conf 文件。

feishu {
  enable = true
  // 如果不想使用 secret 验证(换用 IP 白名单),得保证 secret=""
  secret = "Your Webhook Secret"  
  template_id = "Your Template ID"  
  template_version_name = "1.0.0"
  webhook = "Your Webhook URL"
}

4. 加载配置

./bin/emqx_ctl guard load ./etc/feishu.conf
loaded feishu ok

5. 测试通知

./bin/emqx_ctl guard test

feishu-test-notification

6. 常见问题

  • 如果无法收到测试通知,请第一时间检查 EMQX 日志。
  • 请确保在步骤 5 中收到了 4 条信息。如果只收到 3 条, 丢失了 Alarm 信息,请检查 EMQX 的日志,如果提示模板没找到,则是模板可能只是导入了但是没有发布成功

7. 参考资料