skill-instantly-campaign-launcher

通过 Instantly API v2 编程化创建 Instantly.ai 冷邮件营销活动，支持 D0/D3/D8 邮件序列，并批量导入潜在客户 —— 全程无需操作控制台界面，仅需运行一个脚本。

功能说明

1. 新建一个 Instantly 营销活动（若同名活动已存在，则直接复用）
2. 为该活动添加三步 D0/D3/D8 邮件序列
3. 从 JSON 文件批量导入潜在客户（自动去重/跳过已存在的客户）
4. 输出导入成功、跳过及失败的数量统计

适用场景

• 完全通过代码启动任意冷邮件营销活动（无需 UI 操作）
• B2B 代理机构或服务型企业的客户开发与外联
• 快速基于现有模板适配新 ICP（理想客户画像）或新行业

输入参数

• INSTANTLY_KEY — Instantly API v2 的 Bearer Token（需设为环境变量）
• scripts/campaign.config.js — 活动配置文件：包含活动名称、发送计划、D0/D3/D8 各阶段邮件正文
• leads.json — 潜在客户数据数组，每个对象格式为：{email, firstName, lastName, companyName, website}

输出结果

• 成功创建（或定位到已有）Instantly 营销活动，并绑定对应邮件序列
• 完成潜在客户批量导入；终端输出统计报告：总数 / 成功导入数 / 跳过数 / 失败数

脚本文件

• scripts/campaign-launcher.js — 主程序入口
• scripts/campaign.config.js — 配置模板（运行前需编辑）

使用方法

# 1. 在 app.instantly.ai → Settings → API Keys 页面获取 Instantly API v2 Token
export INSTANTLY_KEY=your_token_here

# 2. 编辑 scripts/campaign.config.js — 设置活动名称、发送计划、邮件文案
# 3. 创建 leads.json 文件（含潜在客户对象数组）
# 4. 执行：
node scripts/campaign-launcher.js --config scripts/campaign.config.js --leads leads.json

leads.json 格式示例

[
  { "email": "john@example.com", "firstName": "John", "lastName": "Smith", "companyName": "Acme Inc", "website": "acme.com" },
  { "email": "jane@corp.io", "firstName": "Jane", "companyName": "Corp IO" }
]

campaign.config.js 格式示例

module.exports = {
  campaignName: 'My Outreach Campaign',
  schedule: {
    name: 'Business Hours',
    timing: { from: '09:00', to: '17:00' },
    days: { monday: true, tuesday: true, wednesday: true, thursday: true, friday: true, saturday: false, sunday: false },
    timezone: 'America/New_York', // 或 Asia/Dubai、Europe/London 等时区
  },
  sequences: [
    { step: 1, delay: 0, subject: 'Your subject', body: 'Hi {{firstName}}, ...' },
    { step: 2, delay: 3, subject: 'Re: Your subject', body: 'Follow-up body...' },
    { step: 3, delay: 8, subject: 'Last note, {{firstName}}', body: 'Closing body...' },
  ],
};

注意事项

• Instantly API v2 序列接口地址：POST /campaigns/:id/sequences
• 去重机制：返回 HTTP 409 表示该潜在客户已在活动中存在（计入“跳过”统计，不视为错误）
• 限流处理：两次潜在客户导入请求之间插入 200ms 延迟，避免触发 HTTP 429 错误
• 已知问题：Instantly API v2 /sequences 接口偶发返回 404 —— 若发生此情况，请手动在控制台中添加序列
• Instantly 免费版支持无限数量的营销活动；建议在正式启用前对收件箱进行预热（inbox warming）