📦 Superoffice — SuperOffice

SuperOffice SuperOffice 是一个 CRM 平台，帮助企业管理销售、营销和客户服务活动。主要被中大型公司的销售、营销和客户支持团队用于改善客户关系并简化流程。SuperOffice 还提供工单和客户成功功能。 官方文档：https://developer.superoffice.com/

SuperOffice 概览 联系人 销售人员 项目选择 文档 预约 跟进 请求 工单 邮件 聊天 任务 时间登记 日记 报价 订单 订阅 产品 知识库 文章 活动 关联 文档模板 仪表板 报表 屏幕 列表 卡片 指南 搜索 通知 设置 用户组 角色 许可证 数据库 服务器 集成 应用 自定义 工作流 宏 脚本 语言 翻译 货币 国家 州 城市 地址 电话 邮箱 网址 社交媒体 备注 附件 分类 状态 优先级 原因 来源 营销活动 目标 事件 竞争对手 供应商 合作伙伴 客户 员工 经理 团队 部门 办公室 建筑 房间 设备 服务 合同 发票 付款 发货 交付 退货 保修 支持 培训 咨询 维护 升级 备份 恢复 归档 删除 合并 导入 导出 打印 发送 接收 创建 读取 更新 删除 列表 搜索 获取 查找 添加 移除 分配 取消分配 连接 断开 开始 停止 暂停 恢复 完成 批准 拒绝 转发 回复 全部回复 安排 重新安排 取消 确认 拒绝 委派 升级 通知 提醒 跟进 记录 跟踪 监控 分析 预测 计算 转换 验证 校验 认证 授权 加密 解密 签名 验证签名 备份 恢复 归档 删除 合并 导入 导出 打印 发送 接收 按需使用动作名称及参数。

使用 SuperOffice 本技能通过 Membrane CLI 与 SuperOffice 交互。Membrane 自动处理认证和凭证刷新，让你专注集成逻辑，而非认证细节。

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

认证 membrane login --tenant --clientName= 交互环境会打开浏览器认证；无头环境则打印授权 URL，提示用户打开并完成登录，看到返回的 code 后执行： membrane login complete 任何命令加 --json 可输出机器可读 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于适配对应工具链。

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

1b. 等待连接就绪 若状态为 BUILDING，轮询直至就绪： npx @membranehq/cli connection get --wait --json --wait 最长轮询 --timeout 秒（默认 30），直到状态变化。持续轮询直至非 BUILDING。结果状态说明： READY — 连接完成，跳到步骤 2。 CLIENT_ACTION_REQUIRED — 需用户或代理操作，clientAction 对象描述所需动作： clientAction.type — 动作类型："connect"（需认证）、"provide-input"（需补充信息）。 clientAction.description — 人类可读说明。 clientAction.uiUrl（可选）— 预构建 UI 地址，可展示给用户。 clientAction.agentInstructions（可选）— 给 AI 代理的编程指引。 用户完成后再次执行 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 等。