📦 Freshdesk

Freshdesk Freshdesk 是一款云端客户支持软件，帮助企业管理和解决客户咨询。支持团队通过邮件、电话、聊天等多种渠道跟踪、优先处理并响应客户问题。主要用户包括客服坐席、支持经理，以及希望提升客服运营的各种规模企业。 官方文档：https://developers.freshdesk.com/

Freshdesk 概览 Ticket · Note · Agent 按需使用 action 名称及参数。

使用 Freshdesk 本技能通过 Membrane CLI 与 Freshdesk 交互。Membrane 自动处理认证与凭证刷新，让你专注集成逻辑，无需关心 auth 细节。

安装 CLI 全局安装 Membrane CLI，以便在终端运行 membrane： npm install -g @membranehq/cli@latest

认证 membrane login --tenant --clientName= 根据是否支持交互模式，自动打开浏览器或打印授权 URL。 无头环境：命令打印授权 URL，提示用户在浏览器打开；登录完成后获得 code，再执行： membrane login complete 任意命令加 --json 可输出机器可读 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于优化工具以适配你的 harness。

连接 Freshdesk 使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接： membrane connection ensure "https://www.freshworks.com/freshdesk/" --json 用户在浏览器完成认证，输出包含新连接 id。URL 会被规范化为域名并与已知应用匹配；未找到则自动创建应用并构建连接器。 若返回状态为 "READY"，直接跳到第 2 步。

1b. 等待连接就绪 若状态为 BUILDING，轮询直至就绪： npx @membranehq/cli connection get --wait --json --wait 最长轮询 --timeout 秒（默认 30），直到状态变化。持续轮询直到状态非 BUILDING。 结果状态说明： READY — 连接完成，跳到第 2 步。 CLIENT_ACTION_REQUIRED — 需用户或 agent 操作。clientAction 对象描述所需动作： clientAction.type — 动作类型："connect"（需认证）、"provide-input"（需补充信息）。 clientAction.description — 可读说明。 clientAction.uiUrl（可选）— 预构建 UI 地址，可展示给用户。 clientAction.agentInstructions（可选）— 给 AI agent 的编程指引。 用户完成动作后，再次执行 membrane connection get --json 检查状态是否变为 READY。 CONFIGURATION_ERROR 或 SETUP_FAILED — 出错，查看 error 字段详情。

搜索 action 用自然语言描述需求进行搜索： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 务必在特定连接上下文中搜索。结果包含 id、name、description、inputSchema、outputSchema。

常用 action Name · Key · Description List Tickets · list-tickets · 按需过滤，列出所有工单 List Contacts · list-contacts · 按需过滤，列出所有联系人 List Companies · list-companies · 按需过滤，列出所有公司 List Groups · list-groups · 列出所有组 List Agents · list-agents · 按需过滤，列出所有客服 Get Ticket · get-ticket · 按 ID 获取指定工单 Get Contact · get-contact · 按 ID 获取指定联系人 Get Company · get-company · 按 ID 获取指定公司 Get Group · get-group · 按 ID 获取指定组 Get Agent · get-agent · 按 ID 获取指定客服 Create Ticket · create-ticket · 创建新工单 Create Contact · create-contact · 创建新联系人 Create Company · create-company · 创建新公司 Update Ticket · update-ticket · 更新现有工单 Update Contact · update-contact · 更新现有联系人 Update Company · update-company · 更新现有公司 Delete Ticket · delete-ticket · 删除工单