🚨 Alert Center 集成指南

把您的告警源（ANPR / 停车场 / 安防 / 任意 webhook）接入 Wabot Alert Center，自动通过 WA 文字 → WA 语音条 → 真打电话三层升级提醒到值班人员。

一、整体流程

客户告警源 → POST /alert/in → Wabot 服务器 ↓ L1: WA 文字消息（含一键确认链接） ↓ (30s 未确认) L2: WA 语音条 PTT（TTS 播报） ↓ (2 分钟未确认) L3: Twilio 真打电话（按 1 确认 / 按 2 转人工） ↓ (3 次未接) 升级到 #2 联系人，重跑 L1→L3 ↓ (全员失败) 老板 Telegram 兜底通报

二、Webhook 协议

请求

项	值
方法	`POST`
URL	`https://api.gowabot.com/license/v1/alert/in`
Header	`X-Alert-Token: <token>`（在超管后台 🎯 告警源拿）
Header	`Content-Type: application/json`

请求体

{
  "title":      "(必填) 告警标题，< 500 字",
  "body":       "(选填) 详情文本，< 5000 字",
  "severity":   "(选填) info | warn | critical （默认按源配置）",
  "dedup_key":  "(选填) 自定义去重 key；不传则按 source+title+body+payload hash",
  "payload":    "(选填) 任意 JSON 对象，< 30KB（保留原始数据）"
}

响应

{ "ok": true, "event_id": 123, "status": "open", "deduplicated": false }

⚠️ 限流规则
• 同 dedup_key 5 分钟内只触发一次（去重）
• 同客户每分钟最多 5 个事件，超出标记 throttled
• 月度 events_count_cap 超出时拒收（看 📊 配额 tab）

三、三个真实场景示例

场景 A · ANPR 黑名单车牌识别

curl -X POST https://api.gowabot.com/license/v1/alert/in \
  -H "X-Alert-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "🚗 黑名单车牌 6T1234",
    "body": "红色 SUV · 北门入口 · 14:32:18",
    "severity": "critical",
    "payload": {
      "plate": "6T1234",
      "camera": "north_gate",
      "confidence": 0.96,
      "image_url": "https://camera.local/snap/abc.jpg"
    }
  }'

场景 B · 停车场满位预警

curl -X POST https://api.gowabot.com/license/v1/alert/in \
  -H "X-Alert-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "🅿️ 满位预警",
    "body": "P1 楼层占用率 95%，仅余 5 位",
    "severity": "warn",
    "payload": { "lot": "P1", "occupancy": 0.95, "free": 5 }
  }'

场景 C · 安防入侵告警

curl -X POST https://api.gowabot.com/license/v1/alert/in \
  -H "X-Alert-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "🛡️ 入侵告警",
    "body": "后院 PIR 触发，昨日同时段无活动",
    "severity": "critical",
    "payload": { "sensor": "pir_yard", "zone": "back_yard" }
  }'

四、套餐与配额

套餐	WA 文字	WA 语音条 (L2)	真打电话 (L3)	月度 voice cap
basic	✅ 不限	—	5 min trial	5 min
pro ⭐	✅	✅	✅	50 min
enterprise	✅	✅	✅	500 min

超 80% 老板 Telegram 预警；超 100% 自动降级（跳过 voice 通道，仅发 WA 文字）。

五、确认 / 升级行为

联系人收到 WA 文字后，点击消息中的 👉 已收到请点击 链接 → 即刻关闭升级，回写 ack 状态
真打电话接通后按 1 → 同样 ack；按 2 → 转人工标记，仍升级

六、获取 webhook token

登录 admin.gowabot.com
进入 🎯 告警源 tab
点 + 新建告警源，选 license + kind（webhook/anpr/parking/security）
创建后点 ⚙️ 操作 ▾ → 📋 复制 curl 命令，粘贴到您的告警源系统

七、状态码

状态	含义
200 + status=open	已接收，dispatcher 启动升级
200 + deduplicated=true	5 分钟内重复，复用前一事件
200 + status=throttled	触发限流（>5/min 或月配额）
401 missing_token	X-Alert-Token header 缺失
403 invalid_token	token 无效或被禁用
403 license_inactive	客户激活码状态非 active
400 invalid_title	title 缺失或 >500 字

需要协助？[email protected]