🚀 即将上线
Webhook 配置与签名验证已就绪，事件自动推送正在接入中
- 每次事件触发，我们把 JSON 用 POST 推到你填的地址，请求头带
X-Nangua-Signature: t=<ts>,v1=<hmac> - 用你的 secret 做 HMAC-SHA256 验签，确认推送确实来自南瓜 GEO，不被伪造
- payload 形式：
{event:"aeo.batch.completed", brandId, timestamp, data:{…}} - 上线后你配的地址会在 GEO 事件发生时自动收到推送；同步支持转发到飞书 / 钉钉 / 企业微信群机器人
🔔 我们 POST 事件到你的服务器
每次事件触发 · 我们 POST JSON 到你的 URL · 用 secret 做 HMAC-SHA256 验签，防伪造
POST https://your-server.com/api/nangua/webhook
X-Nangua-Signature: t=1717660800,v1=8a3f…d21c
{
"event": "aeo.batch.completed",
"brandId": "yunling-flowers",
"timestamp": "2026-06-06T10:00:00+08:00",
"data": { "batchId": "b_8821", "rewritten": 12, "citationGain": 4 }
}可订阅事件（5 个类型）
创建 Webhook 时勾选你想接的事件
| 事件 | 事件标识 | 触发时机 |
|---|---|---|
| Wiki 页面创建 | wiki.page.created | 知识库新增一篇可被引用的页面 |
| Wiki 页面更新 | wiki.page.updated | 已有 Wiki 页面内容被修改 |
| Lint 问题发现 | lint.issue.detected | 内容体检发现可读性/结构问题 |
| AEO 批改写完成 | aeo.batch.completed | 一批内容的 AI 引用优化跑完 |
| 引用缺口告警 | citation.gap.alert | 检测到品牌在某平台被竞品反超 |
已配 Webhooks（3）
按品牌隔离 · 当前品牌「云岭鲜花·昆明」 · 上线后这里会列出真实推送状态
| 名称 | 接收地址 | 订阅事件 | 最近触发 | 状态 |
|---|---|---|---|---|
| 飞书运营群机器人 | https://open.feishu.cn/…/bot/v2/hook/a3f1 |
3 | 2026-06-06 09:42 | 启用 |
| 生产环境 ETL | https://data.yunling.cn/api/nangua/webhook |
5 | 2026-06-06 08:15 | 启用 |
| 钉钉告警（调试中） | https://oapi.dingtalk.com/robot/send?… |
2 | — | 已停用 |
🏷️
名称方便区分，例「生产环境 ETL」「飞书运营群机器人」，最多 64 字
🔗
接收地址你的服务器或群机器人地址，必须 HTTPS，裸域名会自动补全协议头
🔑
验签密钥（secret）创建时一次性显示，请立即复制保存，用于 HMAC-SHA256 验签
💡 接入提示
详细签名验证算法 + 完整 payload schema 见
/api-docs · Webhooks 章节。每个 Webhook 都可单独「发一条测试事件」校验连通，连续推送失败会记失败次数与最近错误，方便排查。