Skip to main content
MoleSignal 当前提供三种 Webhook 连接器:Slack Webhook、飞书 Webhook 和通用 JSON Webhook。 在设置 → 通知管理 → 企业连接器中创建。 如果还需要绑定用户、创建策略、配置兜底路由或查看投递历史,请先阅读 通知渠道与投递

Webhook 类型对比

fixed_group 使用连接器中配置的 URL。webhook 要求目标值为绝对 URL,并用目标值覆盖本次投递的已配置 URL。

Slack Webhook

配置 Incoming Webhook 地址和 1 到 60 秒的超时:
MoleSignal 会拼接消息标题与 Markdown 正文,并发送:
2xx HTTP 响应表示成功;其他响应或超时都会将投递标记为失败。

飞书 Webhook

配置飞书自定义机器人地址。只有机器人启用签名校验时才需要填写签名密钥:
不填写签名密钥时,MoleSignal 发送:
填写签名密钥后,MoleSignal 生成秒级 Unix 时间戳,拼接 timestamp + "\n" + secret,使用该值作为 HMAC-SHA256 Key 对空消息计算签名,再对结果做 Base64 编码。请求中会增加:
飞书投递不仅要求 HTTP 状态成功,还要求响应中的 codestatus_code 为零。
保持 MoleSignal 服务器时间同步。飞书会拒绝过期的签名请求。

通用 Webhook

配置默认地址、方法、Header 和超时:
方法可以是 postputpatch。Header 名称和值必须符合 HTTP 语法。MoleSignal 发送以下 Envelope:
任意 2xx 响应都表示成功。响应包含 X-Request-ID 时,MoleSignal 会把 Header 值记录为服务商消息 ID。

通过 API 创建和测试

创建通用 Webhook 连接器:
保存返回的连接器 id,再发送测试:
列出、读取、创建和更新连接器时,API 都会把敏感配置返回为 ***。更新已有连接器时,原样提交 *** 即可保留已保存的密钥。

安全与限制

  • MoleSignal 会加密保存完整连接器配置;
  • API 响应会掩码 urlwebhook_urlheaderssecret、Token 和密码;
  • 即使没有单独配置密钥,也要把 Webhook URL 当作凭证;
  • 优先使用 https,只在可信网络内使用 http
  • 将 MoleSignal 的出向访问限制到连接器确实需要的目标;
  • 已停用的连接器不能发送测试或通知。
当前连接器注册表没有原生钉钉或企业微信 Adapter。只有对端能接收 MoleSignal Envelope 时,才能直接 使用通用 Webhook;否则请在服务商端点前增加转换 Relay。
最后修改于 2026年8月4日