名称： pipedrive
描述： Pipedrive CRM API，用于管理交易、联系人（人员）、组织、活动、潜在客户、销售管道、产品和备注。适用于销售管道管理、交易跟踪、联系人/组织管理、活动安排、潜在客户处理或任何 Pipedrive CRM 任务。

Pipedrive

用于交易、联系人、组织、活动、销售管道、潜在客户和备注的销售 CRM API。

设置

从 Pipedrive 获取您的 API 令牌：
1. 前往 设置 → 个人偏好 → API
2. 复制您的个人 API 令牌

存储在 ~/.clawdbot/clawdbot.json 中：

{
  "skills": {
    "entries": {
      "pipedrive": {
        "apiToken": "YOUR_API_TOKEN"
      }
    }
  }
}

或者设置环境变量：PIPEDRIVE_API_TOKEN=xxx

快速参考

交易（最重要！）

{baseDir}/scripts/pipedrive.sh deals list                    # 列出所有交易
{baseDir}/scripts/pipedrive.sh deals list --status open      # 仅列出进行中的交易
{baseDir}/scripts/pipedrive.sh deals search "query"          # 搜索交易
{baseDir}/scripts/pipedrive.sh deals show <id>               # 获取交易详情
{baseDir}/scripts/pipedrive.sh deals create --title "Deal" --person <id> --value 1000
{baseDir}/scripts/pipedrive.sh deals update <id> --value 2000 --stage <stage_id>
{baseDir}/scripts/pipedrive.sh deals won <id>                # 标记交易为已赢得
{baseDir}/scripts/pipedrive.sh deals lost <id> --reason "Reason"  # 标记交易为已丢失
{baseDir}/scripts/pipedrive.sh deals delete <id>             # 删除交易

人员（联系人）

{baseDir}/scripts/pipedrive.sh persons list                  # 列出所有人员
{baseDir}/scripts/pipedrive.sh persons search "query"        # 搜索人员
{baseDir}/scripts/pipedrive.sh persons show <id>             # 获取人员详情
{baseDir}/scripts/pipedrive.sh persons create --name "John Doe" --email "john@example.com"
{baseDir}/scripts/pipedrive.sh persons update <id> --phone "+1234567890"
{baseDir}/scripts/pipedrive.sh persons delete <id>           # 删除人员

组织

{baseDir}/scripts/pipedrive.sh orgs list                     # 列出所有组织
{baseDir}/scripts/pipedrive.sh orgs search "query"           # 搜索组织
{baseDir}/scripts/pipedrive.sh orgs show <id>                # 获取组织详情
{baseDir}/scripts/pipedrive.sh orgs create --name "Acme Corp"
{baseDir}/scripts/pipedrive.sh orgs update <id> --address "123 Main St"
{baseDir}/scripts/pipedrive.sh orgs delete <id>              # 删除组织

活动

{baseDir}/scripts/pipedrive.sh activities list               # 列出活动
{baseDir}/scripts/pipedrive.sh activities list --done 0      # 列出待办活动
{baseDir}/scripts/pipedrive.sh activities show <id>          # 获取活动详情
{baseDir}/scripts/pipedrive.sh activities create --subject "Call" --type call --deal <id>
{baseDir}/scripts/pipedrive.sh activities done <id>          # 标记活动为已完成

销售管道与阶段

{baseDir}/scripts/pipedrive.sh pipelines list                # 列出所有销售管道
{baseDir}/scripts/pipedrive.sh pipelines stages <pipeline_id>  # 列出管道中的阶段

潜在客户

{baseDir}/scripts/pipedrive.sh leads list                    # 列出所有潜在客户
{baseDir}/scripts/pipedrive.sh leads show <id>               # 获取潜在客户详情
{baseDir}/scripts/pipedrive.sh leads create --title "New Lead" --person <id>
{baseDir}/scripts/pipedrive.sh leads convert <id>            # 将潜在客户转化为交易

产品

{baseDir}/scripts/pipedrive.sh products list                 # 列出所有产品
{baseDir}/scripts/pipedrive.sh products search "query"       # 搜索产品

备注

{baseDir}/scripts/pipedrive.sh notes list --deal <id>        # 列出交易的备注
{baseDir}/scripts/pipedrive.sh notes list --person <id>      # 列出人员的备注
{baseDir}/scripts/pipedrive.sh notes create --content "Note text" --deal <id>

交易状态

• open - 销售管道中的活跃交易
• won - 已赢得交易
• lost - 已丢失交易
• deleted - 已删除交易

活动类型

常见类型：call（电话）, meeting（会议）, task（任务）, deadline（截止日期）, email（邮件）, lunch（午餐）

注意事项

• API 基础地址：https://api.pipedrive.com/v1
• 认证：通过 api_token 查询参数传递 API 令牌
• 速率限制：每个公司每秒 10 次请求，每天 100,000 次
• 分页：使用 start（偏移量）和 limit 参数
• 在创建/更新/删除记录前请务必确认

API 参考

有关详细的端点文档，请参阅 references/api.md。