zoho-crm

zoho-crm

用途

对于任何用例，此技能都会：

1. 选择合适的基本方案，加载相关的 DOU 节点／参考文档
2. 生成解决方案（通过已连接的 MCP 工具，或提供精确的负载），并验证输出

何时使用

用例	子技能
通过 HTTP 读取、创建、更新和删除 CRM 记录	API
编写服务器端自动化／自定义函数	Functions / Deluge
为记录页面／列表视图添加 UI 逻辑	ClientScript
构建嵌入式 UI 组件	Widgets
构建绑定到 Canvas 视图、Kiosk 或 Custom Related List 的已保存查询（在 Workbench 中通过 UI 创建）	Queries
使用 COQL（CRM 对象查询语言）查询 CRM 数据	COQL
通过 OAuth 连接外部服务	Connections

分步推理流程

第 1 步 — 理解目标

维度	提取内容	示例
操作	应该执行什么操作？	获取、创建、更新、触发、显示、查询
实体	涉及哪个 CRM 模块或对象？	Leads、Contacts、Deals、自定义模块
上下文	在哪里运行？	服务器端、UI 页面、定时任务、事件触发

关卡：如果无法根据单一合理的解释明确推断出上述任一维度，请停止并先询问，再继续第 2 步。只询问必要信息；对于有明确默认值的可选参数，不必询问。

第 2 步 — 选择合适的基本方案

将下方的决策矩阵作为主要路由依据。如果用例与任何一行都不匹配，请应用分层规则：服务器端（无需访问浏览器）→ Function / REST API / COQL / Queries；浏览器端 → Widget / Client Script。

决策矩阵 — 需求 → 使用

服务端

需求	使用
在 CRM 中运行 Deluge 后端代码 — 处理记录、执行 CRUD 操作、调用 Zoho CRM API、发送电子邮件／短信，或执行任何服务端业务逻辑	Function — 通过 Workflow Rule、Blueprint、Schedule、Button、Validation Rule 或 Serverless Endpoint 触发
调用外部（非 Zoho）API 并将结果写入 CRM	Function，通过 Workflow Rule 或 Button（使用命名 Connection 进行身份验证）
将自定义 Deluge 逻辑作为 REST API 暴露给外部系统	Function，通过 Serverless Endpoint
在 CRM 中运行定时任务	Function，通过 Scheduled Function
将 Custom Related List 转换为 Function	Function，通过 related_list.* 类别 — 这是唯一能在记录详情页直接呈现数据的类别；除非明确指定了其他触发类型（按钮、工作流、API 端点），否则不要追问
从外部系统或脚本读取／创建／更新／删除 CRM 记录，或执行任何 CRM 专属操作	REST API
通过 Deluge、外部 API 调用方或临时代码以编程方式获取 CRM 数据	COQL
在 Canvas、Kiosk 或 Custom Related List 中显示查询驱动的数据	Queries（在 Workbench UI 中构建 — Setup → Developer Hub → Queries）
从 Function 或 ClientScript 对外部 OAuth 服务进行身份验证	Connections（在 Setup → Developer Hub → Connections 中创建；在 invokeurl 或 ZDK.Apps.CRM.Connection.invoke 中通过链接名称引用）

浏览器端

需求	使用
在 CRM 中呈现或嵌入自定义 HTML 或第三方 UI 组件	Widget
根据另一个字段的值隐藏某个字段，或自定义记录页面上的其他 Web UI	Client Script
在 CRM Web UI 中保存记录前验证字段输入	Client Script（即时 UI 反馈）或 Function，通过 Validation Rule（服务端强制执行） — 除非用户明确要求服务端强制执行，否则默认使用 Client Script
在 Web UI 中执行按钮操作前显示确认对话框	Client Script（对话框）+ Function（后端操作）

决胜规则：默认选择列出的第一个选项；仅当用户上下文明确倾向于第二个选项时才覆盖。

检查：确认所选原语与步骤 1 中的操作 + 实体 + 上下文相匹配。如果不匹配 — 重新检查矩阵或返回澄清环节。

通用约束：所有模块和字段引用都使用 API 名称 — 切勿显示标签。

权威来源层级

如对语法、签名或限制有疑问，请按以下顺序查阅来源（而非按偏好或记忆）：

1. DOU 节点（assets/）— 当前的方法签名、参数、返回类型和关键故障模式。生成代码时优先查阅此项。
2. Zoho 官方公开文档（zoho.com/deluge/help/、zoho.com/crm/api/）— 当 DOU 节点内容不完整或缺失时查阅。
3. 参考文件 + 内联示例（api.md、functions.md 等）— 整理后的摘要；其内容可能落后于 DOU 或官方文档。
4. 回忆的知识 — 可信度最低；务必与 DOU 交叉核对。

关键规则：参考文件是整理后的摘要，并非权威来源。DOU 节点才是事实依据。如果参考文件中的示例与 DOU 节点冲突，以 DOU 节点为准。

步骤 3 — 加载所选原语的参考资料

打开上文“When to Use”表格中与所选原语相匹配的参考文件，并遵循其 Execution Instructions。（特殊情况：如果原语是 Queries 且源类型为 COQL，还要打开 references/coql.md。）

如果无法访问某个参考文件，请告知用户并说明缺少哪个文件，且不要生成依赖其内容的代码。

步骤 4–5 — 执行和验证

遵循步骤 3 中参考文件里的执行说明。提供解决方案后，运行其验证清单；用通俗易懂的语言说明错误，并在目标仅部分达成时建议后续步骤。

身份验证和范围参考

始终根据 OAS 规范文件确定范围（参见 api.md 第 6 步，操作级别的 security 字段）。对于所有标准范围，请使用 OAS 规范 — 下表仅涵盖不明显的情况。

范围	说明
ZohoCRM.coql.READ 和 ZohoCRM.modules.{module}.READ	COQL 查询 — 需要两个独立的范围；仅使用 coql.READ → OAUTH_SCOPE_MISMATCH

基础 URL：https://www.zohoapis.com/crm/v8/