Webhook 允许外部服务通过向您的工作流发送 HTTP 请求来触发工作流的执行。Sim 支持两种基于 Webhook 的触发方式。
通用 Webhook 触发器
通用 Webhook 模块创建了一个灵活的端点，可以接收任何有效负载并触发您的工作流：
工作原理
- 添加通用 Webhook 模块 - 拖动通用 Webhook 模块以开始您的工作流
- 配置有效负载 - 设置预期的有效负载结构（可选）
- 获取 Webhook URL - 复制自动生成的唯一端点
- 外部集成 - 配置您的外部服务以向此 URL 发送 POST 请求
- 工作流执行 - 每次对 Webhook URL 的请求都会触发工作流
功能
- 灵活的有效负载：接受任何 JSON 格式的有效负载结构
- 自动解析：Webhook 数据会被自动解析并供后续模块使用
- 身份验证：支持可选的 Bearer Token 或自定义头部身份验证
- 速率限制：内置防滥用保护
- 去重功能：防止重复请求导致的重复执行
通用 Webhook 触发器每次接收到 Webhook URL 的请求时都会触发，非常适合实时集成。
服务模块的触发模式
或者，您可以使用特定的服务模块（如 Slack、GitHub 等）以“触发模式”创建更专业的 Webhook 端点：
设置触发模式
- 添加服务模块 - 选择一个服务模块（例如 Slack、GitHub、Airtable）
- 启用触发模式 - 在模块设置中切换“用作触发器”
- 配置服务 - 设置该服务的身份验证和事件过滤器
- Webhook 注册 - 服务会自动向外部平台注册 webhook
- 基于事件的执行 - 工作流仅针对该服务的特定事件触发
何时使用每种方法
在以下情况下使用通用 Webhook：
- 与自定义应用程序或服务集成
- 需要最大灵活性的有效负载结构
- 使用没有专用模块的服务
- 构建内部集成
在以下情况下使用触发模式：
- 使用支持的服务（如 Slack、GitHub 等）
- 需要服务特定的事件过滤
- 需要自动 webhook 注册
- 需要为该服务处理结构化数据
支持触发模式的服务
开发与项目管理
- GitHub - 问题、PR、推送、发布、工作流运行
- Jira - 问题事件、工作日志
- Linear - 问题、评论、项目、周期、标签
通信
- Slack - 消息、提及、反应
- Microsoft Teams - 聊天消息、频道通知
- Telegram - 机器人消息、命令
- WhatsApp - 消息事件
电子邮件
- Gmail - 新邮件（轮询）、标签更改
- Outlook - 新邮件（轮询）、文件夹事件
客户关系管理与销售
- HubSpot - 联系人、公司、交易、工单、对话
- Stripe - 支付、订阅、客户
表单与调查
- Typeform - 表单提交
- Google Forms - 表单响应
- Webflow - 集合项、表单提交
其他
- Airtable - 记录更改
- Twilio Voice - 来电、通话状态
安全性与最佳实践
身份验证选项
- Bearer Tokens: 包含
Authorization: Bearer <token>标头 - 自定义标头: 定义自定义身份验证标头
负载处理
- 验证: 验证传入的负载以防止数据格式错误
- 大小限制: Webhook 的负载大小有限制以确保安全
- 错误处理: 为无效请求配置错误响应
测试 Webhook
- 使用 Postman 或 curl 等工具测试您的 Webhook 端点
- 检查工作流执行日志以进行调试
- 验证负载结构是否符合您的预期
- 测试身份验证和错误场景
在处理工作流中的 Webhook 数据之前，请始终验证和清理传入的数据。
常见用例
实时通知
- Slack 消息触发自动响应
- 关键事件的电子邮件通知
CI/CD 集成
- GitHub 推送触发部署工作流
- 构建状态更新
- 自动化测试流水线
数据同步
- Airtable 更改更新其他系统
- 表单提交触发后续操作
- 电商订单处理
客户支持
- 支持工单创建工作流
- 自动升级流程
- 多渠道通信路由