Webhooks

Webhooks 让你能够在 KeepFlow 账户中发生事件时接收实时通知。

设置 Webhooks

在控制台的 Settings > Webhooks 中配置 webhook 端点。每个端点都会收到一个带有 JSON 负载的 POST 请求，用于描述该事件。

事件类型

• conversation.created —— 新对话已开始
• conversation.resolved —— 对话已解决
• identity.detected —— 检测到新的身份指纹
• data.processed —— 数据混淆作业已完成

负载结构

{
  "event": "conversation.created",
  "timestamp": "2026-03-15T10:30:00Z",
  "data": { ... }
}

验证

所有 webhook 负载都包含 X-KeepFlow-Signature 请求头。请使用你的 webhook 密钥验证该签名，以确保请求合法。