用途:这是面向 Instantly.ai 冷邮件外展平台的 API 技能,适合在对话中让助手调用 Instantly API V2 管理邮件营销活动、线索和发送账号。
主要能力:
- 活动管理:列出活动(可按状态过滤,状态值 ACTIVE、PAUSED、COMPLETED、DRAFTED)、获取单个活动、创建活动(需 campaign_schedule)、暂停与激活活动。
- 线索管理:列出线索(因过滤条件复杂使用 POST)、创建线索(可带 custom_variables,值为字符串/数字/布尔/null)、获取单个线索、更新线索。
- 线索列表:列出与创建 lead-lists。
- 账号:列出已接入的发送账号,含 email、status、warmup_status。
- 验证:通过 /api-keys 测试 API 密钥有效性及权限范围。
- 分页:列表接口支持 limit 与 starting_after 游标分页。
使用方式:
- 基础 URL 为 https://api.instantly.ai/api/v2,认证头为 Authorization: Bearer $INSTANTLY_API_KEY。
- 创建类请求可先将 JSON 写入 /tmp/instantly_request.json,再用 curl 的 -d @/tmp/instantly_request.json 提交。
- 示例:curl -s "https://api.instantly.ai/api/v2/campaigns" -H "Authorization: Bearer $INSTANTLY_API_KEY"
- 故障排查:zero doctor check-connector --env-name INSTANTLY_API_KEY 或 zero doctor check-connector --url https://api.instantly.ai/api/v2/campaigns --method GET
限制与注意事项:仅使用 API V2,V1 已废弃;始终使用 Bearer 认证;API 访问需 Growth 计划或以上;请按套餐遵守速率限制;建议为密钥配置最小必要权限;custom_variables 不支持对象或数组。