📦 Vtiger
v1.0.5Vtiger 集成。管理线索、组织、联系人、交易、活动、备注等。用于用户需要与 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,用户访问后获得 code,再执行:
membrane login complete
任何命令加 --json 可输出机器可读 JSON。
Agent 类型:claude、openclaw、codex、warp、windsurf 等,用于匹配最佳工具链。
连接 Vtiger
使用 membrane connection ensure 按应用 URL 或域名查找或创建连接:
membrane connection ensure "" --json
用户在浏览器完成认证,输出包含新连接 id。
若返回 state:"READY",直接进入下一步。
1b. 等待连接就绪
若状态为 BUILDING,轮询直至就绪:
npx @membranehq/cli connection get --wait --json
--wait 最长等待 --timeout 秒(默认 30)。
状态说明:
READY — 已就绪,进入第 2 步。
CLIENT_ACTION_REQUIRED — 需用户或代理操作,clientAction 对象说明:
type:"connect":需认证。- type:"provide-input":需补充信息。
- uiUrl:如有,直接展示给用户。
- agentInstructions:给 AI 代理的程序化指引。
用户完成后再次轮询,直至状态变为 READY。
CONFIGURATION_ERROR / SETUP_FAILED — 查看 error 字段排查。搜索操作
用自然语言描述需求,搜索可用操作:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
必须在指定连接上下文中搜索。结果含 id、name、描述、inputSchema、outputSchema。
常用操作
Delete Record — 按 ID 删除记录
Update Record — 更新记录
Retrieve Record — 按 ID 获取记录
Create Record — 新建记录
Query Records — 用类 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
结果在 response.output 中。
代理请求
当内置操作无法满足需求时,可通过 Membrane 代理直接向 Vtiger API 发送请求。Membrane 自动