Merchant tools 接入文档Markdown 原文

Hermes 接入 IM 通知

先阅读通用通知接入。使用 Hermes 已配置的 IM 通道,不需要让 Premsir 知道 IM 的账号和密钥。

配置步骤

  1. 检查当前安装版本的 hermes webhook subscribe --help 与 gateway 的 webhook 配置。
  2. 创建专门的 Premsir 路由,选择用户确认的 IM 和会话,设置路由级 deliver_only: true,消息模板为 {text}。不能只在请求 JSON 里塞一个 deliver_only 字段并假定接收端会遵守。
  3. 将该路由的公网 HTTPS URL、对应 HMAC secret 及事件类型交给 set_notification_subscription
  4. 调用 test_notification_subscription,确认 IM 收到测试通知,且 Hermes 没有启动 Agent 处理。

命令结构示例(各参数先替换成实际配置):

hermes webhook subscribe premsir-notifications \
  --deliver '<IM_TYPE>' \
  --deliver-chat-id '<CHAT_ID>' \
  --deliver-only \
  --prompt '{text}' \
  --description 'Premsir 订单和客户消息通知'

路由收到通用事件后,用 {text} 模板直接投递。使用 Hermes 支持的 X-Hub-Signature-256 验签及 X-Request-ID 去重。不要关闭认证。不同版本的命令或目标字段可能变化,以安装版本的帮助和官方文档为准。

依据

核对日期:2026-09-10。Hermes 官方 Webhook 文档明确区分 Agent 处理与直接投递模式。本文使用通用 Premsir 订阅,不要求旧的 Hermes 专属配对接口。