Zoho业务集成

技能简介

该技能提供Zoho CRM、Projects和Meeting三大模块的统一接口，支持管理销售线索、联系人、商机、项目任务、里程碑及会议录制内容。通过封装OAuth 2.0认证流程，实现访问令牌的自动刷新与缓存。

业务背景

销售与项目团队常在CRM、项目管理及会议系统间切换，数据分散导致跟进效率低。该集成打通Zoho三大核心模块，统一身份认证与路由管理，使业务人员无需登录多个后台即可完成客户信息查询、任务派发及会议资料归档，降低多系统操作的协作成本。

落地案例：客户经理收到客户需求后，通过自然语言指令快速调取CRM中的历史商机记录，同步在Projects创建实施任务并设定里程碑；周会结束后，一键获取会议录制链接分享给未参会的售前团队。系统自动识别US/EU等数据中心路由，确保跨国团队访问对应区域的实例数据。

能做什么

• 查询和更新CRM中的商机、联系人、线索记录
• 创建和管理项目、任务、里程碑及工时日志
• 获取会议列表、会话详情及录制文件下载链接
• 自动处理多数据中心（US/EU/IN/AU等）的API路由

使用说明

1. 环境准备：确保系统已安装Node.js 18+和zoho CLI工具
2. 注册应用：访问Zoho API Console，添加”Server-based Applications”类型客户端，记录Client ID和Client Secret
3. 生成授权码：按以下格式拼接URL并在浏览器打开（替换占位符）：
   https://accounts.zoho.com/oauth/v2/auth?response_type=code&client_id=YOUR_CLIENT_ID&scope=ZohoCRM.modules.ALL,ZohoProjects.projects.ALL,ZohoMeeting.recording.READ&redirect_uri=https://localhost/callback&access_type=offline&prompt=consent
   根据所在区域选择对应的accounts域名（US: .com, EU: .eu, IN: .in等）
4. 换取刷新令牌：复制回调URL中的code参数，执行：
   curl -X POST "https://accounts.zoho.com/oauth/v2/token" -d "client_id=YOUR_CLIENT_ID" -d "client_secret=YOUR_SECRET" -d "grant_type=authorization_code" -d "redirect_uri=https://localhost/callback" -d "code=PASTE_CODE"
5. 配置环境变量：在项目根目录创建.env文件，填入ZOHO_CLIENT_ID、ZOHO_CLIENT_SECRET、ZOHO_REFRESH_TOKEN、ZOHO_ORG_ID、ZOHO_MEETING_ORG_ID及各模块域名
6. 验证连接：运行zoho token检查令牌状态，zoho help查看可用命令

输入与输出

见下方输入与输出表格。

风险提示

• 授权码有效期仅2分钟，获取后需立即换取刷新令牌
• CRM组织ID与Meeting组织ID为不同值，配置时勿混淆
• 刷新令牌长期有效，应妥善保管避免泄露
• 访问令牌每小时过期，依赖CLI自动刷新机制
• 不同数据中心的API域名不同，错误配置会导致请求失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/shreefentsar/zoho/SKILL.md
来源类型：GitHub仓库