---

name: zoho-crm-automation description: "通过 Rube MCP (Composio) 自动化 Zoho CRM 任务：创建/更新记录、搜索联系人、管理线索、转换线索。始终先搜索工具以获取当前架构。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Zoho CRM 自动化

通过 Composio 的 Zoho 工具包经由 Rube MCP 自动化 Zoho CRM 操作。

前置条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 zoho 建立活跃的 Zoho CRM 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构

设置

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

1. 通过确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 zoho 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接未处于 ACTIVE 状态，按照返回的认证链接完成 Zoho OAuth
4. 在运行任何工作流之前确认连接状态显示为 ACTIVE

核心工作流

1. 搜索和检索记录

使用场景：用户想要按条件查找特定的 CRM 记录

工具调用顺序：

1. ZOHO_LIST_MODULES - 列出可用的 CRM 模块 [前置条件]
2. ZOHO_GET_MODULE_FIELDS - 获取模块的字段定义 [可选]
3. ZOHO_SEARCH_ZOHO_RECORDS - 按条件搜索记录 [必需]
4. ZOHO_GET_ZOHO_RECORDS - 从模块获取记录 [替代方案]

关键参数：

• module：模块名称（如 'Leads'、'Contacts'、'Deals'、'Accounts'）
• criteria：搜索条件字符串（如 'Email:equals:john@example.com'）
• fields：逗号分隔的返回字段列表
• per_page：每页记录数
• page：分页页码

注意事项：

• 模块名称区分大小写（如 'Leads' 而非 'leads'）
• 搜索条件使用特定语法：'Field:operator:value'
• 支持的运算符：equals、starts_with、contains、not_equal、greater_than、less_than
• 复杂条件使用括号和 AND/OR：'(Email:equals:john@example.com)AND(Last_Name:equals:Doe)'
• GET_ZOHO_RECORDS 返回所有记录并可选过滤；SEARCH 用于定向查找

2. 创建记录

使用场景：用户想要添加新的线索、联系人、交易或其他 CRM 记录

工具调用顺序：

1. ZOHO_GET_MODULE_FIELDS - 获取模块的必填字段 [前置条件]
2. ZOHO_CREATE_ZOHO_RECORD - 创建新记录 [必需]

关键参数：

• module：目标模块名称（如 'Leads'、'Contacts'）
• data：包含字段-值对的记录数据对象
• 必填字段因模块而异（如 Contacts 需要 Last_Name）

注意事项：

• 每个模块有必填字段；使用 GET_MODULE_FIELDS 识别它们
• 字段名使用下划线（如 'Last_Name'、'Email'、'Phone'）
• 查找字段需要关联记录的 ID，而非名称
• 日期字段必须使用 'yyyy-MM-dd' 格式
• 除非配置了重复检查规则，否则允许创建重复记录

3. 更新记录

使用场景：用户想要修改现有的 CRM 记录

工具调用顺序：

1. ZOHO_SEARCH_ZOHO_RECORDS - 查找要更新的记录 [前置条件]
2. ZOHO_UPDATE_ZOHO_RECORD - 更新记录 [必需]

关键参数：

• module：模块名称
• record_id：要更新的记录 ID
• data：包含要更新字段的对象（只需提供变更的字段）

注意事项：

• record_id 必须是 Zoho 记录 ID（数字字符串）
• 只需提供需要变更的字段；其他字段保持不变
• 只读和系统字段无法更新
• 查找字段更新需要关联记录的 ID

4. 转换线索

使用场景：用户想要将线索转换为联系人、客户和/或交易

工具调用顺序：

1. ZOHO_SEARCH_ZOHO_RECORDS - 查找要转换的线索 [前置条件]
2. ZOHO_CONVERT_ZOHO_LEAD - 转换线索 [必需]

关键参数：

• lead_id：要转换的线索 ID
• deal：转换时创建交易的详情
• account：转换的客户详情
• contact：转换的联系人详情

注意事项：

• 线索转换不可逆；线索记录将从 Leads 模块中移除
• 转换最多可创建三条记录：联系人、客户和交易
• 可能基于公司名称进行现有客户匹配
• 线索与联系人/客户/交易模块之间的自定义字段映射会影响结果

5. 管理标签和关联记录

使用场景：用户想要为记录添加标签或管理记录之间的关系

工具调用顺序：

1. ZOHO_CREATE_ZOHO_TAG - 创建新标签 [可选]
2. ZOHO_UPDATE_RELATED_RECORDS - 更新关联/链接的记录 [可选]

关键参数：

• module：标签所属模块
• tag_name：标签名称
• record_id：父记录 ID（用于关联记录）
• related_module：关联记录的模块
• data：要更新的关联记录数据

注意事项：

• 标签是模块特定的；在一个模块创建的标签