用途
该技能用于通过 Composio 的 Zoho 工具包（经由 Rube MCP）自动化 Zoho CRM 的日常操作，包括记录检索、创建、更新、线索转换以及标签和关联记录管理。
主要能力
- 搜索和检索记录：按条件查找 CRM 记录，支持分页和字段筛选。
- 创建记录：向 Leads、Contacts、Deals、Accounts 等模块添加新记录。
- 更新记录：修改现有记录，仅需提供变更字段。
- 转换线索：将线索转换为联系人、客户和/或交易。
- 管理标签和关联记录：创建标签、更新关联记录。
使用方式
前置条件
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
- 通过 RUBE_MANAGE_CONNECTIONS 激活 Zoho CRM 连接，工具包为 zoho。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
设置
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 zoho。
- 若连接未处于 ACTIVE 状态，按返回的授权链接完成 Zoho OAuth。
- 确认连接状态显示 ACTIVE 后再运行任何工作流。
核心工作流
- 搜索和检索记录：依次调用 ZOHO_LIST_MODULES、ZOHO_GET_MODULE_FIELDS（可选）、ZOHO_SEARCH_ZOHO_RECORDS 或 ZOHO_GET_ZOHO_RECORDS。关键参数包括 module、criteria、fields、per_page、page。
- 创建记录：先调用 ZOHO_GET_MODULE_FIELDS 获取必填字段，再调用 ZOHO_CREATE_ZOHO_RECORD。关键参数包括 module、data。
- 更新记录：先调用 ZOHO_SEARCH_ZOHO_RECORDS 找到记录，再调用 ZOHO_UPDATE_ZOHO_RECORD。关键参数包括 module、record_id、data。
- 转换线索：先调用 ZOHO_SEARCH_ZOHO_RECORDS 找到线索，再调用 ZOHO_CONVERT_ZOHO_LEAD。关键参数包括 lead_id、deal、account、contact。
- 管理标签和关联记录：调用 ZOHO_CREATE_ZOHO_TAG 或 ZOHO_UPDATE_RELATED_RECORDS。关键参数包括 module、tag_name、record_id、related_module、data。
常见模式
- 模块和字段发现：调用 ZOHO_LIST_MODULES 获取所有可用模块，调用 ZOHO_GET_MODULE_FIELDS 获取字段定义，识别必填字段、字段类型和选项值，在数据对象中使用字段 API 名称而非显示标签。
- 搜索条件语法：简单搜索如 criteria: '(Email:equals:john@example.com)'；组合条件如 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）和 page（从 1 开始），检查响应 info.more_records 标志，递增 page 直到 more_records 为 false，总计数在响应 info 中。
适用场景
- 需要批量或自动化处理 Zoho CRM 记录的场景。
- 通过 MCP 集成在客户端中直接操作 CRM 数据。
- 线索转换、联系人搜索、记录更新等日常 CRM 任务。
限制
- 模块名称区分大小写（如 'Leads' 而非 'leads'）。
- 搜索条件使用特定语法 'Field:operator:value'。
- 字段名称使用下划线（如 'Last_Name'、'Email'、'Phone'），需使用 API 名称而非显示标签。
- 查找字段需要相关记录 ID，而非名称。
- 日期字段必须使用 'yyyy-MM-dd' 格式；DateTime 使用 'yyyy-MM-ddTHH:mm:ss+HH:mm' 格式；货币为无格式数值；电话为字符串。
- 除非配置了重复检查规则，否则允许创建重复记录。
- 线索转换不可逆，线索记录会从 Leads 模块移除；转换最多创建三个记录：Contact、Account 和 Deal；可能基于公司名称匹配现有客户；Lead 与 Contact/Account/Deal 模块之间的自定义字段映射会影响结果。
- 标签是模块特定的，为 Leads 创建的标签在 Contacts 中不可用；标签名称在模块内必须唯一；批量标签操作可能触及速率限制。
- API 调用限制取决于 Zoho CRM 计划：免费计划每天 5000 次 API 调用；企业版每天 25000+ 次。需在批量操作之间实施延迟，监控 429 响应并遵守速率限制标头。
- 模块访问取决于用户角色和配置文件权限；某些模块可能被隐藏或受限；自定义模块有自定义 API 名称。
- 只读和系统字段无法更新。
- 关联记录需要父记录 ID 和相关模块。
快速参考
| 任务 | 工具 Slug | 关键参数 |
|---|---|---|
| 列出模块 | 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 |