Skip to main content
每当记录被创建、更新或删除时,Twenty 会向您的 URL 发送 HTTP POST。 涵盖所有对象类型,包括自定义对象。

创建 Webhook

  1. 前往 设置 → APIs & Webhooks → Webhooks
  2. 单击 + 创建 Webhook
  3. 输入您的 Webhook URL(必须可公开访问)
  4. 单击 保存
Webhook 会立即激活并开始发送通知。

管理 Webhooks

编辑:点击该 Webhook → 更新 URL → 保存 删除:点击该 Webhook → 删除 → 确认

事件

Twenty 会针对以下事件类型发送 Webhook: 所有事件类型都会发送到您的 Webhook URL。 事件过滤可能会在未来的版本中添加。

负载格式

每个 Webhook 都会发送一个带有 JSON 正文的 HTTP POST:
请返回 2xx HTTP 状态(200-299)以确认已接收。 非 2xx 的响应将被记录为投递失败。

Webhook 验证

为了安全起见,Twenty 会对每个 Webhook 请求进行签名。 请验证签名以确保请求真实有效。

请求头

验证步骤

  1. X-Twenty-Webhook-Timestamp 获取时间戳
  2. 构造字符串:{timestamp}:{JSON payload}
  3. 使用您的 Webhook 密钥计算 HMAC SHA256
  4. X-Twenty-Webhook-Signature 进行比较

示例(Node.js)

Webhooks 与工作流

如需接收外部数据,请参见 设置 Webhook 触发器