close-automation

通过 Rube MCP 自动化 Close CRM

通过 Rube MCP 使用 Composio 的 Close 工具包自动化 Close CRM 操作。

工具包文档：composio.dev/toolkits/close

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过工具包为 close 的 RUBE_MANAGE_CONNECTIONS 建立有效的 Close 连接
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 调用工具包为 close 的 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请使用返回的身份验证链接完成 Close API 身份验证
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

核心工作流

1. 创建和管理潜在客户

适用场景：用户想要创建新的潜在客户或管理现有的潜在客户记录

工具调用顺序：

1. CLOSE_CREATE_LEAD - 在 Close 中创建新的潜在客户［必需］

关键参数：

• name：潜在客户／公司名称
• contacts：与该潜在客户关联的联系人对象数组
• custom：以键值对形式提供的自定义字段值
• status_id：潜在客户状态 ID

注意事项：

• Close 中的潜在客户代表公司／组织，而非个人
• 联系人嵌套在潜在客户中；先创建潜在客户，然后再添加联系人
• 自定义字段键使用自定义字段 ID（例如，custom.cf_XXX），而非显示名称
• 系统不会自动检测重复的潜在客户；创建前请先检查

2. 记录通话

适用场景：用户想要记录与某个潜在客户相关的电话活动

工具调用顺序：

1. CLOSE_CREATE_CALL - 记录通话活动［必需］

关键参数：

• lead_id：关联潜在客户的 ID
• contact_id：被呼叫联系人的 ID
• direction：'outbound' 或 'inbound'
• status：通话状态（'completed'、'no-answer'、'busy' 等）
• duration：通话时长，单位为秒
• note：通话备注

注意事项：

• 必须提供 lead_id；通话必须关联到某个潜在客户
• 时长单位为秒，而非分钟
• 通话方向会影响报告和分析
• contact_id 为可选项，但建议提供以便跟踪

3. 发送 SMS 消息

适用场景：用户想要通过 Close 发送或记录 SMS 消息

工具调用顺序：

1. CLOSE_CREATE_SMS - 发送或记录 SMS 消息［必需］

关键参数：

• lead_id：关联潜在客户的 ID
• contact_id：联系人的 ID
• direction：'outbound' 或 'inbound'
• text：SMS 消息内容
• status：消息状态

注意事项：

• SMS 功能需要配置 Close 电话／SMS 集成
• 所有 SMS 活动都必须提供 lead_id
• 发送外发 SMS 可能需要经过验证的发送号码
• 根据运营商的不同，消息长度可能有限制

4. 管理任务

适用场景：用户想要创建或管理后续跟进任务

工具调用顺序：

1. CLOSE_CREATE_TASK - 创建新任务［必需］

关键参数：

• lead_id：关联潜在客户的 ID
• text：任务描述
• date：任务截止日期
• assigned_to：受分配者的用户 ID
• is_complete：任务是否已完成

注意事项：

• 任务关联到潜在客户，而非联系人
• 日期格式应符合 ISO 8601
• assigned_to 需要 Close 用户 ID，而非电子邮件地址或姓名
• 未设置日期的任务会显示在“无截止日期”部分

5. 管理备注

适用场景：用户想要添加或检索潜在客户备注

工具调用顺序：

1. CLOSE_GET_NOTE - 检索指定备注［必需］

关键参数：

• note_id：要检索的备注 ID

注意事项：

• 备注关联到潜在客户
• 检索备注需要备注 ID；请先搜索潜在客户以查找备注引用
• 备注支持纯文本和基本格式

6. 删除活动

使用场景：用户想要删除通话记录或其他活动

工具调用顺序：

1. CLOSE_DELETE_CALL - 删除通话活动［必需］

关键参数：

• call_id：要删除的通话 ID

注意事项：

• 删除操作不可撤销
• 只有通话创建者或管理员可以删除通话
• 删除通话后，该通话会从所有报告和时间线中移除

常见模式

线索与联系人的关系

Close data model:
- Lead = Company/Organization
  - Contact = Person (nested within Lead)
  - Activity = Call, SMS, Email, Note (linked to Lead)
  - Task = Follow-up item (linked to Lead)
  - Opportunity = Deal (linked to Lead)

ID 解析

线索 ID：

1. Search for leads using the Close search API
2. Extract lead_id from results (format: 'lead_XXXXXXXXXXXXX')
3. Use lead_id in all activity creation calls

联系人 ID：

1. Retrieve lead details to get nested contacts
2. Extract contact_id (format: 'cont_XXXXXXXXXXXXX')
3. Use in call/SMS activities for accurate tracking

活动记录模式

1. Identify the lead_id and optionally contact_id
2. Create the activity (call, SMS, note) with lead_id
3. Include relevant metadata (duration, direction, status)
4. Create follow-up tasks if needed

已知注意事项

ID 格式：

• 线索 ID：'lead_XXXXXXXXXXXXX'
• 联系人 ID：'cont_XXXXXXXXXXXXX'
• 活动 ID 因类型而异：'acti_XXXXXXXXXXXXX'、'call_XXXXXXXXXXXXX'
• 自定义字段 ID：'custom.cf_XXXXXXXXXXXXX'
• 始终使用完整的 ID 字符串

速率限制：

• Close API 的速率限制取决于你的套餐
• 批量操作之间应设置延迟
• 监控响应标头中的速率限制状态
• 收到 429 响应时需要进行退避

自定义字段：

• 自定义字段通过其 API ID 引用，而不是显示名称
• 不同的线索状态可能要求不同的自定义字段
• 自定义字段类型（文本、数字、日期、下拉列表）会限制值的格式

数据完整性：

• 线索是主要实体；联系人和活动都与线索关联
• 删除线索可能会连带删除其联系人和活动
• 执行批量操作前应验证 ID

快速参考

任务	工具标识	关键参数
创建线索	CLOSE_CREATE_LEAD	name, contacts, custom
记录通话	CLOSE_CREATE_CALL	lead_id, direction, status, duration
发送短信	CLOSE_CREATE_SMS	lead_id, text, direction
创建任务	CLOSE_CREATE_TASK	lead_id, text, date, assigned_to
获取备注	CLOSE_GET_NOTE	note_id
删除通话	CLOSE_DELETE_CALL	call_id

---

由 Composio 提供支持