📦 Zendesk
v1.0.4Zendesk 集成。管理客户成功、工单数据、记录和工作流。在用户需要与 Zendesk 数据交互时使用。
详细分析 ▾
运行时依赖
安装命令
点击复制技能文档
Zendesk Zendesk 是一个客户服务与互动平台,各种规模的企业用它管理支持工单、提供自助服务,并在多渠道与客户互动。支持团队、客户成功经理和销售团队常用 Zendesk。 官方文档:https://developer.zendesk.com/
Zendesk 概览 工单评论 用户
按需使用动作名称和参数。
使用 Zendesk 本技能通过 Membrane CLI 与 Zendesk 交互。Membrane 自动处理认证与凭证刷新,让你专注集成逻辑,而非鉴权细节。
安装 CLI 全局安装 Membrane CLI,以便在终端运行 membrane: npm install -g @membranehq/cli@latest
认证
membrane login --tenant --clientName=
交互环境会打开浏览器;无头环境将打印授权 URL,让用户在浏览器打开。完成后获得验证码,再执行:
membrane login complete
任意命令加 --json 可输出机器可读 JSON。
Agent 类型:claude、openclaw、codex、warp、windsurf 等,用于优化工具以适配你的 harness。
连接 Zendesk
用 membrane connection ensure 按应用 URL 或域名查找或创建连接:
membrane connection ensure "https://zendesk.com/" --json
用户在浏览器完成认证,输出包含新连接 id。URL 会被归一化为域名并与已知应用匹配;未匹配则自动创建并构建连接器。
若返回 state:"READY",直接跳到步骤 2。
1b. 等待连接就绪
若状态为 BUILDING,轮询直至就绪:
npx @membranehq/cli connection get --wait --json
--wait 最长轮询 --timeout 秒(默认 30),直到状态变化。结果状态说明下一步:
READY — 连接完成,跳到步骤 2。
CLIENT_ACTION_REQUIRED — 需用户或 agent 操作。clientAction 对象描述所需动作:
clientAction.type — 动作类型:
"connect":用户需认证(OAuth、API key 等)。
"provide-input":需补充信息(如选择应用)。
clientAction.description — 人类可读说明。
clientAction.uiUrl(可选)— 预构建 UI 地址,可展示给用户。
clientAction.agentInstructions(可选)— 给 AI agent 的编程指引。
用户完成动作后,再次轮询 membrane connection get --json,确认状态变为 READY。
CONFIGURATION_ERROR 或 SETUP_FAILED — 出错,查看 error 字段。
搜索动作
用自然语言描述需求并搜索:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
务必在特定连接上下文中搜索。结果包含 id、name、description、inputSchema、outputSchema。
常用动作
名称 | 键 | 描述
可分配组列表 | list-assignable-groups | 列出可分配工单的组
获取组 | get-group | 按 ID 获取特定组
列出所有组 | list-groups | 列出 Zendesk 所有组
删除组织 | delete-organization | 删除组织
更新组织 | update-organization | 更新组织属性
创建组织 | create-organization | 新建组织
获取组织 | get-organization | 按 ID 获取组织
列出所有组织 | list-organizations | 列出所有组织
当前用户 | get-current-user | 获取当前认证用户
更新用户 | update-user | 更新用户属性
创建用户 | create-user | 新建用户
获取用户 | get-user | 按 ID 获取用户
列出用户 | list-users | 带过滤地列出用户
列工单评论 | list-ticket-comments | 获取指定工单全部评论
搜索 | search | 用统一搜索 API 查找工单、用户、组织
删除工单 | delete-ticket | 永久删除工单(仅管理员)或标记为垃圾
更新工单 | update-ticket | 更新工单属性
创建工单 | create-ticket | 新建支持工单
获取工单 | get-ticket | 按 ID 获取工单