Webhook Notifier
當 EmDash CMS 中的內容變更時,送出對外的 Webhook 通知。
外掛
Webhook Notifier
當 EmDash CMS 中的內容變更時,送出對外的 Webhook 通知。
產品詳情
- 分類
- 自動化
- 狀態
- 可用
- 版本
- 測試版內建
Webhook Notifier 讓 EmDash 在內容變更時對下游系統送出訊號——搜尋索引、聊天通知、CI 流水線或自訂審核工具。實作位於 packages/plugins/webhook-notifier。
安裝
- 選擇使用 HTTPS 並驗證請求的接收端(共用密鑰、HMAC 簽章或 mTLS——依所使用外掛版本支援的方式)。
- 在管理後台啟用外掛,並在非正式專案中註冊第一個端點 URL。
- 觸發測試事件(例如儲存草稿),確認接收端記錄了預期的承載內容。
設定
常見設定包含:
- 事件篩選 — 哪些集合或狀態轉換會觸發 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 而再次觸發自己。