Skip to content
Intally

快速开始

快速开始

Smart Alerting Hub 是 WHMCS 的统一通知中枢：把 26 种发票/工单/订单/服务/客户/网络/管理事件路由到 Email、Slack、Telegram、Discord、WhatsApp、短信、PagerDuty、自定义 Webhook，全部从一个仪表盘管理。本指南覆盖安装、第一条告警、Pro 功能（模板/值班/去重/摘要）。

适用对象：WHMCS 主机商或 MSP。任何 WHMCS 站点都可启用，无业务侵入。

1. 安装与启用

  1. 下载与 PHP 版本匹配的 ZIP（如 smart_alerting_hub_v1.x.x_php8.1.zip）解压到 WHMCS 根目录。
  2. WHMCS 后台：Setup → Apps & Integrations → Smart Alerting Hub → Activate。
  3. Configuration → Addon Modules → Smart Alerting Hub → 勾选允许访问的 admin 角色（推荐 Full Administrator）+ 粘贴 license key（仅 Pro 功能需要）+ 保存。
  4. 顶部菜单 Addons → Smart Alerting Hub 进入控制台。

激活会自动创建 6 张表（settings / channels / rules / templates / oncall / alerts），以及若干 hooks（监听 26 种 WHMCS 事件）。

2. 仪表盘

仪表盘看到：

  • 今日告警计数（总计 / 已发送 / 失败）
  • 启用渠道列表（含健康状态）
  • 最近 10 条告警
  • License tier 与功能矩阵（free vs pro）
  • 检查更新面板

顶部 tab 切换到「渠道」/「模板」/「值班」/「历史」/「设置」。

3. 配置第一条告警渠道

「渠道」（Channels）页 → 「新建渠道」：

  1. 选择类型：Email / Slack / Telegram / Discord / WhatsApp / SMS / PagerDuty / 自定义 Webhook。
  2. 填配置参数（不同类型字段不同）： - Email：收件人地址（多个用逗号分隔） - Slack：incoming webhook URL - Telegram：bot token + chat ID - PagerDuty：integration key - 自定义 Webhook：URL + 可选 HTTP headers
  3. 选择订阅的事件类型（26 种）。
  4. 保存 → 点「测试」按钮验证连通性。

免费版可启用 Email + 1 个额外渠道（Slack 或 Telegram）；Pro 版解锁全部 8 类。

4. 消息模板（Pro）

「模板」（Templates）页可自定义告警消息格式：

  • 默认模板：按事件类型预置（开箱即用）
  • 按渠道覆盖：同一事件，Slack 可以发结构化卡片，邮件发完整 HTML
  • 按事件覆盖：发票逾期 vs 服务过期可以用不同措辞

模板支持变量插值（如 {client_name} / {invoice_id} / {amount}），保存后下一次告警生效。

5. 值班轮值（Pro）

「值班」（On-Call）页：

  1. 新建排班 → 选择负责的渠道 + 事件类型 + 轮值人员。
  2. 设定每周循环（周一 9:00 → 周三 18:00 = 张三 / 周四 9:00 → 周日 18:00 = 李四）。
  3. 启用即生效：触发告警时自动按当前值班人员选目标渠道。

6. 历史与重发

「历史」（History）页列出全部告警（默认保留 7 天，Pro 可配置至 90 天）：

  • 按时间 / 状态 / 事件类型 / 渠道筛选
  • 点「重试」可手动重发失败告警
  • CSV 导出便于审计

7. 设置（Pro）

「设置」（Settings）页：

  • 告警去重冷却：同一事件 X 分钟内只发 1 次（避免噪音）
  • 静默窗口：维护时段（如周日 02:00-06:00）暂停所有告警
  • 告警摘要：每小时或每天批量发送（适合非紧急事件）
  • 历史保留天数：默认 7 天，Pro 最长 90 天

8. 常见问题

Q：免费版能用什么？ A：Email + 1 个额外渠道（Slack 或 Telegram）+ 26 种事件 + 7 天历史 + 每日 100 条告警上限。其他全部需要 Pro。

Q：哪些事件类型支持？ A：发票（创建/支付/逾期）、工单（开立/回复/关闭）、订单（提交/接受/拒绝）、服务（开通/暂停/终止）、客户（注册/登录/欺诈检测）、网络（监控异常）、管理（管理员登录/配置变更）共 26 种。

Q：自定义 Webhook 接收到的 payload 是什么格式？ A：JSON：{event_type, timestamp, client_id, data: {...}}，data 字段按事件类型变化。

Q：会不会重复发送？ A：去重冷却（Pro）按 (event_type + 关键 ID) 做唯一键；非 Pro 用户建议在接收端去重。

更多深入文档（事件参数清单、模板变量参考、Hook 触发时序）见商城内的「完整文档」。