n8n 连接器配置指南：使用自备 n8n 实例接收 WAthink 事件并编排跨系统 API 自动化工作流

连接器是什么

n8n 连接器将 WAthink 与你自己的 n8n 实例相连，让你在两端之间实现自动化。WAthink 不捆绑也不托管 n8n — 由你自备（自托管或 n8n Cloud）— 连接器基于 WAthink 已有的基础设施把两者接起来。

自备 n8n。连接器从不运行托管式的按租户编辑器。它只是指向你已在运行的 n8n，因此无需额外授权费用。

工作原理

这条链路有两个方向：

• 触发（WAthink → n8n）。你的 n8n Webhook 节点订阅 WAthink 事件。连接器管理一个指向该节点 URL 的出站 webhook，复用 WAthink 现有的投递管线 — HMAC 签名、重试与投递日志。
• 动作（n8n → WAthink）。你的 n8n 工作流使用工作区 API key 调用 WAthink 的 REST API，以发送消息、创建联系人等。

它复用 webhook 引擎。连接器与出站 webhook 受同一个套餐功能限制，因为它运行的正是这套基础设施 — 没有引入新的投递引擎。

连接你的 n8n

1. 在 n8n 中构建工作流，以 Webhook 触发节点开头，并复制该节点的 webhook URL。
2. 在 WAthink 中打开 n8n 页面 — More → n8n（需要工作区 admin 角色）。
3. 粘贴 n8n URL 并勾选要发送的事件。新连接会预选 message_received、message_sent 和 contact_created。
4. 保存。WAthink 会为该工作区存储一行指向你的 n8n 节点的 webhook 记录，并生成签名密钥。此后，你所选的事件都会投递到你的工作流。

从 WAthink 触发 n8n 工作流

连接后，每个已订阅事件发生时都会向你的 n8n Webhook 节点发送一个 POST — 新的入站消息、出站消息、新联系人，以及你从目录中勾选的任何其它事件。每个负载都用连接密钥进行 HMAC 签名，因此你的 n8n 端可以验证请求确实来自 WAthink；失败的投递会重试并记录在投递日志中。

只发送已知事件。WAthink 只保留其目录中存在的事件；未知值会被丢弃，并且你必须至少选择一个事件才能保存连接。

从 n8n 调用 WAthink

对于反方向，你的 n8n 工作流向 WAthink 的 REST API 发起 HTTP 请求。n8n 页面会显示 API base URL — https://your-domain.com/api/v1 — 以及你的工作区是否已有 API key。

• 获取 API key。密钥在 Developers 页面生成；n8n 页面有链接指向那里。在你的 n8n HTTP Request 节点中将其作为工作区密钥发送。
• 做 API 允许的任何事 — 发送消息、添加联系人等等 — 这样 n8n 工作流可以响应任何触发（包括它自身的触发）反过来操作 WAthink。

编辑器链接

你可以在连接器页面保存你自己的 n8n 编辑器 URL，方便从 WAthink 内快速访问。它只是每个工作区的便捷链接 — 留空即可清除。WAthink 从不嵌入托管式的按租户编辑器。

测试与断开连接

• 测试。使用测试按钮向已保存的 n8n URL 发送一个示例事件。WAthink 会报告 HTTP 状态码、延迟以及调用是否成功，让你在依赖它之前确认 Webhook 节点可达。
• 断开连接。断开连接会移除该工作区唯一的一行 n8n webhook 记录。事件立即停止流动；你的 n8n 工作流和任何 API key 不受影响。

故障排查