goodBaby/docs/gateway-config.md

消息网关配置

消息网关让外部系统来触发 goodBaby 的动作：为网关生成一个 Webhook 地址， 外部系统往这个地址 POST 一条消息，绑定在该网关上的「网关规则」就会被执行。

创建网关

在 WebUI 的「消息网关」页面点击「新建网关」：

字段	说明
网关类型	目前只有 webhook，新类型由 internal/gateway 注册后自动出现在这里
网关名称	便于识别的名字，例如「生产环境告警」

创建后会得到一个地址：

https://<你的域名>/api/v1/gateways/gw_xxxxxxxx/webhook

Token 由服务端随机生成，无法在页面上修改；删除网关会连同它的网关规则一起删除。

投递消息

curl -X POST https://<你的域名>/api/v1/gateways/gw_xxxxxxxx/webhook \
  -H 'Content-Type: application/json' \
  -d '{"title": "数据库告警", "message": "主库连接数超过 90%"}'

字段	必填	说明
message	是	消息正文，会覆盖网关规则配置里的消息字段
title	否	消息标题，规则配置里存在 title 字段时会被替换

响应里会给出本次触发的规则总数与失败明细：

{ "code": 200, "data": { "total": 2, "failed": ["发送邮件: 连接 SMTP 服务器失败"] } }

网关规则

网关规则在「网关规则」页面维护，和定时器规则是两张表、两个页面，互不影响。 只需配置「发给谁」这类固定信息：名称 / 类型 / 关联账号 / 类型专属配置 / 启用。

消息标题与内容不用在规则里预先写：邮件标题、邮件正文、QQ 消息内容、钉钉标题与内容、 B 站动态与私信内容、饭碗警告内容这些字段在「网关规则」页面上不会让用户填写 （页面上只显示一行提示），投递时统一由请求里的 title / message 填充。

没有消息字段的规则（例如「公开 GitHub 仓库」「删除阿里云 DNS 记录」）也能挂到网关上， 这类规则固定按自己的配置执行，投递的消息只起到触发器的作用。

规则编辑页的「测试」按钮会用一条示例消息走一次真实的投递覆盖， 方便你在执行日志里确认最终发出的内容。