⚡

Zendesk自动化技能Skill zendesk-automation

该技能用于通过Rube MCP自动化Zendesk客户支持平台的操作，包括工单管理、用户搜索、组织管理等，实现高效工作流和API集成。关键词：Zendesk自动化，Rube MCP，工单管理，用户搜索，API集成，客户支持，自动化工具。

DevOps 0 次安装 0 次浏览 更新于 3/8/2026

name: zendesk-automation description: “通过Rube MCP（Composio）自动化Zendesk任务：工单、用户、组织、回复。始终首先搜索工具以获取当前模式。” requires: mcp: [rube] category: customer-support

通过Rube MCP进行Zendesk自动化

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

工具包文档: composio.dev/toolkits/zendesk

前提条件

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

设置

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

  1. 通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP可用
  2. 使用工具包zendesk调用RUBE_MANAGE_CONNECTIONS
  3. 如果连接未激活，请按照返回的认证链接完成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: 邮箱是否已验证

常见问题:

  • 用户搜索是模糊的；可能返回部分匹配
  • 使用现有邮箱创建用户会返回现有用户（更新插入行为）
  • 代理和管理员角色可能需要特定计划功能

5. 管理组织

使用时机: 用户希望列出、创建或管理组织

工具序列:

  1. ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS - 列出所有组织 [必需]
  2. ZENDESK_GET_ZENDESK_ORGANIZATION - 获取特定组织 [可选]
  3. ZENDESK_CREATE_ZENDESK_ORGANIZATION - 创建组织 [可选]
  4. ZENDESK_UPDATE_ZENDESK_ORGANIZATION - 更新组织 [可选]
  5. ZENDESK_COUNT_ZENDESK_ORGANIZATIONS - 获取总数 [可选]

关键参数:

  • name: 组织名称（唯一，创建必需）
  • organization_id: 用于获取/更新的组织ID
  • details: 组织详情文本
  • notes: 内部备注
  • domain_names: 关联域名数组
  • tags: 标签字符串数组

常见问题:

  • 组织名称必须唯一；重复名称会导致创建错误
  • UPDATE上的标签替换现有标签（与工单行为相同）
  • 域名可用于自动用户关联

常见模式

分页

列表端点:

  • 使用page（基于1）和per_page（最大100）
  • 检查响应中的next_page URL；null表示最后一页
  • count字段给出总结果数

工单生命周期

new -> open -> pending -> solved -> closed
                  |          ^
                  v          |
                hold --------+
  • new: 未分配工单
  • open: 已分配，正在处理中
  • pending: 等待客户回复
  • hold: 等待内部操作
  • solved: 已解决，可重新打开
  • closed: 永久关闭，无法修改

用户搜索以进行分配

1. 使用查询（姓名或邮箱）调用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 (无)

由Composio提供支持