---

name: freshdesk-automation description: "通过 Rube MCP (Composio) 自动化 Freshdesk 帮助台操作，包括工单、联系人、公司、备注和回复。始终先搜索工具以获取当前架构。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Freshdesk 自动化

通过 Composio 的 Freshdesk 工具包自动化 Freshdesk 客户支持工作流程，包括工单管理、联系人和公司操作、备注、回复和工单搜索。

前提条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 freshdesk 建立活跃的 Freshdesk 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 通过确认 RUBE_SEARCH_TOOLS 响应来验证 Rube MCP 可用
2. 使用工具包 freshdesk 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Freshdesk 认证
4. 在运行任何工作流程之前确认连接状态显示 ACTIVE

核心工作流程

1. 创建和管理工单

何时使用：用户想要创建新的支持工单、更新现有工单或查看工单详情。

工具序列：

1. FRESHDESK_SEARCH_CONTACTS - 通过邮箱查找请求者以获取 requester_id [可选]
2. FRESHDESK_LIST_TICKET_FIELDS - 检查可用的自定义字段和状态 [可选]
3. FRESHDESK_CREATE_TICKET - 创建包含主题、描述、请求者信息的新工单 [必需]
4. FRESHDESK_UPDATE_TICKET - 修改工单状态、优先级、受理人或其他字段 [可选]
5. FRESHDESK_VIEW_TICKET - 通过 ID 检索完整工单详情 [可选]

FRESHDESK_CREATE_TICKET 关键参数：

• subject：工单主题（必需）
• description：工单的 HTML 内容（必需）
• email：请求者邮箱（至少需要一个请求者标识符）
• requester_id：请求者的用户 ID（email 的替代方案）
• status：2=打开, 3=待处理, 4=已解决, 5=已关闭（默认 2）
• priority：1=低, 2=中, 3=高, 4=紧急（默认 1）
• source：1=邮件, 2=门户, 3=电话, 7=聊天（默认 2）
• responder_id：分配工单的客服 ID
• group_id：分配工单的组
• tags：标签字符串数组
• custom_fields：带有 cf_<field_name> 键的对象

注意事项：

• 至少需要一个请求者标识符：requester_id、email、phone、facebook_id、twitter_id 或 unique_external_id
• 如果提供了 phone 但没有 email，则 name 变为必填
• description 支持 HTML 格式
• attachments 字段期望 multipart/form-data 格式，而非文件路径或 URL
• 自定义字段键必须以 cf_ 为前缀（例如 cf_reference_number）
• status 和 priority 是整数，不是字符串

2. 搜索和筛选工单

何时使用：用户想要按状态、优先级、日期范围、客服或自定义字段查找工单。

工具序列：

1. FRESHDESK_GET_TICKETS - 使用简单筛选器列出工单（状态、优先级、客服）[必需]
2. FRESHDESK_GET_SEARCH - 使用查询语法进行高级工单搜索 [必需]
3. FRESHDESK_VIEW_TICKET - 获取搜索结果中特定工单的完整详情 [可选]
4. FRESHDESK_LIST_TICKET_FIELDS - 检查搜索查询可用的字段 [可选]

FRESHDESK_GET_TICKETS 关键参数：

• status：按状态整数筛选（2=打开, 3=待处理, 4=已解决, 5=已关闭）
• priority：按优先级整数筛选（1-4）
• agent_id：按分配的客服筛选
• requester_id：按请求者筛选
• email：按请求者邮箱筛选
• created_since：ISO 8601 时间戳
• page / per_page：分页（默认每页 30 条）
• sort_by / sort_order：排序字段和方向

FRESHDESK_GET_SEARCH 关键参数：

• query：查询字符串，如 "status:2 AND priority:3" 或 "(created_at:>'2024-01-01' AND tag:'urgent')"
• page：页码（1-10，最多 300 条结果）

注意事项：

• FRESHDESK_GET_SEARCH 查询必须用双引号括起来
• 查询字符串限制为 512 个字符
• 搜索端点最多 10 页（300 条结果）
• 查询中的日期字段使用 UTC 格式 YYYY-MM-DD
• 使用 null 关键字查找空字段的工单（例如 "agent_id:null"）
• FRESHDESK_LIST_ALL_TICKETS 不接受参数并返回所有工单（使用 GET_TICKETS 进行筛选）

3. 回复工单和添加备注

何时使用：用户想要向客户发送回复、添加内部备注或查看对话历史。

工具序列：

1. FRESHDESK_VIEW_TICKET - 验证工单存在并检查当前状态 [前提条件]
2. FRESHDESK_REPLY_TO_TICKET - 向请求者发送公开回复 [必需]
3. FRESHDESK_ADD_NOTE_TO_TICKET - 添加私有或公开备注 [必需]
4. FRESHDESK_LIST_ALL_TICKET_CONVERSATIONS - 查看所有消息