MachFive 官方 API 文档型技能,将潜在客户数据转化为高转化率的个性化冷邮件序列,支持单条同步与批量异步生成。
说明:
## 核心用法
MachFive AI 冷邮件生成器通过官方 API 将潜在客户数据转化为个性化邮件序列,而非模板化内容。核心工作流包括:
1. **初始化配置**:设置 `MACHFIVE_API_KEY` 环境变量,从 https://app.machfive.io/settings 获取
2. **选择活动**:通过 `GET /api/v1/campaigns` 列出活动,用户指定 campaign_id 后执行生成
3. **单条生成(同步)**:`POST /campaigns/{id}/generate`,支持 3-5 封邮件序列,耗时 3-5 分钟,需设置 300-600 秒超时
4. **批量生成(异步)**:`POST /campaigns/{id}/generate-batch`,立即返回 202 状态,通过轮询 `GET /lists/{id}` 获取完成状态后导出
关键字段:`email` 为必需,其余如 `name`、`company`、`title`、`linkedin_url` 提升个性化效果。支持自定义 `email_count`(1-5)、签名、CTA 等选项。
## 显著优点
– **真个性化**:AI 实时研究潜在客户资料,生成非模板化内容,转化率显著高于传统模板邮件
– **灵活双模式**:同步单条适合即时预览,异步批量适合大规模外联,单批次可处理多条线索
– **完善恢复机制**:超时或中断后可通过 `list_id` 查询状态并导出结果,避免重复消耗 credits
– **T1 商业级可信度**:MachFive 为成熟商业实体,API 采用标准 HTTPS + Bearer Token,无本地代码执行风险
– **成本透明**:1 credit = 1 条线索,免费版 100 credits/月,付费计划灵活
## 潜在缺点与局限性
– **完全外部依赖**:所有功能依赖 MachFive 服务可用性,API 变更或宕机将直接影响使用
– **长耗时操作**:单条生成需 3-5 分钟,不适合实时交互场景;批量任务需轮询等待
– **数据隐私考量**:需向第三方发送潜在客户个人信息(邮箱、LinkedIn、公司等),需符合 GDPR/CCPA 合规要求
– **并发限制**:工作空间存在并发批量任务上限,超额返回 429 错误需重试
– **无离线能力**:纯 API 驱动,网络不稳定时无法使用
## 适合人群
– B2B 销售团队需规模化个性化外联
– 市场营销人员执行 ABM(账户营销)活动
– 创业者/自由职业者进行种子用户拓展
– 需替代手动撰写冷邮件、提升回复率的专业人士
## 常规风险
– **API 密钥泄露**:`MACHFIVE_API_KEY` 需妥善保管,建议存于安全环境变量,定期轮换
– **邮件送达风险**:AI 生成内容仍需遵守反垃圾邮件法规(CAN-SPAM、GDPR 等),避免触发 spam 过滤器
– **数据合规责任**:用户需确保已获得潜在客户数据使用授权,MachFive 处理数据不代表用户侧合规免责
– **服务中断风险**:建议关键业务场景准备备用邮件方案







