## 📋 概述
此工作流通过将数据从 Google Sheets 同步到 Instantly 电子邮件营销活动，同时通过 n8n 数据表维护跟踪，实现潜在客户管理的自动化。它分批处理潜在客户以避免速率限制，并确保不会重复发送。
## ⚙️ 完整设置指南
### 1️⃣ 创建您的 Google Sheet
**选项 A：使用我们的模板（推荐）**
– 复制此包含测试数据的模板：Google Sheets 模板
– 点击文件 → 创建副本以创建您自己的版本
– 填入您的潜在客户数据
**选项 B：创建您自己的表格**
创建包含以下必需列的 Google Sheet：
– Firstname – 联系人的名字
– Email – 联系人的电子邮件地址
– Website – 公司网站 URL
– Company – 公司名称
– Title – 职位/职务
💡 **专业提示**：添加任意数量的潜在客户 – 工作流会自动处理分批！
### 2️⃣ 设置 n8n 数据表
工作流使用一个数据表来跟踪潜在客户及其同步状态。
**创建 “Leads” 数据表：**
– 在您的 n8n 工作流编辑器中，添加一个数据表节点
– 点击 “创建新数据表”
– 命名为：Leads
– 添加以下列：
| 列名 | 类型 | 用途 |
|——|——|——|
| Firstname | string | 联系人的名字 |
| Lastname | string | 联系人的姓氏 |
| email | string | 联系人的电子邮件（唯一标识符）|
| website | string | 公司网站 |
| company | string | 公司名称 |
| title | string | 职位 |
| campaign | string | 同步状态（例如 “start”, “added to instantly”）|
| focusarea | string | 从 Title 字段丰富的数据 |
– 点击保存
📌 **重要**：campaign 字段至关重要 – 它跟踪哪些潜在客户已同步以防止重复！
### 3️⃣ 连接您的 Google Sheets 账户
– 在 “Get row(s) in sheet” 节点中，点击 “创建新凭据”
– 选择 Google Sheets OAuth2 API
– 遵循 OAuth 流程：
– 使用您的 Google 账户登录
– 授予 n8n 访问您的表格的权限
– 从下拉菜单中选择您的电子表格
– 选择正确的表格名称（例如 “instantly leads”）
– 测试连接以验证其工作
### 4️⃣ 连接您的 Instantly 账户
– 前往 Instantly.ai 并登录
– 导航到设置 → API
– 复制您的 API 密钥
– 返回 n8n，打开 “Create a lead” 节点
– 点击 “创建新凭据”
– 选择 Instantly API
– 粘贴您的 API 密钥
**重要**：更新活动 ID：
– 当前 ID：100fa5a2-3ed0-4f12-967c-b2cc4a07c3e8（示例）
– 替换为您从 Instantly 获得的实际活动 ID
– 在 Instantly 中的活动 → 您的活动 → 设置中找到此信息
### 5️⃣ 配置数据表节点
您需要更新三个数据表节点以指向您新创建的 “Leads” 表：
**节点 1：”Get row(s)”**
– 操作：获取
– 数据表：选择 Leads
– 过滤器：campaign = “start”
– 这仅获取新的、未同步的潜在客户
**节点 2：”Update row(s)1″（顶部流程）**
– 操作：更新
– 数据表：选择 Leads
– 过滤器：通过 email 字段匹配
– 更新：将 focusarea 设置为 Title 值
– 这丰富潜在客户数据
**节点 3：”Update row(s)”（底部流程）**
– 操作：更新
– 数据表：选择 Leads
– 过滤器：通过 Email 字段匹配
– 更新：设置 campaign = “added to instantly”
– 这防止重复发送
### 6️⃣ 配置计划（可选）
工作流包含用于自动化的计划触发器：
– 默认：每小时运行一次
**自定义：**
– 点击 “Schedule Trigger” 节点
– 选择您的间隔：
– 每 30 分钟
– 每 2 小时
– 每天特定时间
– 自定义 cron 表达式
💡 **用于测试**：使用 “When clicking ‘Execute workflow'” 手动触发器代替！
## 🔄 工作原理
### 流程 1：数据传输（顶部路径）
此流程将潜在客户从 Google Sheets → n8n 数据表移动
手动触发器 → 获取 Google Sheets → 批量拆分（30）→ 更新数据表 → 循环
**逐步说明：**
1. 手动触发器 – 点击手动启动工作流
2. 获取表格行 – 从您的 Google Sheet 获取所有潜在客户
3. 循环项目 – 分成 30 个潜在客户的批次
4. 更新行 – 对于每个潜在客户：
– 通过电子邮件搜索数据表
– 更新或创建潜在客户记录
– 存储 Title → focusarea 用于丰富
5. 循环继续 – 处理下一批直到所有潜在客户传输完成
⚙️ **为什么一次 30 个？**
– 防止 API 超时
– 尊重速率限制
– 允许进度监控
– 可以在节点设置中调整
### 流程 2：Instantly 同步（底部路径）
此流程将合格的潜在客户从数据表 → Instantly 同步
计划触发器 → 获取数据表（已过滤）→ 单个循环 → 在 Instantly 中创建 → 更新状态
**逐步说明：**
1. 计划触发器 – 自动运行（默认每小时）
2. 获取行 – 查询数据表中 campaign = “start” 的潜在客户
– 仅获取新的、未同步的潜在客户
– 忽略已处理的潜在客户
3. 循环项目 – 一次处理一个潜在客户
4. 创建潜在客户 – 将潜在客户发送到 Instantly：
– 活动：”Launchday 1″
– 映射：Email、Firstname、Company、Website
– 添加到电子邮件序列
5. 更新行 – 更新数据表：
– 设置 campaign = “added to instantly”
– 防止下次运行时重复发送
6. 循环继续 – 下一个潜在客户直到所有处理完成
🔍 **为什么一次一个？**
– Instantly API 最适合单个请求
– 确保准确的状态跟踪
– 防止部分失败
– 每个潜在客户更好的错误处理
## ✅ 关键功能说明
### 批量处理
– 一次处理 30 个 Google Sheet 潜在客户
– 可在 Loop Over Items 节点中配置
– 防止大型数据集超时
### 重复预防
– 使用 campaign 字段作为状态跟踪器
– 仅同步 campaign = “start” 的潜在客户
– 同步后更新为 “added to instantly”
– 重新运行工作流不会创建重复项
### 数据丰富
– 将职位存储在 focusarea 字段中
– 以后可用于个性化
– 可扩展用于额外的丰富
### 双触发器系统
– 手动触发器：用于测试和一次性运行
– 计划触发器：用于自动每小时同步
– 两个触发器使用相同的逻辑
### 错误容忍度
– 单个潜在客户处理防止级联失败
– 一个失败的潜在客户不会停止整个批次
– 易于识别和修复有问题的记录
## 🧪 测试您的工作流
### 步骤 1：测试数据传输（流程 1）
– 在您的 Google Sheet 中添加 5 个测试潜在客户
– 点击手动触发器节点
– 点击 “执行节点”
– 检查您的 Leads 数据表 – 应该看到 5 个新行
– 验证 focusarea 字段具有来自 Title 列的数据
### 步骤 2：测试 Instantly 同步（流程 2）
– 在数据表中，确保至少有一个潜在客户 campaign = “start”
– 点击计划触发器节点
– 点击 “执行节点”（绕过计划进行测试）
– 检查 Instantly 仪表板 – 应该看到新的潜在客户
– 检查数据表 – campaign 应该更新为 “added to instantly”
### 步骤 3：测试重复预防
– 重新运行计划触发器
– Instantly 中不应创建新的潜在客户
– 数据表显示无更改（已标记为已同步）
## 🚨 故障排除
**问题：Google Sheets 未获取数据**
✅ 检查 OAuth 凭据是否有效
✅ 验证节点设置中的电子表格 ID
✅ 确保表格名称完全匹配
✅ 检查 Google Sheet 是否有数据
**问题：数据表未更新**
✅ 验证数据表存在且命名为 “Leads”
✅ 检查列名完全匹配（区分大小写）
✅ 确保 email 字段已填充（用于匹配）
**问题：Instantly 未收到潜在客户**
✅ 验证 Instantly API 密钥正确
✅ 将活动 ID 更新为您实际的活动
✅ 检查数据表中 campaign = “start”
✅ 验证电子邮件格式有效
**问题：工作流运行但无任何反应**
✅ 检查数据表中是否有 campaign = “start” 的潜在客户
✅ 验证循环节点未卡住（检查执行日志）
✅ 确保批次大小未设置为 0
## 💡 专业提示和最佳实践
**对于初学者：**
– 从小开始 – 首先使用 5-10 个潜在客户进行测试
– 使用手动触发器 – 测试完成前不要启用计划
– 检查每个节点 – 单独执行节点以调试
– 监控数据表 – 将其用作您的真相来源
– 保持备份 – 定期导出数据表
**对于优化：**
– 调整批次大小 – 对于大型数据集增加到 50-100
– 添加延迟 – 如果达到速率限制，插入 “Wait” 节点
– 在 Google Sheets 中过滤 – 仅获取新行（使用公式）
– 归档旧潜在客户 – 将已同步的潜在客户移动到单独的表
– 添加错误通知 – 为失败连接 Slack/电子邮件
**对于扩展：**
– 使用多个活动 – 添加活动选择逻辑
– 实施重试逻辑 – 添加 “IF” 节点以重试失败的同步
– 添加数据验证 – 在同步前检查电子邮件格式
– 记录一切 – 添加 “Set” 节点以跟踪执行详细信息
– 监控 API 使用情况 – 跟踪 Instantly API 配额
## 📊 预期结果
**设置后：**
✅ Google Sheets 已连接并获取数据
✅ 数据表已填充潜在客户信息
✅ Instantly 自动接收潜在客户
✅ 未发生重复发送
✅ 活动状态正确更新
**性能指标：**
– 100 个潜在客户 – 大约 5-10 秒处理
– 1000 个潜在客户 – 大约 15-20 秒处理
– Instantly API – 典型速度每秒 1 个潜在客户
– 计划运行 – 默认每小时一次
## 📬 需要帮助？
**定制服务：**
– 高级过滤和细分
– 多活动管理
– 自定义字段映射和丰富
– 用于实时同步的 Webhook 集成
– 错误处理和监控设置
– 扩展到每天 10K+ 潜在客户
**联系方式：**
📧 david@daexai.com
## 🎓 您将学到什么
通过设置此工作流，您将掌握：
✅ n8n 数据表 – 创建、查询和更新数据
✅ 批量处理 – 高效处理大型数据集
✅ API 集成 – 连接 Google Sheets 和 Instantly
✅ 工作流逻辑 – 构建复杂的多路径自动化
✅ 错误预防 – 实施重复检查
✅ 调度 – 使用触发器自动化工作流
祝您工作流编程愉快！🎉
评论(0)