Zoho

核心用法

Zoho 技能是面向企业用户的双模块集成工具，通过统一 CLI 接口打通 Zoho CRM 与 Zoho Projects 两大核心 SaaS 服务。CRM 侧支持 Leads、Contacts、Deals、Tasks 等 14 个标准模块的 CRUD 操作及复杂条件搜索（支持 equals、contains、between 等 9 种运算符）；Projects 侧覆盖项目、任务、里程碑、缺陷、工时日志的全生命周期管理。内置 OAuth 2.0 自动刷新机制，token 缓存 50 分钟，避免频繁调用授权端点。

显著优点

• 企业级数据整合：原生支持 Zoho 全球多数据中心（.com/.eu/.in/.com.au/.jp），满足 GDPR 等合规要求
• 零配置开箱即用：通过 .env 文件管理凭证，无需手动处理 token 生命周期
• 灵活查询能力：支持原始 API 透传（zoho raw），可访问自定义模块与设置级接口
• 结构化输出友好：配合 jq 可快速提取关键字段，适配自动化报表与通知场景

潜在局限

• 速率限制约束：CRM 模块限 100 请求/分钟，批量操作时需自行实现分页与节流
• 功能边界清晰：仅覆盖 CRM v7 与 Projects 标准端点，Zoho Desk、Analytics 等服务未纳入
• 日期格式固定：Projects 任务日期强制要求 MM-DD-YYYY，与国际常用 ISO 8601 不兼容
• 依赖外部凭证：首次配置需前往 Zoho API Console 手动创建 Server-based App 并交换 refresh token

适合人群

销售运营团队、项目经理、CRM 管理员及需要将 Zoho 数据接入内部工作流的技术人员。

常规风险

凭证文件存储于本地 .env，若环境未加密或权限配置不当存在泄露风险；API 调用日志可能包含客户敏感信息，需遵循企业内部数据分级保护策略。

核心功能

Zoho Integration 是一款面向企业用户的 CRM 与项目管理 CLI 工具封装，通过统一的 zoho 命令行接口对接 Zoho 官方 API。核心能力覆盖两大模块：

CRM 模块：支持 Leads（线索）、Contacts（联系人）、Accounts（客户）、Deals（商机）、Tasks（任务）、Events（活动）、Quotes（报价单）、Invoices（发票）等 12+ 标准模块的全生命周期管理。提供列表查询、精确搜索（支持 equals/contains/between 等 9 种操作符）、单记录 CRUD、自定义字段操作等功能。

Projects 模块：支持项目列表查看、里程碑追踪、任务创建与进度更新（percent_complete）、Bug 管理、工时记录（timelogs）等项目协作功能。任务字段支持优先级分级（None/Low/Medium/High）、日期范围设定、负责人指派。

技术实现上，该 Skill 采用 OAuth 2.0 认证流，自动处理 access token 的 50 分钟缓存与刷新机制，内置多数据中心域名适配（.com/.eu/.in/.com.au/.jp）。所有 API 调用通过封装好的 CLI 子命令完成，同时保留 zoho raw 原始接口用于自定义模块扩展。

显著优点

1. 官方 API 原生集成：直接调用 Zoho 企业级服务，数据安全性与 SLA 有保障，无第三方中间商风险
2. 自动化认证管理：OAuth token 自动刷新与缓存，开发者无需手动处理 3600 秒过期的 access token
3. 模块化命令设计：crm 与 proj 双命名空间清晰分离业务场景，配合 jq 可快速构建数据管道
4. 搜索能力完善：CRM 模块支持复杂条件组合查询，满足销售漏斗分析、客户分群等业务需求
5. 零依赖轻量化：纯文档型 Skill，无外部包依赖，部署简单

局限性与风险

功能边界：当前仅覆盖 CRM v7 与 Projects 核心模块，Zoho 生态中的 Books（财务）、Desk（客服）、People（人事）等未纳入；自定义模块需通过 zoho raw 手动调用。

使用门槛：需自行完成 Zoho API Console 的 Server-based 应用注册、授权码换取 refresh token 等 OAuth 流程，对非技术用户存在配置复杂度。

速率限制：CRM 模块限制 100 请求/分钟，大规模数据同步需实现分页与退避策略，文档未提供批量操作示例。

数据合规注意：虽然 Skill 本身无数据收集，但实际使用中涉及企业客户数据（PII、交易记录）的跨境传输，需确认 Zoho 数据中心选址与自身合规要求匹配。

适用人群

• 销售运营团队：需自动化商机追踪、Pipeline 报表生成
• 项目经理：需批量创建任务、监控里程碑进度
• 技术集成开发者：需将 Zoho 数据接入内部 BI 或自动化工作流
• 中小企业 IT 管理员：寻求低代码方式扩展 Zoho 能力

常规风险提示

• 凭证安全：.env 文件存储的 refresh token 为长期有效凭证，需确保文件权限 600 且不入版本库
• API 域名验证：生产环境务必确认 API domain 与实际 Zoho 数据中心一致，避免误连钓鱼站点
• Rate Limit 处理：高频调用场景建议实现指数退避，避免账号临时限流
• 数据权限：Zoho API 权限继承自 OAuth 应用授权范围，需遵循最小权限原则配置 Scope