SugarCRM

SugarCRM SugarCRM 是一个客户关系管理（CRM）平台。它帮助销售、营销和客户服务团队在整个客户生命周期中管理客户互动和数据。各大小企业都使用它来提高销售业绩、营销效果和客户满意度。 官方文档：https://support.sugarcrm.com/Documentation/ SugarCRM 概述 账户 联系人 潜在客户 机会 任务 会议 电话 备注 使用 SugarCRM 本技能使用 Membrane CLI 与 SugarCRM 交互。Membrane 处理身份验证和凭证刷新，因此您可以专注于集成逻辑而不是身份验证。 安装 CLI 安装 Membrane CLI，以便您可以从终端运行 membrane： npm install -g @membranehq/cli@latest 身份验证 membrane login --tenant --clientName= 这将打开浏览器进行身份验证或在控制台打印授权 URL，具体取决于是否可用交互模式。 无头环境：命令将打印授权 URL。请用户在浏览器中打开它。 当他们完成登录后看到代码时，完成以下操作： membrane login complete 将 --json 添加到任何命令以获取机器可读的 JSON 输出。 代理类型：claude、openclaw、codex、warp、windsurf 等。这些将用于调整工具以便与您的工具包配合使用。 连接到 SugarCRM 使用 membrane connection ensure 查找或创建连接，方法是使用应用程序 URL 或域： membrane connection ensure "https://www.sugarcrm.com/" --json 用户在浏览器中完成身份验证。输出包含新的连接 ID。这是获取连接的最快方法。URL 被规范化为域，并与已知应用程序进行匹配。如果找不到应用程序，则创建一个应用程序并自动构建连接器。 如果返回的连接具有状态："READY"，则跳转到步骤 2。 1b. 等待连接就绪 如果连接处于 BUILDING 状态，请轮询直到它就绪： npx @membranehq/cli connection get --wait --json --wait 标志长轮询（最多 --timeout 秒，默认 30）直到状态更改。继续轮询直到状态不再是 BUILDING。结果状态告诉您下一步该做什么： READY — 连接已完全设置。跳转到步骤 2。 CLIENT_ACTION_REQUIRED — 用户或代理需要执行某个操作。clientAction 对象描述了所需的操作： clientAction.type — 所需操作的类型："connect" — 用户需要身份验证（OAuth、API 密钥等）。这涵盖了初始身份验证和断开连接的重新身份验证。 "provide-input" — 需要更多信息（例如要连接到的应用程序）。 clientAction.description — 对所需操作的可读说明。 clientAction.uiUrl（可选）— 用户可以完成操作的预建 UI 的 URL。当存在时，请向用户显示。 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（操作返回的内容）。 热门操作 名称 关键字 描述 过滤相关记录 filter-related-records 获取通过特定关系与父记录相关的过滤记录 创建任务 create-task 在 SugarCRM 中创建新任务 将备注添加到记录 add-note-to-record 将备注添加到任何记录（账户、联系人、潜在客户、机会等） 批量 API 请求 bulk-api-request 在单个调用中执行多个 API 请求以最小化往返 列出模块 list-modules 获取 SugarCRM 中所有可用模块的列表 获取模块元数据 get-module-metadata 获取特定模块的元数据（字段、关系等） 获取当前用户 get-current-user 获取有关当前身份验证用户的信息 解除记录链接 unlink-records 删除记录与相关记录之间的关系 链接记录 link-records 在记录与一个或多个相关记录之间创建关系 获取相关记录 get-related-records 通过特定关系获取与父记录相关的记录 搜索记录 search-records 使用简单的查询字符串在模块中搜索记录 删除记录 delete-record 从任何模块中删除记录（软删除） 更新记录 update-record 更新任何模块中的现有记录 创建记录 create-record 在任何模块中创建新记录 获取记录 get-record