Files
hermes-glass-ui-personal/server

Hermes Feishu Bridge

双向桥接服务:

  • POST /feishu/events:飞书事件回调。收到文本消息后后台调用 Hermes再发回飞书。
  • POST /feishu/notifyHermes 或内部系统主动通知飞书。必须带 Authorization: Bearer $FEISHU_NOTIFY_TOKENX-Hermes-Feishu-Token
  • GET /health:健康检查。

凭证

不要把 FEISHU_APP_SECRETHERMES_API_KEYFEISHU_NOTIFY_TOKEN 写入仓库。线上使用 /etc/hermes-feishu-bridge.env 或同等级别的部署密钥文件。

飞书后台配置

  1. 给自建应用开通消息相关权限,例如接收消息事件、获取与发送单聊/群组消息。
  2. 事件订阅里添加请求地址:https://hermes.kang-kang.com/feishu/events
  3. 如果启用事件加密,需要先给本服务补充解密支持;当前版本按明文事件回调处理。
  4. 建议配置 FEISHU_VERIFICATION_TOKEN,并保持和飞书后台一致。

主动通知示例

curl -X POST https://hermes.kang-kang.com/feishu/notify \
  -H "Authorization: Bearer $FEISHU_NOTIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"receive_id_type":"chat_id","receive_id":"oc_xxx","text":"任务完成"}'