# 消息网关配置

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

## 创建网关

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

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

创建后会得到一个地址：

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

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

## 投递消息

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

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

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

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

## 网关规则

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

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

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

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