跳到导航
集成设置指南支持

Freshdesk

通过 webhook 工具根据通话创建 Freshdesk 工单。

借助 webhook 工具，当来电者报告问题或寻求帮助时，接待员可创建 Freshdesk 工单，方便团队跟进。Growth、Pro 和 Enterprise 计划还可连接 Freshdesk 的 MCP 服务器，查询现有工单。

创建工单

1

获取 API 密钥

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

2

创建授权标头

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

printf 'YOUR_API_KEY:X' | base64

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

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

3

创建 webhook 工具

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

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

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

4

测试

通过报告一个问题来测试接待员。工单会显示在 Freshdesk 中。

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

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

使用 MCP 服务器查询工单

Freshdesk 的 MCP 服务器适用于 Growth、Pro 和 Enterprise 计划。可使用它让接待员查询来电者的现有工单。MCP 操作会计入年度额度，具体额度取决于计划。

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

字段值
名称Freshdesk
服务器类型Streamable HTTP
服务器 URLhttps://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。