第三方系统对接指南：如何根据业务场景选择原生连接器、事件 Webhook 或 REST API？

1. Webhooks（事件驱动）

最常见的集成方式。注册一个 HTTPS 端点，当事件触发时 — 新入站消息、投递/已读回执、营销活动完成 — WAthink 会 POST 一个带签名的 JSON 负载。你的服务器验证签名后作出反应（推送到 CRM、触发工作流）。

反过来，入站 Webhook 允许外部系统把事件推送进 WAthink，以启动流程或发送消息。负载结构与签名校验见 Webhooks。

适用场景。你希望在事件发生时立即得到通知，无需轮询 — 它是 WAthink 与你的技术栈之间的响应式粘合剂。

2. 原生连接器（OAuth / API 密钥）

WAthink 内置第一方连接器，可在工作区设置中启用。每个连接器都以加密方式存储凭据，并通过平台自身的服务同步 — 无需直接访问数据库。

适用场景。该服务已被支持 — 只需点击几下即可连接，并让 WAthink 处理同步。

3. 用你的应用驱动 WAthink（REST API）

当你希望你的软件控制工作区 — 发送消息、同步联系人、启动营销活动 — 请使用带工作区密钥的 REST API。对于自定义门户、后端任务或移动应用，这是正确的选择。完整的端地图见 API 接口清单。

适用场景。你正在构建某个按自己的时间表作用于工作区的东西。

核对工作区集成范围

连接前核对当前工作区、套餐及所需权限；API 密钥和连接器授权只用于已确认的业务范围。先测试字段映射和响应，再到客户、订单或消息记录中确认实际结果。

事件投递与测试步骤见Webhooks；自有工作流联动见n8n 连接器。