name: Instantly自动化 description: “通过Composio MCP集成使用自然语言自动化Instantly冷邮件外展——管理活动、发送账户、潜在客户列表、批量潜在客户导入和活动分析。” category: email-outreach requires: mcp: - rube

Instantly自动化

使用Instantly自动化您的冷邮件外展——通过自然语言命令创建和管理具有多步骤序列的活动、配置发送计划、批量导入潜在客户、管理发送账户并跟踪活动性能。

工具包文档: composio.dev/toolkits/instantly

设置

将Composio MCP服务器添加到您的客户端配置：
```
https://rube.app/mcp
```
在提示时连接您的Instantly账户（API密钥认证）。
开始发出自然语言命令来管理您的外展活动。

核心工作流程

1. 列出发送账户

检索您Instantly工作区中配置的所有电子邮件账户，可按状态和提供商过滤。

工具: INSTANTLY_LIST_ACCOUNTS

示例提示:

“显示我Instantly工作区中所有活跃的发送账户”

关键参数:

status – 按状态过滤：1（活跃），2（暂停），-1（连接错误），-2（软退回错误），-3（发送错误）
provider_code – 按提供商过滤：1（自定义IMAP/SMTP），2（Google），3（Microsoft），4（AWS）
search – 按电子邮件子字符串或域名搜索
limit – 最大项目数（1-100）
starting_after – 从前一个响应获取的分页游标
tag_ids – 逗号分隔的标签UUID

2. 创建活动

启动一个新的外展活动，包括调度、电子邮件序列、A/B测试变体和发送配置。

工具: INSTANTLY_CREATE_CAMPAIGN

示例提示:

“创建一个名为’Q1外展’的Instantly活动，在周一至周五中部时间上午9点至下午5点发送，包含3步电子邮件序列”

关键参数:

name（必需）-- 活动名称
campaign_schedule（必需）-- 调度配置：
- schedules（必需）-- 调度对象数组，每个包含：
  - name – 调度名称
  - timing – {from: "09:00", to: "17:00"}（HH:mm格式）
  - days – 天数索引字符串"0"（周日）到"6"（周六）到布尔值的映射
  - timezone – 支持的时区包括"America/Chicago"、“America/Detroit”、“America/Boise”、“America/Anchorage”
- start_date / end_date – ISO 8601日期
email_list – 发送账户电子邮件地址数组（必须是预先配置的账户；使用INSTANTLY_LIST_ACCOUNTS发现有效地址）
sequences – 数组（仅使用第一个元素）包含：
- steps – 步骤对象数组，其中：
  - type – 必须是"email"
  - delay – 发送下一封电子邮件前的天数（整数，最小0）
  - variants – {subject, body}对象的A/B测试数组
daily_limit – 每日发送上限
email_gap – 电子邮件之间的分钟数
stop_on_reply – 当潜在客户回复时停止活动（布尔值）
stop_on_auto_reply – 在自动回复时停止（布尔值）
open_tracking / link_tracking – 启用跟踪（布尔值）

时区说明:

已验证可用的时区：“America/Chicago”（中部）、“America/Detroit”（东部）、“America/Boise”（山区）
自动映射：“America/New_York"映射到"America/Detroit”，“America/Denver"映射到"America/Boise”
不支持：“America/Los_Angeles”、“US/Pacific” – 使用"America/Anchorage"或"America/Dawson"作为替代

3. 更新活动设置

修改现有活动的调度、发送限制、序列或跟踪设置。

工具: INSTANTLY_UPDATE_CAMPAIGN

示例提示:

“更新我的Instantly活动，将每日限制增加到100并启用打开跟踪”

关键参数:

id（必需）-- 活动UUID
任何组合：name、campaign_schedule、email_list、sequences、daily_limit、email_gap、stop_on_reply、open_tracking、link_tracking等
将任何参数设置为null以取消设置

4. 管理潜在客户列表和批量导入

创建专门的潜在客户列表并批量导入潜在客户以进行活动定向。

工具: INSTANTLY_CREATE_LEAD_LIST、INSTANTLY_ADD_LEADS_BULK

示例提示:

“创建一个名为’Q1潜在客户’的潜在客户列表，并向我的Instantly活动添加50个潜在客户”

创建潜在客户列表的关键参数:

列表名称和配置

批量导入潜在客户的关键参数:

要导入的活动或列表ID
包含电子邮件和元数据的潜在客户对象数组
重复项处理选项
潜在客户验证设置

5. 查看活动详情

检索完整的活动配置以验证设置、检查序列或准备更新。

工具: INSTANTLY_GET_CAMPAIGN

示例提示:

“显示我的Instantly活动的完整详情”

关键参数:

id（必需）-- 活动UUID

6. 列出所有活动

枚举您工作区中的所有活动，带有可选的过滤和分页。

工具: INSTANTLY_LIST_CAMPAIGNS

示例提示:

“列出我所有的Instantly活动”

关键参数:

可选的过滤和分页参数

已知陷阱

时区支持有限: Instantly API接受一组受限的时区字符串。太平洋时间（“America/Los_Angeles”）不支持。使用"America/Anchorage"（UTC-9/UTC-8）或"America/Dawson"（全年UTC-7）作为替代。
无效的调度有效负载导致400错误: 格式错误的campaign_schedule（缺少days、from、to或schedules）会触发HTTP 400。重复的400错误表示有效负载问题，不是临时故障。
序列必须完整: 每个序列步骤都需要有效的type（“email”）、delay和至少一个包含subject和body的变体。不完整的变体会阻止活动创建。
仅使用第一个序列元素: API仅处理sequences[0]。额外的序列会被忽略。
email_list必须引用现有账户: email_list字段需要您Instantly工作区中预先配置的发送账户的电子邮件地址，而不是任意收件人地址。始终使用INSTANTLY_LIST_ACCOUNTS来发现有效的发送地址。
活动创建时的401范围错误: 活动创建可能失败，错误为"Invalid scope. Required: campaigns:create"。在重试写入操作之前更新您的API密钥权限。
读取回来的字段可能不同: INSTANTLY_GET_CAMPAIGN响应中的字段名称可能与创建时的有效负载不同（例如，timing.from_ vs timing.from）。请谨慎解析。

快速参考

操作	工具标识符	必需参数
列出发送账户	`INSTANTLY_LIST_ACCOUNTS`	无（可选过滤器）
创建活动	`INSTANTLY_CREATE_CAMPAIGN`	`name`、`campaign_schedule`
更新活动	`INSTANTLY_UPDATE_CAMPAIGN`	`id`
获取活动详情	`INSTANTLY_GET_CAMPAIGN`	`id`
列出活动	`INSTANTLY_LIST_CAMPAIGNS`	无（可选过滤器）
创建潜在客户列表	`INSTANTLY_CREATE_LEAD_LIST`	列表名称
批量导入潜在客户	`INSTANTLY_ADD_LEADS_BULK`	活动/列表ID、潜在客户

由 Composio 提供支持