用途:这是 Smartlead API 的参考技能,汇总端点与调用模式,供所有与 Smartlead 交互的技能(如收件箱管理、活动上传、送达率审计、正向回复评分等)复用,本身不执行具体任务。
认证与基础:所有请求通过查询参数认证,格式为 ?api_key={SMARTLEAD_API_KEY},环境变量为 $SMARTLEAD_API_KEY,基础地址 https://server.smartlead.ai/api/v1。
限流:标准套餐 2,000 请求/分钟(33 请求/秒),更高套餐 3,000 请求/分钟(50 请求/秒);遇到 429 和 5xx 应使用指数退避重试;批量操作建议用 p-limit 或 PQueue,并发 8-15。
主要能力:活动(获取、创建、更新状态 START/PAUSED/STOP)、活动邮箱账号(列出、添加、移除)、活动序列(获取与保存,支持 seq_variants 的 A/B/C 变体,正文顺序为内容→PS 退订行→%signature%)、活动设置与排期、线索(按邮箱查询、批量添加,单批最多 100 条)、分析(按日整体统计、正向回复统计、整体统计 v2、活动列表、单活动分析及按日期分析)、全局邮箱账号(分页列出、获取、创建/更新)、主收件箱回复(分页与过滤)。
使用方式:可直接调用 REST 端点,也可用 @smartlead/cli 命令行工具快速查询,例如 smartlead campaigns list、smartlead leads add --campaign-id <id> --file leads.csv、smartlead analytics overall、smartlead inbox replies。子客户模式:普通子客户在所有请求上带 ?api_key={MAIN_KEY}&client_id={CLIENT_ID};自定义 API key 客户直接使用其自身 key,无需 client_id。
限制与提示:邮箱账号分页每页 100 条,账号量大时完整遍历可能超过 30 秒,建议脚本开始时一次性分页并缓存到内存,或写入本地 JSON 文件定时刷新。资料未提供价格、套餐细节及更多端点说明。