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 觸發時序）見商城內的「完整文件」。