Vtiger

Vtiger Vtiger 是一个 CRM 平台，帮助企业管理其销售、营销和客户支持活动。它被销售团队、营销部门和客户服务代表用来简化工作流程和改善客户关系。 官方文档：https://www.vtiger.com/docs/ Vtiger 概述 联系人 潜在客户 账户 报价 销售订单 发票 产品 服务 文档 电子邮件 短信 活动 供应商 采购订单 价格书 活动 事件 任务 评论 群组 用户 角色 个人资料 货币 税费 库存调整 项目 项目任务 项目里程碑 资产 服务合同 帮助台 自定义模块

使用 Vtiger 该技能使用 Membrane CLI 与 Vtiger 交互。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 等。这些将用于调整工具以最好地与您的工具架一起使用。

连接到 Vtiger 使用 membrane connection 确保找到或创建一个连接，方法是使用应用程序 URL 或域：membrane connection ensure "" --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（操作返回的内容）。

热门操作 名称 密钥 描述 删除记录 delete-record 按 ID 删除记录 更新记录 update-record 更新现有记录。 检索记录 retrieve-record 按 ID 检索特定记录 创建记录 create-record 在指定模块中创建新记录 查询记录 query-records 使用 Vtiger 的类似 SQL 的查询语言查询记录 描述模块 describe-module 检索有关特定模块的详细元数据，包括字段定义、块和权限 列出模块 list-modules 列出当前用户可访问的所有可用模块（实体类型） 获取当前用户 get-current-user 检索有关当前已身份验证用户的信息

运行操作 membrane action run --connectionId=CONNECTION_ID --json 要传递 JSON 参数：membrane action run --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 结果在响应的 output 字段中。

代理请求 当可用操作不涵盖您的用例时，您可以通过 Membrane 的代理直接向 Vtiger API 发送请求。Membrane 自动处理身份验证和代理请求。