---

name: zendesk-automation description: "通过 Rube MCP (Composio) 自动化 Zendesk 任务：工单、用户、组织、回复。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Zendesk 自动化

通过 Composio 的 Zendesk 工具包经由 Rube MCP 自动化 Zendesk 操作。

前置条件

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

设置

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

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 zendesk 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Zendesk 授权
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 列出和搜索工单

使用时机：用户想要查看、筛选或搜索支持工单

工具序列：

1. ZENDESK_LIST_ZENDESK_TICKETS - 列出所有工单（支持分页）[必需]
2. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 获取特定工单详情 [可选]

关键参数：

• page：页码（从 1 开始）
• per_page：每页结果数（最大 100）
• sort_by：排序字段（'created_at'、'updated_at'、'priority'、'status'）
• sort_order：'asc' 或 'desc'
• ticket_id：单个检索的工单 ID

注意事项：

• LIST 使用 page/per_page 分页，不是基于偏移量的；检查响应中的 next_page
• 每页最多 100 条结果；使用页码迭代直到 next_page 为 null
• 已删除的工单不会被 LIST 返回；使用 GET_BY_ID 会返回状态 'deleted'
• 工单评论和审计记录包含在 GET_BY_ID 中但不在 LIST 响应中

2. 创建和更新工单

使用时机：用户想要创建新工单或修改现有工单

工具序列：

1. ZENDESK_SEARCH_ZENDESK_USERS - 查找请求者/受理人 [前置条件]
2. ZENDESK_CREATE_ZENDESK_TICKET - 创建新工单 [必需]
3. ZENDESK_UPDATE_ZENDESK_TICKET - 更新工单字段 [可选]
4. ZENDESK_DELETE_ZENDESK_TICKET - 删除工单 [可选]

关键参数：

• subject：工单主题行
• description：工单正文（用于创建；成为第一条评论）
• priority：'urgent'、'high'、'normal'、'low'
• status：'new'、'open'、'pending'、'hold'、'solved'、'closed'
• type：'problem'、'incident'、'question'、'task'
• assignee_id：要分配的客服用户 ID
• requester_id：请求者用户 ID
• tags：标签字符串数组
• ticket_id：工单 ID（用于更新/删除）

注意事项：

• UPDATE 时的标签会完全替换现有标签；与当前标签合并以保留它们
• 使用 safe_update 配合 updated_stamp 防止并发修改冲突
• DELETE 是永久且不可逆的；工单无法恢复
• description 仅在创建时使用；创建后使用 REPLY_ZENDESK_TICKET 添加评论
• 已关闭的工单无法更新；请创建后续工单

3. 回复工单

使用时机：用户想要为工单添加评论或回复

工具序列：

1. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 获取当前工单状态 [前置条件]
2. ZENDESK_REPLY_ZENDESK_TICKET - 添加回复/评论 [必需]

关键参数：

• ticket_id：要回复的工单 ID
• body：回复文本内容
• public：布尔值；true 为公开回复，false 为内部备注
• author_id：作者用户 ID（默认为已认证用户）

注意事项：

• 设置 public: false 用于仅对客服可见的内部备注
• 默认为公开回复，会向请求者发送邮件
• 正文支持 HTML
• 回复时可以同时更新工单状态

4. 管理用户

使用时机：用户想要查找或创建 Zendesk 用户（客服、终端用户）

工具序列：

1. ZENDESK_SEARCH_ZENDESK_USERS - 搜索用户 [必需]
2. ZENDESK_CREATE_ZENDESK_USER - 创建新用户 [可选]
3. ZENDESK_GET_ABOUT_ME - 获取已认证用户信息 [可选]

关键参数：

• query：搜索字符串（匹配姓名、邮箱、电话等）
• name：用户全名（创建时必需）
• email：用户邮箱地址
• role：'end-user'、'agent' 或 'admin'
• verified：邮箱是否已验证

注意事项：

• 用户搜索是模糊匹配的；可能返回部分匹配结果
• 使用已存在的邮箱创建用户会返回现有用户（upsert 行为）
• 客服和管理员角色可能需要特定的计划功能

5. 管理组织

使用时机：用户想要列出、创建或管理组织

工具序列：

1. ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS - 列出所有组织 [必需]
2. ZENDESK_GET_ZENDESK_ORGANIZATION - 获取特定组织 [可选]
3. `ZENDESK_CREATE_ZENDESK_ORGANIZATIO