zendesk-automation

Zendesk Automation 通过 Composio 的 Zendesk 工具包，经由 Rube MCP 实现对 Zendesk 客服系统的自动化操作。

用途 该技能用于自动化 Zendesk 中的常见客服任务，包括工单管理、用户管理、组织管理和工单回复。适合需要批量或程序化处理 Zendesk 数据的场景。

前置条件

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

设置方式

1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS，工具包选择 zendesk。
4. 若连接不是 ACTIVE，按返回的授权链接完成 Zendesk 认证。
5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流

1. 列出与搜索工单 适用场景：查看、筛选或搜索支持工单。 工具顺序：ZENDESK_LIST_ZENDESK_TICKETS（必需，分页列出所有工单）；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 分页，不是基于 offset；检查响应中的 next_page。每页最多 100 条，需按页码迭代直到 next_page 为 null。已删除工单不会由 LIST 返回，需用 GET_BY_ID，其状态为 deleted。工单评论和审计包含在 GET_BY_ID 中，但不在 LIST 响应中。

2. 创建与更新工单 适用场景：创建新工单或修改现有工单。 工具顺序：ZENDESK_SEARCH_ZENDESK_USERS（前置，查找请求者/受理人）；ZENDESK_CREATE_ZENDESK_TICKET（必需，创建工单）；ZENDESK_UPDATE_ZENDESK_TICKET（可选，更新工单字段）；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）。 注意事项：更新时 tags 会完全替换现有标签，需先合并当前标签以保留。使用 safe_update 配合 updated_stamp 防止并发修改冲突。DELETE 永久且不可逆，工单无法恢复。description 仅用于创建；创建后添加评论请用 REPLY_ZENDESK_TICKET。已关闭工单不能更新，应创建后续工单。

3. 回复工单 适用场景：向工单添加评论或回复。 工具顺序：ZENDESK_GET_ZENDESK_TICKET_BY_ID（前置，获取当前工单状态）；ZENDESK_REPLY_ZENDESK_TICKET（必需，添加回复/评论）。 关键参数：ticket_id（要回复的工单 ID）、body（回复文本内容）、public（布尔值，true 为公开回复，false 为内部备注）、author_id（作者用户 ID，默认为已认证用户）。 注意事项：内部备注仅客服可见，需设 public: false。默认是公开回复，会向请求者发送邮件。body 支持 HTML。回复同时也可更新工单状态。

4. 管理用户 适用场景：查找或创建 Zendesk 用户（客服、终端用户）。 工具顺序：ZENDESK_SEARCH_ZENDESK_USERS（必需，搜索用户）；ZENDESK_CREATE_ZENDESK_USER（可选，创建用户）；ZENDESK_GET_ABOUT_ME（可选，获取已认证用户信息）。 关键参数：query（搜索字符串，匹配姓名、邮箱、电话等）、name（用户全名，创建时必需）、email（用户邮箱）、role（end-user、agent 或 admin）、verified（邮箱是否已验证）。 注意事项：用户搜索为模糊匹配，可能返回部分匹配。使用已存在邮箱创建用户会返回现有用户（upsert 行为）。agent 和 admin 角色可能需要特定套餐功能。

5. 管理组织 适用场景：列出、创建或管理组织。 工具顺序：ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS（必需，列出所有组织）；ZENDESK_GET_ZENDESK_ORGANIZATION（可选，获取特定组织）；ZENDESK_CREATE_ZENDESK_ORGANIZATION（可选，创建组织）；ZENDESK_UPDATE_ZENDESK_ORGANIZATION（可选，更新组织）；ZENDESK_COUNT_ZENDESK_ORGANIZATIONS（可选，获取总数）。 关键参数：name（组织名称，唯一，创建时必需）、organization_id（获取/更新的组织 ID）、details（组织详情文本）、notes（内部备注）、domain_names（关联域名数组）、tags（标签字符串数组）。 注意事项：组织名称必须唯一，重复名称会导致创建错误。更新时 tags 会替换现有标签（与工单行为相同）。域名可用于自动关联用户。

常见模式 分页：列表端点使用 page（从 1 开始）和 per_page（最大 100）；检查响应中的 next_page URL，null 表示最后一页；count 字段给出总结果数。 工单生命周期：new -> open -> pending -> solved -> closed；pending 与 hold 之间可相互转换。new 为未分配工单；open 为已分配、处理中；pending 为等待客户回复；hold 为等待内部操作；solved 为已解决，可重新打开；closed 为永久关闭，不可修改。 用户搜索用于分配：1. 用 query（姓名或邮箱）调用 ZENDESK_SEARCH_ZENDESK_USERS；2. 从结果中提取用户 ID；3. 在工单创建/更新中将用户 ID 用作 assignee_id。

已知注意事项 标签行为：更新时标签会替换所有现有标签；始终先获取当前标签并在更新前合并；标签为小写，无空格（使用下划线）。 安全更新：使用 safe_update: true 配合 updated_stamp（ISO 8601）防止冲突；若工单自该时间戳后被修改，返回 409。 删除：工单删除永久且不可逆；考虑将状态设为 closed 而非删除；已删除工单无法通过 API 恢复。 速率限制：默认每分钟 400 次请求；因套餐层级而异；429 响应包含 Retry-After 头。

快速参考 任务与工具对应：列出工单 ZENDESK_LIST_ZENDESK_TICKETS（page、per_page、sort_by）；获取工单 ZENDESK_GET_ZENDESK_TICKET_BY_ID（ticket_id）；创建工单 ZENDESK_CREATE_ZENDESK_TICKET（subject、description、priority）；更新工单 ZENDESK_UPDATE_ZENDESK_TICKET（ticket_id、status、tags）；回复工单 ZENDESK_REPLY_ZENDESK_TICKET（ticket_id、body、public）；删除工单 ZENDESK_DELETE_ZENDESK_TICKET（ticket_id）；搜索用户 ZENDESK_SEARCH_ZENDESK_USERS（query）；创建用户 ZENDESK_CREATE_ZENDESK_USER（name、email）；我的资料 ZENDESK_GET_ABOUT_ME（无）；列出组织 ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS（page、per_page）；获取组织 ZENDESK_GET_ZENDESK_ORGANIZATION（organization_id）；创建组织 ZENDESK_CREATE_ZENDESK_ORGANIZATION（name）；更新组织 ZENDESK_UPDATE_ZENDESK_ORGANIZATION（organization_id、name）；统计组织 ZENDESK_COUNT_ZENDESK_ORGANIZATIONS（无）。