> 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.

# Freshdesk

借助 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，当来电者报告问题或寻求帮助时，接待员可创建 Freshdesk 工单，方便团队跟进。Growth、Pro 和 Enterprise 计划还可连接 Freshdesk 的 [MCP 服务器](#look-up-tickets-with-the-mcp-server)，查询现有工单。

## 创建工单

### 获取 API 密钥

在 Freshdesk 中，选择个人资料图片，打开 **Profile settings**，然后选择 **View API key**。复制密钥。它会作为智能体账户，因此创建工单时会使用你的权限。

### 创建授权标头

Freshdesk 将 API 密钥作为用户名，并以 `X` 作为密码。在终端中进行编码，将 `YOUR_API_KEY` 替换为你的密钥：

```bash
printf 'YOUR_API_KEY:X' | base64
```

标头值为 `Basic `，后接输出结果。

> **Warning**
>
> 不要将 API 密钥粘贴到在线编码工具中。任何拥有该密钥或编码后标头的人都可以
> 读取和修改工单。

### 创建 webhook 工具

前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                                                                                                                                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**     | `create_freshdesk_ticket`                                                                                                                                                                                                                                           |
| **描述**     | "当来电者报告问题或需要团队协助时，创建支持工单。"                                                                                                                                                                                                                                          |
| **方法**     | POST                                                                                                                                                                                                                                                                |
| **URL**    | `https://YOURDOMAIN.freshdesk.com/api/v2/tickets`                                                                                                                                                                                                                   |
| **请求标头**   | `Authorization`：`Basic `，后接编码后的密钥                                                                                                                                                                                                                                   |
| **正文参数**   | `name`（字符串，必填）：“来电者全名。”  `phone`（字符串）：“来电者的电话号码。”  `email`（字符串）：“来电者提供的电子邮箱地址（如有）。”  `subject`（字符串，必填）：“问题的简短摘要。”  `description`（字符串，必填）：“来电者报告的内容，使用其原话并包含提供的任何详情。”  `status`（数字，必填）：“始终为精确值 `2`。”  `priority`（数字，必填）：“始终为精确值 `1`。”  `source`（数字，必填）：“始终为精确值 `3`。” |
| **分配给智能体** | **Receptionist**                                                                                                                                                                                                                                                    |

将 `YOURDOMAIN` 替换为 Freshdesk 子域名。选择 **Enable**。

### 测试

通过报告一个问题来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。工单会显示在 Freshdesk 中。

这些固定值会将工单创建为 **Open**（状态 `2`）、**Low** 优先级（优先级 `1`），并标记为来自 **Phone**（来源 `3`）。如需让接待员设置优先级，请改为说明这些值，例如：“1 为低，2 为中，3 为高，4 为紧急。”

Freshdesk 需要电话号码或电子邮箱来查找或创建请求者。请告知接待员始终收集来电者的电话号码。

## 使用 MCP 服务器查询工单

Freshdesk 的 [MCP 服务器](/docs/zh/reception-ai/integrations/mcp-server)适用于 Growth、Pro 和 Enterprise 计划。可使用它让接待员查询来电者的现有工单。MCP 操作会计入年度额度，具体额度取决于计划。

在 Reception.ai 中，前往 **Integrations**，选择 **Add integration**，然后选择 **MCP Server**。

| 字段          | 值                                      |
| ----------- | -------------------------------------- |
| **名称**      | Freshdesk                              |
| **服务器类型**   | Streamable HTTP                        |
| **服务器 URL** | `https://YOURDOMAIN.freshdesk.com/mcp` |
| **HTTP 标头** | `Authorization`：API 密钥，无前缀             |

将 **Secret Token** 留空，这样 Reception.ai 会完全按输入内容发送 `Authorization` 标头。即使使用自定义域名，也请使用 `freshdesk.com` 子域名。选择 **Enable**。

打开 **Tools** 标签页，向 **Client**（接待员）分配工单查询工具，例如 `fetchSearchTickets` 和 `fetchTicket`。不要分配会更新工单、智能体、群组或文章的工具。

## 故障排除

| 问题               | 检查内容                                                                              |
| ---------------- | --------------------------------------------------------------------------------- |
| Freshdesk 返回 401 | 在密钥后添加 `:X` 再编码，并让标头值以 `Basic ` 和一个空格开头。                                          |
| 400 请求者相关错误      | 工单需要电话号码或电子邮箱，以及姓名。确保接待员收集这些信息。                                                   |
| 400 状态或优先级相关错误   | `status`、`priority` 和 `source` 必须是数字参数，而非字符串。                                     |
| MCP 服务器未列出工具     | 使用 `freshdesk.com` 子域名，并在 `Authorization` 标头中填入原始 API 密钥，不要添加 `Basic` 或 `Bearer`。 |