n8n

n8n 目前尚无 Warmbly 专用节点，但并不需要专用节点：HTTP Request（HTTP 请求）和 Webhook 节点即可支持双向连接，Warmbly 的所有端点都记录在 API 参考中。

建立连接

在设置 > API 密钥中创建限定权限范围的 API 密钥，仅授予工作流需要的权限：接入潜在客户需要联系人和营销活动权限，处理回复时再增加收件箱权限。在 n8n 中添加 Header Auth（请求头身份验证） 凭据，名称设为 Authorization，值设为 Bearer <your key>，并将其绑定到每个调用 Warmbly 的 HTTP Request 节点。

从 Warmbly 到 n8n

若要通过 Warmbly 事件启动工作流，添加 Webhook 节点，复制其生产环境 URL，然后选择以下任一方式：

• 将其注册为 Webhook 端点，订阅所需事件。投递使用 HMAC 签名，工作流可据此验证发送方。
• 在集成页面添加 n8n 连接，并在自动化流程中将其用作发送 Webhook 操作。这样便可在请求离开 Warmbly 之前先筛选或分支处理。

两种方式投递的 JSON 请求体相同，均包含投递 ID、事件类型和完整事件数据。

从 n8n 到 Warmbly

根据希望在哪里完成字段映射，可以选择两条路径。

在 n8n 中映射。 使用 HTTP Request 节点调用 POST /v1/contacts，提交联系人字段、标签（categories）和 campaigns。该操作按邮箱地址执行更新或插入，因此重新运行工作流会更新联系人，而不会创建重复记录。

在 Warmbly 中映射。 创建使用 传入 Webhook 触发器的自动化流程，复制其 URL，然后通过 HTTP Request 节点向该 URL 发送包含原始载荷的 POST 请求。自动化流程中的 创建或更新联系人 操作会使用模板（{{.email}}、{{.answers.company}}）将 JSON 键映射到联系人字段，为联系人添加标签并加入营销活动；同一流程还可以通知 Slack 或创建任务。参见潜在客户接入。此路径无需 API 密钥，URL 本身就是凭据。

潜在客户表单及其他来源

Facebook 或 Instagram 收到新表单提交时，n8n 的 Facebook Lead Ads Trigger（Facebook 潜在客户广告触发器） 节点会触发。LinkedIn Lead Gen Forms 和 TikTok Lead Generation 没有专用节点，可将其潜在客户通知 Webhook 指向 n8n 的 Webhook 节点。将任一来源接入上面的路径，广告表单中的回答就会转为带有标签、已加入营销活动的联系人，由你的邮箱继续跟进。跟进仍遵守每个邮箱的每日发送上限和间隔，因此突然涌入的潜在客户会排队处理，而不会一次性全部发送。

使用须知

• 发送遵守既定限制。 通过 API 发送邮件和回复时，均遵守各邮箱的每日上限和发送间隔。
• 速率限制按 API 密钥计算。大规模回填应使用导入端点，而不是每行发起一次请求。
• 若希望尽可能降低延迟，又不想托管接收 URL，可订阅开发者 WebSocket，代替 Webhook。