Webhook Notifier

當 EmDash CMS 中的內容變更時,送出對外的 Webhook 通知。

外掛

Webhook Notifier

當 EmDash CMS 中的內容變更時,送出對外的 Webhook 通知。

  • 分類: 自動化
  • 狀態: 可用
  • 版本: 測試版內建
  • 價格: 測試版內建

產品詳情

分類
自動化
狀態
可用
版本
測試版內建

Webhook Notifier 讓 EmDash 在內容變更時對下游系統送出訊號——搜尋索引、聊天通知、CI 流水線或自訂審核工具。實作位於 packages/plugins/webhook-notifier

安裝

  1. 選擇使用 HTTPS 並驗證請求的接收端(共用密鑰、HMAC 簽章或 mTLS——依所使用外掛版本支援的方式)。
  2. 在管理後台啟用外掛,並在非正式專案中註冊第一個端點 URL。
  3. 觸發測試事件(例如儲存草稿),確認接收端記錄了預期的承載內容。

設定

常見設定包含:

  • 事件篩選 — 哪些集合或狀態轉換會觸發 webhook(create、update、publish、delete)。
  • 承載結構 — JSON 常含 id、slug、時間戳與操作者;請與該版文件化的 schema 核對。
  • 重試政策 — 接收端不可用時的指數回退與死信行為。

範例(概念): 索引服務可能預期如下 JSON 的 POST

{
  "event": "publish",
  "collection": "posts",
  "slug": "launch-notes",
  "url": "https://example.com/blog/launch-notes",
  "occurredAt": "2026-04-04T12:00:00.000Z"
}

將鍵名與 URL 換成實際發行版送出的內容——在依賴正式環境前以即時記錄驗證。

使用情境

  • 搜尋 — 通知 Algolia、Typesense 或內部索引服務重新擷取變更的 URL。
  • Slack 或 Teams — 高曝光頁面更新時向編輯發出輕量提醒。
  • 部署鉤子 — 內容發佈時觸發靜態重建或邊緣網路快取清除。

營運提示

  • 記錄投遞失敗,並在錯誤率持續偏高時發出警示。
  • 以與其他整合憑證相同的節奏輪換共用密鑰。
  • 避免無窮迴圈——別讓 webhook 處理常式在沒有冪等鍵的情況下寫回 EmDash 而再次觸發自己。