> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Zoho CRM

Zoho MCP 可让你使用所选的 Zoho CRM 工具构建 [MCP 服务器](/docs/zh/reception-ai/integrations/mcp-server)。连接后，接待员便可识别 CRM 中已有的来电者，并将新来电者添加为潜在客户。Zoho CRM 自身的 API 使用每小时过期的登录令牌，因此 Webhook 工具无法直接连接。

## 设置

### 在 Zoho 中创建 MCP 服务器

登录对应 Zoho 数据中心的 Zoho MCP 控制台，例如 `mcp.zoho.com` 或 `mcp.zoho.eu`。选择 **Create MCP Server**，输入名称，然后选择 **Create**。

### 添加 Zoho CRM 工具

打开 **Tools** 并选择 **Add Tools**。筛选 Zoho CRM，仅勾选接待员需要的工具，例如搜索记录、获取记录和创建记录的工具。选择 **Add Now**。

不要添加更新或删除记录的工具，以及更改 CRM 模块、字段或 workflow 的工具。

### 提前授权连接

Zoho 工具默认使用 **Authorize on Demand**，即工具首次运行时会要求在浏览器中登录 Zoho。接待员无法在通话期间完成登录，因此请改为在控制台中授权连接：

1. 打开 **Connections** → **Zoho Services**，选择 **Edit**，选择 **Authorize via Connections**，然后选择 **Update**。
2. 选择连接旁的菜单（**…**），然后选择 **Authorize**。
3. 以接待员应使用的 Zoho 用户身份登录，并允许访问。

工具可执行此用户 CRM 角色允许的所有操作。建议使用专用用户，其角色仅限于接待员所需的模块。

### 复制 MCP URL

打开 **Connect** 并复制 MCP URL。该 URL 包含可访问 CRM 工具的密钥，因此应将其视为机密。

### 添加 MCP 服务器

在 Reception.ai 中，前往 **集成**，选择 **添加集成**，然后选择 **MCP Server**。

| 字段          | 值               |
| ----------- | --------------- |
| **名称**      | Zoho CRM        |
| **服务器类型**   | Streamable HTTP |
| **服务器 URL** | 复制的 MCP URL     |

由于密钥已包含在 URL 中，**Secret Token** 留空。选择 **启用**。

### 分配工具

打开 **工具** 标签页，将搜索、获取和创建工具分配给 **Client**（接待员）。

### 测试

使用来自已存在于 Zoho CRM 中号码的来电，以及新来电者[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新来电者会显示为潜在客户。

> **Note**
>
> 调用 Zoho MCP 服务器会使用 Zoho CRM API 额度，与其他 API 访问相同。

## 故障排除

| 问题                  | 检查内容                                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------- |
| 未列出任何工具             | 使用 **Streamable HTTP** 服务器类型，以及 **Connect** 中的完整 URL。                                    |
| 工具因授权错误而失败          | 连接仍设为 **Authorize on Demand**，或尚未授权。请在 Zoho MCP 控制台中授权。                                  |
| 未找到已知来电者            | Zoho 会按存储格式匹配电话号码。请使用统一格式存储号码。                                                           |
| 工具显示 **Changed** 标记 | 你在 Zoho 中修改了工具。请在 **工具** 标签页中检查并选择 **更新**。                                               |
| MCP URL 被误分享        | 在 Zoho MCP 控制台的 **Connect** 下选择 **Regenerate API Key**，然后更新 Reception.ai 中的 **服务器 URL**。 |