SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场pipedrive

pipedrive

营销与增长

查看项目

更新于 10-15 09:12

技能介绍

Pipedrive 是一款 CRM 与销售管理工具，帮助销售团队整理线索、跟踪交易并自动化销售流程，主要被中小型企业用于提升销售业绩和管理客户关系。官方 API 文档地址为 https://developers.pipedrive.com/docs/api/v1。

用途 本技能用于在用户希望与 Pipedrive 数据交互时，管理 CRM 与销售数据、记录和工作流。它通过 Membrane CLI 与 Pipedrive 通信，由 Membrane 自动处理认证和凭证刷新，使使用者可以专注于集成逻辑而非认证管道。

主要能力 Pipedrive 涉及的数据对象包括：交易（Deals）、交易字段（Deal Fields）、联系人（Persons）、联系人字段（Person Fields）、组织（Organizations）、组织字段（Organization Fields）、产品（Products）、阶段（Stages）、管道（Pipelines）、用户（Users）、活动类型（Activity Types）、活动（Activities）、文件（Files）、备注（Notes）、邮件消息（Email Messages）、报价（Quotes）。

常见动作包括：

  • 列表类：List Deals（按用户、阶段或状态可选过滤）、List Leads、List Persons、List Organizations、List Products、List Users、List Stages、List Pipelines。
  • 获取类：Get Deal、Get Lead、Get Person、Get Organization、Get Product、Get User（均按 ID 获取详情）。
  • 创建类：Create Deal、Create Lead、Create Person、Create Organization。
  • 更新类：Update Deal、Update Lead。 每个动作结果包含 id、name、description、inputSchema（接受的参数）和 outputSchema（返回内容）。

使用方式

  1. 安装 CLI：npm install -g @membranehq/cli@latest
  2. 认证：membrane login --tenant --clientName=<agentType>。该命令会打开浏览器进行认证，或在控制台打印授权 URL（取决于是否支持交互模式）。无头环境下会打印授权 URL，请用户在浏览器中打开，完成登录后看到验证码，再执行 membrane login complete <code>。任意命令加 --json 可获得机器可读的 JSON 输出。agentType 可选 claude、openclaw、codex、warp、windsurf 等，用于针对不同运行环境调整工具。
  3. 连接 Pipedrive：membrane connection ensure "https://www.pipedrive.com/" --json。用户在浏览器中完成认证，输出包含新的 connection id。若返回的连接状态为 READY，可直接进入下一步；若为 BUILDING，则轮询 npx @membranehq/cli connection get <id> --wait --json（--wait 长轮询，默认 30 秒，可用 --timeout 调整），直到状态不再是 BUILDING。状态含义：READY 表示连接已就绪；CLIENT_ACTION_REQUIRED 表示用户或代理需要执行操作，clientAction.type 为 "connect" 时需认证（含重新认证），为 "provide-input" 时需补充信息，clientAction.description 为说明，clientAction.uiUrl（可选）为可完成操作的预构建 UI，clientAction.agentInstructions（可选）为代理的程序化指引；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，可查看 error 字段。用户完成操作后，再次用 membrane connection get <id> --json 轮询检查是否变为 READY。
  4. 搜索动作：membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json，用自然语言描述意图，并始终在特定连接上下文中搜索。
  5. 运行动作：membrane action run <actionId> --connectionId=CONNECTION_ID --json；传 JSON 参数：membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果位于响应的 output 字段。
  6. 代理请求：当现有动作无法覆盖用例时，可通过 Membrane 代理直接向 Pipedrive API 发送请求，Membrane 会自动拼接基础 URL 并注入正确的认证头（含凭证过期时的透明刷新）：membrane request CONNECTION_ID /path/to/endpoint。常用选项：-X/--method（HTTP 方法，默认 GET）、-H/--header（添加请求头，可重复）、-d/--data（请求体字符串）、--json（发送 JSON 体并设置 Content-Type: application/json）、--rawData（原样发送请求体）、--query（查询字符串参数，可重复）、--pathParam（路径参数，可重复）。

适用场景 适用于需要以编程或代理方式读取、创建、更新 Pipedrive 中交易、线索、联系人、组织、产品、阶段、管道、用户、活动、备注、邮件、报价等数据的销售与 CRM 工作流。

限制与注意事项

  • 使用前必须完成 Membrane CLI 安装、登录与连接建立。
  • 无头环境下认证需用户手动在浏览器打开授权 URL 并回填验证码。
  • 连接可能处于 BUILDING、CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED 等状态，需按状态处理。
  • 建议优先使用 Membrane 预构建动作（内置认证、分页与错误处理），在编写自定义 API 调用前先用 membrane action list --intent=QUERY 发现已有动作。
  • 不要让用户提供 API 密钥或令牌，应通过创建连接由 Membrane 在服务端管理完整认证生命周期。
  • 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。