用途:通过 Pipedrive CRM API 管理销售管道,覆盖交易(deals)、联系人(persons)、组织(organizations)、活动(activities)、备注(notes)、管道与阶段(pipelines/stages)以及搜索。官方文档:https://developers.pipedrive.com/docs/api/v1
主要能力:创建、更新、删除、查询交易;管理联系人与组织;记录通话、会议、任务等活动;为交易、联系人、组织添加备注;按关键词搜索交易、联系人或组织;读取管道与阶段结构;为交易添加参与者。
使用方式:先连接 Pipedrive 连接器(app.vm0.ai/connectors)。所有请求需带 x-api-token 头,令牌来自环境变量 $PIPEDRIVE_TOKEN。示例:curl -s "https://api.pipedrive.com/v1/users/me" --header "x-api-token: $PIPEDRIVE_TOKEN"。列表接口支持 limit 与 start 分页,交易列表 limit 最大 500,可用 status(open、won、lost、all_not_deleted)、stage_id、pipeline_id、filter_id 等参数。创建或更新时把 JSON 写入 /tmp/request.json,再用 -d @/tmp/request.json 提交。搜索接口 term 必填且至少 2 个字符。
限制与注意:列表接口均为分页,需检查 data.additional_data.pagination.more_items_in_collection 判断是否还有更多页;交易参与者请求体中 person_id 必须是数组,即使只加一人;活动类型固定为 call、meeting、task、deadline、email、lunch,不可用自由字符串;自定义字段以机器生成的哈希键返回,展示前需用 GET /v1/dealFields 或 GET /v1/personFields 映射键与标签。若请求失败,可运行 zero doctor check-connector --env-name PIPEDRIVE_TOKEN 或 zero doctor check-connector --url https://api.pipedrive.com/v1/users/me --method GET 排查。收费、价格与平台支持等资料暂未提供。