freshdesk-automation

Freshdesk Automation - Rube MCP 客服自动化技能

技能概述

通过 Rube MCP (Composio) 自动化 Freshdesk 客服工作流程，包括工单创建、搜索过滤、回复备注以及联系人和公司管理。

适用场景

1. 客服团队工单自动化

客服团队可以使用此技能自动创建、更新和分配 Freshdesk 工单，减少手动操作时间。支持设置工单优先级、状态、标签以及自定义字段，实现标准化工单处理流程。

2. 客户信息集中管理

通过联系人和公司管理功能，快速搜索和创建客户档案，支持按邮箱、电话或域名自动关联工单。批量导入联系人功能帮助快速搭建客户数据库。

3. 工单批量处理与搜索

使用高级搜索语法按状态、优先级、日期范围或自定义字段筛选工单，快速定位需要处理的请求。支持最多 300 条结果的分页查询，方便批量操作。

核心功能

工单全生命周期管理

创建工单时支持指定请求者、分配客服人员、设置优先级和来源，并可添加 HTML 格式描述。更新工单可修改状态（开放/待处理/已解决/已关闭）、分配人员和自定义字段。

工单搜索与过滤

提供两种搜索方式：简单过滤（按状态、优先级、客服人员）和高级查询（支持复杂条件组合）。搜索语法支持日期范围、标签匹配和空值检测，如 "status:2 AND priority:3" 或 "agent_id:null"。

回复与备注管理

支持向客户发送公开回复（可抄送/BCC 其他邮箱）以及添加内部备注（仅客服可见）。备注默认私有，可设置为公开让客户也能看到。支持查看完整对话历史和编辑已有备注。

联系人与公司操作

按邮箱精确搜索联系人，获取客户 ID 用于工单创建。创建公司时可配置域名自动关联、健康度评分、账户等级和行业分类。注意公司自定义字段不需要 cf_ 前缀。

常见问题

Freshdesk Automation 需要什么前置条件？

需要先连接 Rube MCP 服务器（添加 https://rube.app/mcp），然后通过 RUBE_MANAGE_CONNECTIONS 建立 Freshdesk 连接。首次使用需按返回的认证链接完成 Freshdesk 授权，确保连接状态为 ACTIVE 后才能使用功能。

Freshdesk 工单状态和优先级有哪些值？

状态使用整数表示：2=开放，3=待处理，4=已解决，5=已关闭。优先级：1=低，2=中，3=高，4=紧急。来源类型：1=邮件，2=门户，3=电话，7=聊天。创建工单时至少需要提供请求者标识（email 或 requester_id）。

Freshdesk 自动化有哪些使用限制？

搜索 API 最多返回 300 条结果（10 页 × 30 条），联系人和公司搜索不支持模糊匹配。工单自定义字段需要 cf_ 前缀，但公司自定义字段不需要。注意 Freshdesk 有账户级别的 API 调用频率限制，批量操作建议适当分批执行。