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