⚡

ZohoCRM自动化Skill zoho-crm-automation

这个技能用于通过Rube MCP和Composio工具包自动化Zoho CRM任务，包括记录的创建、更新、搜索、线索管理和转换。它提供工作流指导、API集成和常见陷阱避免。关键词：Zoho CRM自动化, Rube MCP, Composio, 工作流, API调用, 低代码开发, CRM集成, 业务流程自动化。

低代码开发 0 次安装 0 次浏览 更新于 3/8/2026

name: zoho-crm-automation description: “通过Rube MCP（Composio）自动化Zoho CRM任务：创建/更新记录、搜索联系人、管理线索和转换线索。始终先搜索工具以获取当前模式。” requires: mcp: [rube] category: crm

通过Rube MCP实现Zoho CRM自动化

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

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

前提条件

  • 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. 如果连接未激活，请按照返回的认证链接完成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’）
  • 搜索条件使用特定语法：‘字段:运算符:值’
  • 支持的运算符：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模块中移除
  • 转换最多可以创建三个记录：联系人、账户和交易
  • 可能基于公司名称发生现有账户匹配
  • Lead与Contact/Account/Deal模块之间的自定义字段映射会影响结果

5. 管理标签和相关记录

何时使用: 用户希望为记录打标签或管理记录之间的关系

工具序列:

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

关键参数:

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

陷阱:

  • 标签是模块特定的；为Leads创建的标签在Contacts中不可用
  • 相关记录需要父记录ID和相关模块
  • 标签名称在模块内必须唯一
  • 批量标签操作可能达到速率限制

常见模式

模块和字段发现

1. 调用ZOHO_LIST_MODULES以获取所有可用模块
2. 调用ZOHO_GET_MODULE_FIELDS并指定模块名称
3. 识别必需字段、字段类型和选择列表值
4. 在数据对象中使用字段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标志
  • 增加页码直到more_records为false
  • 总计数在响应info中可用

已知陷阱

字段名称:

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

速率限制:

  • API调用限制取决于您的Zoho CRM计划
  • 免费计划：5000 API调用/天；企业版：25000+次/天
  • 在批量操作之间实施延迟
  • 监控429响应并尊重速率限制头部

数据格式:

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

模块访问:

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

快速参考

任务 工具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

由 Composio 提供支持