# Hermes 接入 IM 通知

先阅读[通用通知接入](./notifications.html)。使用 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 处理。

命令结构示例（各参数先替换成实际配置）：

```bash
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 文档](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/webhooks/)明确区分 Agent 处理与直接投递模式。本文使用通用 Premsir 订阅，不要求旧的 Hermes 专属配对接口。