zoho-crm-automation

通过 Rube MCP 自动化 Zoho CRM

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

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

前提条件

• 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Zoho CRM 连接，并指定工具包 zoho
• 始终先调用 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:[email protected]'）
• fields：以逗号分隔的返回字段列表
• per_page：每页记录数
• page：分页页码

注意事项：

• 模块名称区分大小写（例如，'Leads'，而非 'leads'）
• 搜索条件使用特定语法：'Field:operator:value'
• 支持的运算符：equals、starts_with、contains、not_equal、greater_than、less_than
• 复杂条件使用括号和 AND/OR：'(Email:equals:[email protected])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 模块中移除
• 转换最多可创建三条记录：联系人、客户和交易
• 可能会根据公司名称匹配现有客户
• Leads 与 Contacts/Accounts/Deals 模块之间的自定义字段映射会影响转换结果

5. 管理标签和相关记录

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

工具调用顺序：

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

关键参数：

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

注意事项：

• 标签按模块区分；为 Leads 创建的标签不能用于 Contacts
• 相关记录需要提供父记录 ID 和相关模块
• 标签名称在同一模块中必须唯一
• 批量标签操作可能触及速率限制

常见模式

模块和字段发现

1. Call ZOHO_LIST_MODULES to get all available modules
2. Call ZOHO_GET_MODULE_FIELDS with module name
3. Identify required fields, field types, and picklist values
4. Use field API names (not display labels) in data objects

搜索条件语法

简单搜索：

criteria: '(Email:equals:[email protected])'

组合条件：

criteria: '((Last_Name:equals:Doe)AND(Email:contains:example.com))'

支持的运算符：

• equals、not_equal
• starts_with、contains
• greater_than、less_than、greater_equal、less_equal
• between（用于日期/数字）

分页

• 设置 per_page（最大值为 200）和从 1 开始的 page
• 检查响应中的 info.more_records 标志
• 递增页码，直到 more_records 为 false
• 响应的 info 中提供总数

已知注意事项

字段名称：

• 使用 API 名称，而不是显示标签（例如，使用 'Last_Name'，而不是 'Last Name'）
• 自定义字段的 API 名称类似于 'Custom_Field1' 或用户自定义名称
• 选项列表值必须完全匹配（区分大小写）

速率限制：

• API 调用限制取决于 Zoho CRM 方案
• 免费方案：每天 5000 次 API 调用；Enterprise：每天 25000 次以上
• 批量操作之间应加入延迟
• 监控 429 响应并遵守速率限制响应头

数据格式：

• 日期：'yyyy-MM-dd' 格式
• 日期时间：'yyyy-MM-ddTHH:mm:ss+HH:mm' 格式
• 货币：不带格式的数值
• 电话：字符串值（不强制使用特定格式）

模块访问权限：

• 访问权限取决于用户角色和配置文件权限
• CRM 配置中可能会隐藏或限制某些模块
• 自定义模块具有自定义 API 名称

快速参考

任务	工具标识	关键参数
列出模块	ZOHO_LIST_MODULES	（无）
获取模块字段	ZOHO_GET_MODULE_FIELDS	module
搜索记录	ZOHO_SEARCH_ZOHO_RECORDS	module, criteria
获取记录	ZOHO_GET_ZOHO_RECORDS	module, fields, per_page, page
创建记录	ZOHO_CREATE_ZOHO_RECORD	module, data
更新记录	ZOHO_UPDATE_ZOHO_RECORD	module, record_id, data
转换潜在客户	ZOHO_CONVERT_ZOHO_LEAD	lead_id, deal, account, contact
创建标签	ZOHO_CREATE_ZOHO_TAG	module, tag_name
更新相关记录	ZOHO_UPDATE_RELATED_RECORDS	module, record_id, related_module, data

---

由 Composio 提供支持