出站 Webhook

Skrum 是一体化的 AI 项目控制平台——团队聊天、任务与冲刺、原生视频会议、以及入站代码活动,全部集中在一个工作空间中,每一项 AI 操作都会等待人工确认后才会执行。

出站 webhook 用于分发事件通知。它是代码活动的出站对应功能——这里 Skrum 是事件源,第三方是接收方。

1. 创建。 设置 → 集成 → Webhooks → 新建。填写 URL、签名密钥(由 Skrum 生成,仅显示一次)以及订阅的事件类型(task.*、sprint.*、meeting.*、code.*、message.mention)。
2. 已签名的请求体。 每一次投递都会在原始请求体上附带一个 HMAC-SHA256 签名,可用你的签名密钥进行验证。
3. 重试机制。 非 2xx 响应会按指数退避重试,最多五次。具备 SSRF 防护——私有 IP 和元数据主机会被拒绝。

Slack / Teams

粘贴一个 Slack 或 Teams 的入站 webhook URL。Skrum 会识别其协议格式,组装一段有长度限制的纯文本内容并发送——采用与任何出站 URL 相同的 SSRF 校验机制。

常见问题

• 如何轮换密钥? 删除后重新创建;密钥仅显示一次。
• 可以查看投递历史吗? 每个 webhook 都会显示最近的投递记录,不可重试的错误会附带失败分类(ssrf_refused、signing_failed、http_4xx)。

另请参阅: Skrum 文档