close-automation

用途

close-automation 用于通过 Rube MCP（Composio 的 Close 工具包）自动化 Close CRM 的日常操作，包括创建和管理销售线索、记录通话活动、发送或记录短信、创建跟进任务、管理备注以及删除通话活动等。

前置条件

Rube MCP 必须已连接，且 RUBE_SEARCH_TOOLS 可用。
需要通过 RUBE_MANAGE_CONNECTIONS 建立状态为 ACTIVE 的 Close 连接，工具包标识为 close。
建议始终先调用 RUBE_SEARCH_TOOLS 以获取当前的工具结构（schema）。

设置方式

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥，添加端点即可使用。
确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
调用 RUBE_MANAGE_CONNECTIONS，工具包选择 close。
如果连接不是 ACTIVE，按照返回的授权链接完成 Close API 认证。
确认连接状态为 ACTIVE 后再运行任何工作流。

主要能力与使用方式

1. 创建和管理线索

适用场景：用户希望创建新线索或管理已有线索记录。

工具：CLOSE_CREATE_LEAD（必需）。

关键参数：name（线索/公司名称）、contacts（关联的联系人对象数组）、custom（以键值对表示的自定义字段值）、status_id（线索状态 ID）。

注意事项：Close 中的线索代表公司或组织，而不是个人；联系人是嵌套在线索内的，应先创建线索，联系人随之包含；自定义字段键使用自定义字段 ID（例如 'custom.cf_XXX'），而不是显示名称；重复线索不会自动检测，创建前应先检查。

2. 记录通话

适用场景：用户希望针对某个线索记录一次电话通话活动。

工具：CLOSE_CREATE_CALL（必需）。

关键参数：lead_id（关联线索的 ID）、contact_id（被叫联系人的 ID）、direction（'outbound' 或 'inbound'）、status（通话状态，如 'completed'、'no-answer'、'busy' 等）、duration（通话时长，单位秒）、note（通话备注）。

注意事项：lead_id 为必填，通话必须关联到线索；时长单位是秒而不是分钟；通话方向会影响报表和分析；contact_id 为可选项，但建议填写以便追踪。

3. 发送短信

适用场景：用户希望通过 Close 发送或记录短信。

工具：CLOSE_CREATE_SMS（必需）。

关键参数：lead_id（关联线索的 ID）、contact_id（联系人 ID）、direction（'outbound' 或 'inbound'）、text（短信内容）、status（消息状态）。

注意事项：短信功能需要先配置 Close 的电话/短信集成；所有短信活动都必填 lead_id；主动发送短信可能需要已验证的发送号码；根据运营商不同，可能存在消息长度限制。

4. 管理任务

适用场景：用户希望创建或管理跟进任务。

工具：CLOSE_CREATE_TASK（必需）。

关键参数：lead_id（关联线索 ID）、text（任务描述）、date（任务到期日）、assigned_to（指派人的用户 ID）、is_complete（任务是否完成）。

注意事项：任务关联到线索而不是联系人；日期格式应遵循 ISO 8601；assigned_to 需要 Close 用户 ID，而不是邮箱或姓名；没有日期的任务会出现在“无到期日”区域。

5. 管理备注

适用场景：用户希望添加或获取线索上的备注。

工具：CLOSE_GET_NOTE（必需）。

关键参数：note_id（要获取的备注 ID）。

注意事项：备注关联到线索；获取备注必须提供备注 ID，可先搜索线索以找到备注引用；备注支持纯文本和基础格式。

6. 删除活动

适用场景：用户希望删除通话记录或其他活动。

工具：CLOSE_DELETE_CALL（必需）。

关键参数：call_id（要删除的通话 ID）。

注意事项：删除是永久性的，无法撤销；只有通话创建者或管理员可以删除通话；删除通话会将其从所有报表和时间线中移除。

常见模式

线索与联系人关系：Close 数据模型中，Lead 为公司/组织，Contact 为嵌套在线索中的个人，Activity（通话、短信、邮件、备注）关联到 Lead，Task（跟进项）关联到 Lead，Opportunity（交易）关联到 Lead。
ID 解析：线索 ID 可通过 Close 搜索 API 查找线索并从中提取 lead_id（格式 'lead_XXXXXXXXXXXXX'）；联系人 ID 可通过获取线索详情得到嵌套联系人并提取 contact_id（格式 'cont_XXXXXXXXXXXXX'），用于通话/短信活动以便准确追踪。
活动记录模式：先确定 lead_id 和可选的 contact_id，再用 lead_id 创建活动（通话、短信、备注），并包含相关元数据（时长、方向、状态），如有需要再创建跟进任务。

已知注意事项

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