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 从而再次触发自身。