企业官网建设流程全解析

Cal.diy 怎么配置 Zoho CRM 与 Zoho Calendar 集成的 OAuth 凭证

【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy

如果你已经部署好 Cal.diy，想让订会议时自动在 Zoho CRM 里为联系人创建 Meeting、或把日程同步到 Zoho Calendar，就需要先在 Zoho API Console 里创建两个独立的 OAuth 应用，再把 Client ID 和 Client Secret 分别交给 Cal.diy。本文覆盖两条集成各自的凭证申请步骤、Redirect URL 设置、Multi-DC 选项，以及配置完成后在 Cal.diy 里启用集成并验证的入口。两个集成共用 Zoho API Console，但回调地址和凭证存放位置不同，不能混用。

准备条件

• 一个 Zoho 账号，能登录 Zoho API Console，没有账号可先注册。
• 一个已经可以访问的 Cal.diy 应用地址，下文统一写作<Cal.diy URL>。所有 Redirect URL 代码块中的<Cal.diy URL>都要替换为你的实际应用域名，例如部署在cal.example.com就替换为https://cal.example.com。
• Zoho CRM 凭证通过环境变量注入，Cal.diy 仓库里 .env.appStore.example 已预留两个字段：

# - ZOHOCRM # Used for the Zoho CRM integration ZOHOCRM_CLIENT_ID="" ZOHOCRM_CLIENT_SECRET=""

Zoho Calendar 的凭证不走环境变量，而是在 Cal.diy 管理后台录入，见后文。

配置 Zoho CRM 的 OAuth 凭证

以下步骤来自 apps/docs/content/apps/zoho.mdx，与根目录 README.md 的 “Obtaining ZohoCRM Client ID and Secret” 一节一致。

1. 登录 Zoho API Console，进入 "Applications" 页面。
2. 点击右上角 "ADD CLIENT"，选择 "Server-based Applications"。
3. 在 "Client Details" 页填写任意你需要的应用信息。
4. 设置 OAuth Redirect URL 为：

<Cal.diy URL>/api/integrations/zohocrm/callback

其中<Cal.diy URL>替换为你的应用地址。

5. 进入 "Client Secret" 页，复制 Client ID 和 Client Secret，写入 Cal.diy 的.env文件：

ZOHOCRM_CLIENT_ID=你的ClientID ZOHOCRM_CLIENT_SECRET=你的ClientSecret

6. 在 "Settings" 区域，如果希望同一套 OAuth 凭证在所有数据中心生效，勾选 "Multi-DC" 选项。
7. 点击页面底部的 "Save" 或 "UPDATE" 保存设置。

保存后，Zoho CRM 集成就可以在 Cal.diy 设置中添加使用了。修改.env后需要重启 Cal.diy 服务，环境变量才会生效。

配置 Zoho Calendar 的 OAuth 凭证

Zoho Calendar 的凭证申请流程与 CRM 类似，但存放位置不同：不写环境变量，而是录入到 Cal.diy 管理后台的应用密钥里。以下步骤来自 apps/docs/content/apps/zoho.mdx 和 packages/app-store/zohocalendar/README.md。

1. 登录 Zoho API Console，新建一个 "Server-based Applications" 应用（注意与 CRM 的应用分开创建）。
2. 设置 OAuth Redirect URL 为：

<Cal.diy URL>/api/integrations/zohocalendar/callback

两个回调路径不同：CRM 是/api/integrations/zohocrm/callback，Calendar 是/api/integrations/zohocalendar/callback，填错会导致授权后无法跳回 Cal.diy。

3. 在 "Client Details" 页填写应用信息，进入 "Client Secret" 页复制凭证。
4. 打开 Cal.diy 管理后台的应用密钥页面：

<Cal.diy URL>/settings/admin/apps

将 Zoho Calendar 的 Client ID 和 Client Secret 填入对应应用条目。 5. 回到 Zoho API Console，在 "Settings" 区域勾选 "Multi-DC"（同样适用于希望跨数据中心复用凭证的情况），点击 "Save"/"UPDATE" 保存。

在 Cal.diy 中启用并验证

配置完成后，两条集成各有固定的启用入口：

• Zoho Calendar：在/settings/my-account/calendars页面添加 Zoho Calendar 连接。文档同时提醒：如果你在 Cal.diy 中连接了多个日历，务必打开同页的开关，用于跨日历防止重复预订（double-booking）。
• Zoho CRM：凭证写入.env并重启服务后，按 apps/docs/content/apps/zoho.mdx 的说法，集成即可在 Cal.diy 设置中添加。

验证方式以文档给出的现象为准：

• 授权流程能正常走完 OAuth 跳转（回调到上面配置的 callback 地址并回到 Cal.diy），说明 Redirect URL 与凭证匹配。
• Calendar 连接成功后，可在 Zoho Calendar 中查看到对应事件；CRM 侧的集成效果，README 中给出的预期是 “you can easily add your Zoho CRM integration in the Cal.diy settings”，即设置里能正常添加并使用该集成。

限制与注意事项

• 两个集成必须在 Zoho API Console 创建为 "Server-based Applications"，并使用各自的 Redirect URL；凭证不能互相套用。
• "Multi-DC" 是可选项，仅当你需要用同一套凭证跨数据中心时才勾选，文档未说明其默认状态。
• Zoho Calendar 的凭证录入页/settings/admin/apps属于管理员路径，执行该步骤的账号需要有管理权限；文档中 Zoho CRM 与 Zoho Bigin 的凭证均走环境变量（Bigin 使用.env.appStore中的ZOHO_BIGIN_CLIENT_ID/ZOHO_BIGIN_CLIENT_SECRET），但 Calendar 是唯一走管理后台录入的 Zoho 集成。

配置完成后，Calendar 集成的日常管理在/settings/my-account/calendars进行，CRM 集成则随环境变量生效，在对应设置项中添加即可。

【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy