
关于
通过 Rube MCP(Composio)自动化 Zendesk 任务:工单、用户、组织、回复。使用前先搜索工具获取当前 Schema。
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 密钥——只需添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS响应以验证 Rube MCP 可用 - 使用工具包
zendesk调用RUBE_MANAGE_CONNECTIONS - 如果连接不是 ACTIVE 状态,按照返回的认证链接完成 Zendesk 授权
- 确认连接状态显示 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分页,不是基于偏移量的;检查响应中的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:要分配的客服用户 IDrequester_id:请求者用户 IDtags:标签字符串数组ticket_id:工单 ID(用于更新/删除)
注意事项:
- UPDATE 时的标签会完全替换现有标签;与当前标签合并以保留它们
- 使用
safe_update配合updated_stamp防止并发修改冲突 - DELETE 是永久且不可逆的;工单无法恢复
description仅在创建时使用;创建后使用 REPLY_ZENDESK_TICKET 添加评论- 已关闭的工单无法更新;请创建后续工单
3. 回复工单
使用时机:用户想要为工单添加评论或回复
工具序列:
ZENDESK_GET_ZENDESK_TICKET_BY_ID- 获取当前工单状态 [前置条件]ZENDESK_REPLY_ZENDESK_TICKET- 添加回复/评论 [必需]
关键参数:
ticket_id:要回复的工单 IDbody:回复文本内容public:布尔值;true 为公开回复,false 为内部备注author_id:作者用户 ID(默认为已认证用户)
注意事项:
- 设置
public: false用于仅对客服可见的内部备注 - 默认为公开回复,会向请求者发送邮件
- 正文支持 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 行为)
- 客服和管理员角色可能需要特定的计划功能
5. 管理组织
使用时机:用户想要列出、创建或管理组织
工具序列:
ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS- 列出所有组织 [必需]ZENDESK_GET_ZENDESK_ORGANIZATION- 获取特定组织 [可选]- `ZENDESK_CREATE_ZENDESK_ORGANIZATIO
兼容工具
Claude CodeCursor
标签
后端开发
