zendesk-automation - SKILL

name: zendesk-automationdescription: “Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.”risk: criticalsource: communitydate_added: “2026-02-27”通过 Rube MCP 自动化 Zendesk通过 Rube MCP 使用 Composio 的 Zendesk 工具包自动化 Zendesk 操作。前置条件必须已连接 Rube MCPRUBE_SEARCH_TOOLS可用通过RUBE_MANAGE_CONNECTIONS使用工具包zendesk建立活跃的 Zendesk 连接始终先调用RUBE_SEARCH_TOOLS获取当前工具模式设置获取 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每页结果数最大 100sort_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要分配的处理人用户 IDrequester_id请求者用户 IDtags标签字符串数组ticket_id工单 ID用于更新/删除陷阱UPDATE 上的标签会完全替换现有标签与当前标签合并以保留它们使用带updated_stamp的safe_update防止并发修改冲突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_ORGANIZATION- 创建组织 [可选]ZENDESK_UPDATE_ZENDESK_ORGANIZATION- 更新组织 [可选]ZENDESK_COUNT_ZENDESK_ORGANIZATIONS- 获取总数 [可选]关键参数name组织名称唯一创建时必需organization_id用于获取/更新的组织 IDdetails组织详情文本notes内部备注domain_names关联域名数组tags标签字符串数组陷阱组织名称必须唯一重复名称会导致创建错误UPDATE 上的标签会替换现有标签与工单行为相同域名可用于自动关联用户常见模式分页列表端点使用page从 1 开始和per_page最大 100检查响应中的next_pageURL为 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已知陷阱标签行为更新时的标签会替换所有现有标签始终先获取当前标签并在更新前合并标签为小写无空格使用下划线安全更新使用带updated_stampISO 8601的safe_update: true防止冲突如果工单自该时间戳后被修改返回 409删除工单删除是永久且不可逆的考虑将状态设为 ‘closed’ 而不是删除已删除的工单无法通过 API 恢复速率限制默认每分钟 400 个请求因套餐级别而异429 响应包含 Retry-After 头快速参考任务工具 Slug关键参数列出工单ZENDESK_LIST_ZENDESK_TICKETSpage, per_page, sort_by获取工单ZENDESK_GET_ZENDESK_TICKET_BY_IDticket_id创建工单ZENDESK_CREATE_ZENDESK_TICKETsubject, description, priority更新工单ZENDESK_UPDATE_ZENDESK_TICKETticket_id, status, tags回复工单ZENDESK_REPLY_ZENDESK_TICKETticket_id, body, public删除工单ZENDESK_DELETE_ZENDESK_TICKETticket_id搜索用户ZENDESK_SEARCH_ZENDESK_USERSquery创建用户ZENDESK_CREATE_ZENDESK_USERname, email我的资料ZENDESK_GET_ABOUT_ME(无)列出组织ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONSpage, per_page获取组织ZENDESK_GET_ZENDESK_ORGANIZATIONorganization_id创建组织ZENDESK_CREATE_ZENDESK_ORGANIZATIONname更新组织ZENDESK_UPDATE_ZENDESK_ORGANIZATIONorganization_id, name统计组织ZENDESK_COUNT_ZENDESK_ORGANIZATIONS(无)何时使用此技能适用于执行概述中描述的工作流或操作。局限性仅当任务与上述范围明确匹配时使用此技能。不要把输出视为特定环境验证、测试或专家审查的替代品。如果缺少必要的输入、权限、安全边界或成功标准停下来请求澄清。