Webhook 接收时

​

用 AI 创建

​

配置

​

如何设置

1. 新建工作流，选择 Webhook 接收时作为触发器。
2. 从触发器面板复制生成的 Webhook URL。
3. （推荐）点击生成 Token 启用 Bearer Token 鉴权，防止未授权的请求触发工作流。
4. 将 Webhook URL 配置到外部系统中。
5. 发送一个测试请求来验证连接。
6. 添加后续操作步骤。
7. 开启工作流。

​

测试 Webhook

# 不带鉴权
curl -X POST https://your-teable-instance.com/api/automation/webhook/xxx \
  -H "Content-Type: application/json" \
  -d '{"order_id": "12345", "status": "paid"}'

# 带 Bearer Token 鉴权
curl -X POST https://your-teable-instance.com/api/automation/webhook/xxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid", "amount": 299.00}'

# 发送包含数组的请求体
curl -X POST https://your-teable-instance.com/api/automation/webhook/xxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"event": "batch_update", "items": [{"id": "001", "name": "产品A"}, {"id": "002", "name": "产品B"}]}'

​

触发后可用的数据

{
  "order_id": "12345",
  "customer": "张三",
  "amount": 299.00,
  "items": ["产品A", "产品B"]
}

​

速率限制

​

适用场景

• 支付回调处理：接收来自 Stripe、PayPal 或支付宝的支付成功通知，自动更新订单表中对应记录的支付状态和支付时间。
• 代码部署通知：接收 GitHub 或 GitLab 的 Webhook 通知，当代码合并到主分支时自动在项目管理表中更新部署状态并通知团队。
• 网站表单接入：在自己的网站中嵌入表单，提交后通过 JavaScript 将表单数据 POST 到 Webhook URL，自动在 Teable 中创建记录。
• 物联网数据采集：接收来自 IoT 设备或网关的传感器数据，自动存入监控表，用于数据分析和异常告警。
• 跨系统数据同步：其他系统在数据变更时向 Webhook 发送通知，Teable 自动同步更新对应记录。

​

安全最佳实践

• 务必启用 Bearer Token 鉴权：公开的 Webhook URL 任何人都可以调用。启用 Token 后，只有携带正确 Authorization: Bearer <token> 头的请求才会被处理。
• 不要在 URL 中传递敏感数据：敏感信息应放在请求体中，而非 URL 参数中。
• 在外部系统中妥善保管 Token：将 Token 存储在环境变量或密钥管理系统中，不要硬编码在代码里。
• 使用 HTTPS：确保 Teable 实例使用 HTTPS，保证数据在传输过程中的安全。

​

注意事项

• Webhook 只接受 POST 方法。GET、PUT 等其他方法的请求会被拒绝。
• 请求体必须是合法的 JSON 格式，且 Content-Type 头设置为 application/json。
• 如果工作流处于关闭状态，收到的 Webhook 请求会被丢弃，不会排队等待。
• Webhook URL 在工作流删除后会失效。重新创建工作流会生成新的 URL。

​

相关文档

• 创建记录
• 更新记录
• HTTP 请求
• 循环执行