Pipedrive
与 Pipedrive CRM 交互
配置
获取所有交易
操作
获取所有交易
Pipedrive 账户*
选择 Pipedrive 账户
状态
全部(未删除)
联系人 ID
按联系人 ID 筛选
组织 ID
按组织 ID 筛选
管道 ID
按管道 ID 筛选
更新起始时间
日期 (2025-01-01T10:20:00Z)
限制
结果数量(默认 100,最大 500)
获取所有交易 (
pipedrive_get_all_deals)从 Pipedrive 获取所有交易,可选用筛选条件
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | 字符串 | 否 | 仅获取特定状态的交易。取值:open、won、lost。若省略,则返回所有未删除的交易 |
person_id | 字符串 | 否 | 若提供,则仅返回关联到指定联系人的交易 |
org_id | 字符串 | 否 | 若提供,则仅返回关联到指定组织的交易 |
pipeline_id | 字符串 | 否 | 若提供,则仅返回指定管道中的交易 |
updated_since | 字符串 | 否 | 若设置,则仅返回此时间之后更新的交易。格式:2025-01-01T10:20:00Z |
limit | 字符串 | 否 | 返回的结果数量(默认:100,最大:500) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
deals | array | 来自 Pipedrive 的交易对象数组 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
获取交易
操作
获取交易
Pipedrive 账户*
选择 Pipedrive 账户
交易 ID*
输入交易 ID
获取交易(
pipedrive_get_deal)获取指定交易的详细信息
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
deal_id | string | 是 | 要获取的交易 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
deal | object | 包含完整详情的交易对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
创建交易
操作
创建交易
Pipedrive 账户*
选择 Pipedrive 账户
标题*
输入交易标题
金额
货币金额
货币
货币代码(例如 USD、EUR)
联系人 ID
关联联系人 ID
组织 ID
关联组织 ID
管道 ID
管道 ID
阶段 ID
阶段 ID
状态
进行中
预计成交日期
YYYY-MM-DD
创建交易 (
pipedrive_create_deal)在 Pipedrive 中创建新交易
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 是 | 交易标题 |
value | string | 否 | 交易金额 |
currency | string | 否 | 货币代码 (例如 USD、EUR) |
person_id | string | 否 | 与此交易关联的联系人 ID |
org_id | string | 否 | 与此交易关联的组织 ID |
pipeline_id | string | 否 | 该交易应放入的管道 ID |
stage_id | string | 否 | 该交易应放入的阶段 ID |
status | string | 否 | 交易状态:open、won、lost |
expected_close_date | string | 否 | 预计成交日期,格式为 YYYY-MM-DD |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
deal | object | 创建的交易对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
更新交易
操作
更新交易
Pipedrive 账户*
选择 Pipedrive 账户
交易 ID*
输入交易 ID
金额
货币金额
阶段 ID
阶段 ID
状态
进行中
预计成交日期
YYYY-MM-DD
新标题
新交易标题
更新交易 (
pipedrive_update_deal)更新 Pipedrive 中的现有交易
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
deal_id | string | 是 | 要更新的交易 ID |
title | string | 否 | 交易的新标题 |
value | string | 否 | 交易的新金额 |
status | string | 否 | 新状态:open、won、lost |
stage_id | string | 否 | 交易的新阶段 ID |
expected_close_date | string | 否 | 新的预计成交日期,格式为 YYYY-MM-DD |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
deal | object | 更新后的交易对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
获取文件
操作
获取文件
Pipedrive 账户*
选择 Pipedrive 账户
交易 ID
按交易 ID 筛选
人员 ID
按人员 ID 筛选
组织 ID
按组织 ID 筛选
限制
结果数量(默认 100,最大 500)
获取文件 (
pipedrive_get_files)从 Pipedrive 检索文件,支持可选筛选
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
deal_id | string | 否 | 按交易 ID 筛选文件 |
person_id | string | 否 | 按联系人 ID 筛选文件 |
org_id | string | 否 | 按组织 ID 筛选文件 |
limit | string | 否 | 返回结果数量(默认:100,最大:500) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
files | 数组 | 来自 Pipedrive 的文件对象数组 |
metadata | 对象 | 操作元数据 |
success | 布尔值 | 操作成功状态 |
获取邮件会话
操作
获取邮件线程
Pipedrive 账户*
选择 Pipedrive 账户
文件夹
收件箱
限制
结果数量(默认 50)
获取邮件会话(
pipedrive_get_mail_messages)从 Pipedrive 邮箱获取邮件会话
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
folder | string | 否 | 按文件夹筛选:inbox、drafts、sent、archive (默认:inbox) |
limit | string | 否 | 返回结果数量 (默认:50) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
messages | array | 来自 Pipedrive 邮箱的邮件会话对象数组 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
获取邮件会话消息
操作
获取邮件会话消息
Pipedrive 账户*
选择 Pipedrive 账户
会话 ID*
输入邮件会话 ID
获取邮件会话消息 (
pipedrive_get_mail_thread)获取指定邮件会话中的全部消息
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
thread_id | string | 是 | 邮件会话的 ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
messages | array | 该会话中的邮件消息对象数组 |
metadata | object | 包含会话 ID 的操作元数据 |
success | boolean | 操作成功状态 |
获取管道
操作
获取管道
Pipedrive 账户*
选择 Pipedrive 账户
排序方式
ID
排序方向
升序
限制
结果数量(默认 100,最大 500)
游标
分页游标(可选)
获取管道(
pipedrive_get_pipelines)从 Pipedrive 检索所有管道
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sort_by | string | 否 | 排序字段:id、update_time、add_time (默认:id) |
sort_direction | string | 否 | 排序方向:asc、desc (默认:asc) |
limit | string | 否 | 返回结果数量 (默认:100,最大:500) |
cursor | string | 否 | 分页标记,表示下一页的第一项 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
pipelines | 数组 | 来自 Pipedrive 的管道对象数组 |
metadata | 对象 | 操作元数据 |
success | 布尔值 | 操作成功状态 |
获取管道交易
操作
获取管道交易
Pipedrive 账户*
选择 Pipedrive 账户
管道 ID*
输入管道 ID
阶段 ID
按阶段 ID 筛选
状态
全部
限制
结果数量(默认 100,最大 500)
获取管道交易 (
pipedrive_get_pipeline_deals)获取指定管道中的所有交易
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
pipeline_id | string | 是 | 管道 ID |
stage_id | string | 否 | 按管道内的特定阶段筛选 |
status | string | 否 | 按交易状态筛选:open、won、lost |
limit | string | 否 | 返回的结果数量 (默认:100,最大:500) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
deals | 数组 | 来自管道的交易对象数组 |
metadata | 对象 | 包含管道 ID 的操作元数据 |
success | 布尔值 | 操作成功状态 |
获取项目
操作
获取项目
Pipedrive 账户*
选择 Pipedrive 账户
项目 ID
项目 ID
状态
全部
数量限制
结果数量(默认 100,最大 500)
获取项目 (
pipedrive_get_projects)从 Pipedrive 检索所有项目或特定项目
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_id | string | 否 | 可选:要检索的特定项目 ID |
status | string | 否 | 按项目状态筛选:open、completed、deleted (仅用于列出全部) |
limit | string | 否 | 返回结果数量 (默认:100,最大:500,仅用于列出全部) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
projects | array | 项目对象数组 (列出全部时) |
project | object | 单个项目对象 (当提供 project_id 时) |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
创建项目
操作
创建项目
Pipedrive 账户*
选择 Pipedrive 账户
标题*
输入项目标题
描述
项目描述
开始日期
YYYY-MM-DD
结束日期
YYYY-MM-DD
创建项目 (
pipedrive_create_project)在 Pipedrive 中创建新项目
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 是 | 项目标题 |
description | string | 否 | 项目描述 |
start_date | string | 否 | 项目开始日期,格式为 YYYY-MM-DD |
end_date | string | 否 | 项目结束日期,格式为 YYYY-MM-DD |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
project | object | 创建的项目对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
获取活动
操作
获取活动
Pipedrive 账户*
选择 Pipedrive 账户
交易 ID
按交易 ID 筛选
人员 ID
按人员 ID 筛选
组织 ID
按组织 ID 筛选
活动类型
全部
完成状态
全部
限制
结果数量(默认 100,最大 500)
获取活动 (
pipedrive_get_activities)从 Pipedrive 获取活动(任务),可使用可选筛选条件
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
deal_id | string | 否 | 按交易 ID 筛选活动 |
person_id | string | 否 | 按联系人 ID 筛选活动 |
org_id | string | 否 | 按组织 ID 筛选活动 |
type | string | 否 | 按活动类型筛选(call、meeting、task、deadline、email、lunch) |
done | string | 否 | 按完成状态筛选:0 表示未完成,1 表示已完成 |
limit | string | 否 | 返回结果数量(默认:100,最大:500) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
activities | array | 来自 Pipedrive 的活动对象数组 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
创建活动
操作
创建活动
Pipedrive 账户*
选择 Pipedrive 账户
交易 ID
按交易 ID 筛选
人员 ID
按人员 ID 筛选
组织 ID
按组织 ID 筛选
主题*
活动主题/标题
活动类型*
任务
截止日期*
YYYY-MM-DD
截止时间
HH:mm:ss
持续时间
HH:mm:ss
备注
活动备注
创建活动 (
pipedrive_create_activity)在 Pipedrive 中创建新活动(任务)
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
subject | string | 是 | 活动主题/标题 |
type | string | 是 | 活动类型:call、meeting、task、deadline、email、lunch |
due_date | string | 是 | 截止日期,格式为 YYYY-MM-DD |
due_time | string | 否 | 截止时间,格式为 HH:mm:ss |
duration | string | 否 | 时长,格式为 HH:mm:ss |
deal_id | string | 否 | 要关联的交易 ID |
person_id | string | 否 | 要关联的联系人 ID |
org_id | string | 否 | 要关联的组织 ID |
note | string | 否 | 活动备注 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
activity | object | 创建的活动对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
更新活动
操作
更新活动
Pipedrive 账户*
选择 Pipedrive 账户
主题*
活动主题/标题
截止日期*
YYYY-MM-DD
截止时间
HH:mm:ss
时长
HH:mm:ss
备注
活动备注
活动 ID*
输入活动 ID
标记为已完成
未完成
更新活动 (
pipedrive_update_activity)更新 Pipedrive 中的现有活动(任务)
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
activity_id | string | 是 | 要更新的活动 ID |
subject | string | 否 | 活动的新主题/标题 |
due_date | string | 否 | 新截止日期,格式为 YYYY-MM-DD |
due_time | string | 否 | 新截止时间,格式为 HH:mm:ss |
duration | string | 否 | 新时长,格式为 HH:mm:ss |
done | string | 否 | 标记为已完成:0 表示未完成,1 表示已完成 |
note | string | 否 | 活动的新备注 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
activity | 对象 | 更新后的活动对象 |
metadata | 对象 | 操作元数据 |
success | 布尔值 | 操作成功状态 |
获取线索
操作
获取线索
Pipedrive 账户*
选择 Pipedrive 账户
线索 ID
线索 ID
已归档
活跃线索
联系人 ID
要关联线索的联系人 ID
组织 ID
要关联线索的组织 ID
所有者 ID
所有者用户 ID
限制
结果数量(默认 100)
获取线索 (
pipedrive_get_leads)从 Pipedrive 获取全部线索或指定线索
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
lead_id | string | 否 | 可选:要获取的特定线索 ID |
archived | string | 否 | 获取已归档线索,而非活跃线索 |
owner_id | string | 否 | 按所有者用户 ID 筛选 |
person_id | string | 否 | 按联系人 ID 筛选 |
organization_id | string | 否 | 按组织 ID 筛选 |
limit | string | 否 | 返回结果数量(默认:100,最大:500) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
leads | array | 线索对象数组 (列出全部时) |
lead | object | 单个线索对象 (提供 lead_id 时) |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
创建线索
操作
创建线索
Pipedrive 账户*
选择 Pipedrive 账户
标题*
输入线索标题
人员 ID
关联线索的人员 ID
组织 ID
关联线索的组织 ID
所有者 ID
所有者用户 ID
价值金额
潜在价值金额
价值货币
货币代码(例如 USD, EUR)
预计成交日期
YYYY-MM-DD
创建线索 (
pipedrive_create_lead)在 Pipedrive 中创建新线索
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
title | string | 是 | 线索名称 |
person_id | string | 否 | 联系人 ID(未提供 organization_id 时必填) |
organization_id | string | 否 | 组织 ID(未提供 person_id 时必填) |
owner_id | string | 否 | 线索负责人的用户 ID |
value_amount | string | 否 | 潜在金额 |
value_currency | string | 否 | 货币代码(例如 USD、EUR) |
expected_close_date | string | 否 | 预计成交日期,格式为 YYYY-MM-DD |
visible_to | string | 否 | 可见性:1(负责人及关注者),3(全公司) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
lead | 对象 | 创建的线索对象 |
metadata | 对象 | 操作元数据 |
success | 布尔值 | 操作成功状态 |
更新线索
操作
更新线索
Pipedrive 账户*
选择 Pipedrive 账户
线索 ID
线索 ID
新标题
新线索标题
人员 ID
要链接线索的人员 ID
组织 ID
要链接线索的组织 ID
负责人 ID
负责人用户 ID
价值金额
潜在价值金额
价值货币
货币代码(例如 USD、EUR)
预计成交日期
YYYY-MM-DD
归档线索
否
更新线索(
pipedrive_update_lead)更新 Pipedrive 中的现有线索
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
lead_id | string | 是 | 要更新的线索 ID |
title | string | 否 | 线索的新名称 |
person_id | string | 否 | 新的联系人 ID |
organization_id | string | 否 | 新的组织 ID |
owner_id | string | 否 | 新的所有者用户 ID |
value_amount | string | 否 | 新的金额 |
value_currency | string | 否 | 新的货币代码(例如 USD、EUR) |
expected_close_date | string | 否 | 新的预计成交日期,格式为 YYYY-MM-DD |
is_archived | string | 否 | 归档该线索:true 或 false |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
lead | object | 更新后的潜在客户对象 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
删除线索
操作
删除潜在客户
Pipedrive 账户*
选择 Pipedrive 账户
潜在客户 ID
潜在客户 ID
删除潜在客户 (
pipedrive_delete_lead)从 Pipedrive 中删除指定潜在客户
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
lead_id | string | 是 | 要删除的潜在客户的 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
data | object | 删除确认数据 |
metadata | object | 操作元数据 |
success | boolean | 操作成功状态 |
使用说明
将 Pipedrive 集成到您的工作流中。利用强大的 CRM 功能管理交易、联系人、销售管道、项目、活动、文件和沟通。
注意
- 类别:
tools - 类型:
pipedrive