用途:通过 Instantly.ai API v2 创建和管理 B2B 冷邮件外联活动,涵盖序列、线索导入与发信账户。接口基址为 https://api.instantly.ai/api/v2,认证使用 Authorization: Bearer $INSTANTLY_API_KEY,密钥存于环境变量 INSTANTLY_API_KEY,不得硬编码。限速为总计 10 req/sec,批量操作超过 1000 条线索时建议降至约 5 RPS;分页使用 cursor 的 starting_after 与响应中的 next_starting_after。
主要能力:流程为确认发信账户(/accounts,关注 daily_limit、stat_warmup_score)、创建活动(POST /campaigns,含 sequences 与 campaign_schedule)、上传线索(POST /leads/add,带 custom_variables)、校验线索与活动绑定,最后由用户激活(POST /campaigns/{id}/activate)。campaign_schedule 是含 schedules 数组的对象;步骤 type 为小写 email;主题与正文写在 variants 内;仅使用 sequences[0]。模板变量为驼峰(如 {{firstName}}),自定义变量以平铺键存放,引用写作 {{varName}} 而非 {{custom.varName}};变量须包在 HTML 元素内,否则 PATCH 时会被清理器丢弃。
更新限制:PATCH /campaigns/{id} 会整体替换 sequences 与 campaign_schedule,需先 GET 再改后整体提交。删除草稿活动会返回 400,可改名归档。v2 不支持 verify_emails、/emails/send-test、/leads/bulk-delete 等。时区白名单不接受 America/Vancouver 和 America/Los_Angeles,太平洋时间可用 America/Dawson。首个步骤 delay 不应设为 0,以免重复发送。
适用场景:需要自动化 B2B 冷邮件外联与线索管理的营销或增长工作流。限制:激活必须由用户手动执行,不应自动激活;部分端点与状态码行为以资料为准,未提供的功能与价格暂未提供。