Freshdesk Automation 通过 Rube MCP（Composio）将 Freshdesk 客服系统接入自动化工作流，用于处理工单、联系人、公司、备注和回复等客服操作。
用途 该技能面向 Freshdesk 客服场景的自动化，包括工单管理、联系人与公司操作、备注与回复，以及工单搜索。所有操作通过 Composio 的 Freshdesk 工具包完成。
前置条件
- 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
- 需通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Freshdesk 连接，工具包为 freshdesk。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。
设置方式
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包选择 freshdesk。
- 若连接不是 ACTIVE，按返回的授权链接完成 Freshdesk 认证。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
主要能力
- 创建与管理工单：可创建新工单、更新工单状态/优先级/受理人/其他字段、按 ID 查看工单详情。创建工单关键参数包括 subject（必填）、description（必填，支持 HTML）、email 或 requester_id（至少一个请求者标识）、status（2=Open，3=Pending，4=Resolved，5=Closed，默认 2）、priority（1=Low，2=Medium，3=High，4=Urgent，默认 1）、source（1=Email，2=Portal，3=Phone，7=Chat，默认 2）、responder_id、group_id、tags、custom_fields（键需以 cf_ 前缀）。注意：至少需要一个请求者标识（requester_id、email、phone、facebook_id、twitter_id 或 unique_external_id）；若仅提供 phone 而无 email，则 name 为必填；attachments 需 multipart/form-data 格式，而非文件路径或 URL；状态与优先级为整数而非字符串。
- 搜索与筛选工单：可用 FRESHDESK_GET_TICKETS 按状态、优先级、受理人、请求者、邮箱、created_since 等简单条件筛选，支持分页（默认每页 30）、排序；也可用 FRESHDESK_GET_SEARCH 进行高级查询，如 "status:2 AND priority:3" 或 "(created_at:>'2024-01-01' AND tag:'urgent')"。注意：查询字符串需用双引号包裹，长度上限 512 字符，最多 10 页（300 条结果），日期使用 UTC 格式 YYYY-MM-DD，可用 null 查找空字段（如 "agent_id:null"）；FRESHDESK_LIST_ALL_TICKETS 无参数并返回全部工单。
- 回复与备注：可向请求者发送公开回复、添加内部或公开备注、查看工单全部会话、编辑已有备注。回复关键参数：ticket_id（必填）、body（必填，支持 HTML）、cc_emails/bcc_emails（to/cc/bcc 合计最多 50）、from_email、user_id。备注关键参数：ticket_id、body、private（默认 true 仅客服可见，false 为公开）、notify_emails（仅接受客服邮箱，不接受外部联系人）。注意：回复工具有 FRESHDESK_REPLY_TO_TICKET（功能更多）与 FRESHDESK_REPLY_TICKET（更简单）两个；仅备注可通过 FRESHDESK_UPDATE_CONVERSATIONS 编辑，收到的回复不可编辑。
- 联系人与公司管理：可搜索联系人（按邮箱、电话或公司）、列出联系人、从 CSV 批量导入联系人；可搜索公司（按自定义字段）、列出全部公司、创建公司、更新公司、查看公司字段。创建公司关键参数：name（必填）、domains（用于按邮箱域名自动关联联系人）、health_score（"Happy"、"Doing okay"、"At risk"）、account_tier（"Basic"、"Premium"、"Enterprise"）、industry。注意：联系人搜索要求精确匹配，不支持部分或正则搜索；公司搜索不能按标准 name 字段搜索，需用自定义字段或 created_at；公司自定义字段不使用 cf_ 前缀（与工单自定义字段不同）；联系人搜索查询中字符串值需用单引号，外层用双引号。
常见模式
- ID 解析：操作前先将显示值解析为 ID。请求者邮箱转 requester_id 用 FRESHDESK_SEARCH_CONTACTS 查询 "email:'user@example.com'"；公司名转 company_id 用 FRESHDESK_GET_COMPANIES 按名称匹配（不支持按名称搜索）；客服名转 agent_id 无直接方式，可从工单响应或管理配置中获取。
- 分页：Freshdesk 使用基于页的分页。FRESHDESK_GET_TICKETS 使用 page（从 1 开始）与 per_page（最大 100）；FRESHDESK_GET_SEARCH 使用 page（1-10，每页 30，最多 300 条）；FRESHDESK_SEARCH_CONTACTS 使用 page（1-10，每页 30）；FRESHDESK_LIST_ALL_TICKET_CONVERSATIONS 使用 page 与 per_page（最大 100）。
已知限制
- ID 格式：工单、联系人、公司、客服、组 ID 均为整数，Freshdesk 无字符串 ID。
- 速率限制：Freshdesk 按套餐层级实施每账户 API 速率限制，批量操作应控制节奏以避免 429 响应；搜索端点最多 300 条结果（10 页 × 30）。
- 参数特性：状态值 2=Open、3=Pending、4=Resolved、5=Closed；优先级 1=Low、2=Medium、3=High、4=Urgent；来源 1=Email、2=Portal、3=Phone、7=Chat、9=Feedback Widget、10=Outbound Email；工单自定义字段用 cf_ 前缀，公司自定义字段不用；工单 description 支持 HTML；搜索查询字符串需双引号包裹，字符串值用单引号；FRESHDESK_LIST_ALL_TICKETS 无筛选参数。
- 响应结构：工单详情包含请求者、受理人和会话数据的嵌套对象；搜索结果分页最多 300 条；会话列表按时间顺序包含回复与备注。
适用场景 适用于需要在自动化流程中批量或按条件处理 Freshdesk 工单、维护联系人与公司记录、发送客服回复或添加内部备注的客服与支持团队。
限制 使用前必须完成 Rube MCP 与 Freshdesk 连接；具体可用工具以 RUBE_SEARCH_TOOLS 返回的最新结构为准。