创建 Webhook
- 前往 设置 → APIs & Webhooks → Webhooks
- 单击 + 创建 Webhook
- 输入您的 Webhook URL(必须可公开访问)
- 单击 保存
管理 Webhooks
编辑:点击该 Webhook → 更新 URL → 保存 删除:点击该 Webhook → 删除 → 确认事件
Twenty 会针对以下事件类型发送 Webhook:
所有事件类型都会发送到您的 Webhook URL。 事件过滤可能会在未来的版本中添加。
负载格式
每个 Webhook 都会发送一个带有 JSON 正文的 HTTP POST:请返回 2xx HTTP 状态(200-299)以确认已接收。 非 2xx 的响应将被记录为投递失败。
Webhook 验证
为了安全起见,Twenty 会对每个 Webhook 请求进行签名。 请验证签名以确保请求真实有效。请求头
验证步骤
- 从
X-Twenty-Webhook-Timestamp获取时间戳 - 构造字符串:
{timestamp}:{JSON payload} - 使用您的 Webhook 密钥计算 HMAC SHA256
- 与
X-Twenty-Webhook-Signature进行比较
示例(Node.js)
Webhooks 与工作流
如需接收外部数据,请参见 设置 Webhook 触发器。