Pipedrive
Pipedrive 是一种 CRM 和管道管理工具，可帮助你专注于重要作。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://www.pipedrive.com/ |
| 隐私策略 | https://www.pipedrive.com/privacy |
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | API 密钥 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
| 触发器轮询的频率 | 1 | 120 秒 |
操作
| 按 ID 获取交易 |
此作将检索现有交易的所有详细信息，给定其 ID。 |
| 按 ID 获取阶段 |
此作返回有关特定阶段的数据。 |
| 更新交易状态 |
此作用于在给定交易 ID 的情况下更新与交易关联的状态。 |
| 更新交易阶段 [已弃用] |
此作已弃用。 请改用更新交易阶段（V2）。
|
| 更新交易阶段 （V2） （预览版） |
此作用于在给定交易 ID 的情况下更新与交易关联的阶段。 |
| 添加交易 [已弃用] |
此作已弃用。 请改用“添加交易”（V2）。
|
| 添加交易 （V2） （预览版） |
此作将为已授权帐户创建新交易。 |
| 添加活动 |
此作用于为授权帐户创建新活动。 |
按 ID 获取交易
按 ID 获取阶段
更新交易状态
此作用于在给定交易 ID 的情况下更新与交易关联的状态。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
交易 ID
|
dealId | True | integer |
交易 |
|
状态
|
status | True | string |
交易的状态。 |
|
丢失的原因
|
lost_reason | string |
关于交易为何丢失的信息。 |
返回
数据
- Body
- DealResponse
更新交易阶段 [已弃用]
此作已弃用。 请改用更新交易阶段（V2）。
此作用于在给定交易 ID 的情况下更新与交易关联的阶段。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
交易 ID
|
dealId | True | integer |
交易 |
|
阶段 ID
|
stage_id | True | string |
交易的阶段。 |
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
返回
数据
- Body
- DealResponse
更新交易阶段 （V2） （预览版）
此作用于在给定交易 ID 的情况下更新与交易关联的阶段。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
交易 ID
|
dealId | True | integer |
交易 |
|
管道 ID
|
pipeline_id | True | string |
要从中提取阶段的管道的 ID。 |
|
阶段 ID
|
stage_id | True | string |
交易的阶段。 |
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
返回
数据
- Body
- DealResponseV2
添加交易 [已弃用]
此作已弃用。 请改用“添加交易”（V2）。
此作将为已授权帐户创建新交易。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Title
|
title | True | string |
交易的标题。 |
|
阶段 ID
|
stage_id | string |
交易的阶段。 |
|
|
状态
|
status | string |
交易的状态。 |
|
|
价值
|
value | integer |
交易的货币价值。 |
|
|
货币
|
currency | string |
交易的货币。 |
|
|
联系人 ID
|
person_id | string |
与交易关联的人员的用户 ID。 |
|
|
组织编号
|
org_id | string |
与交易关联的组织的 ID。 |
|
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
所有者、关注者或整个公司。 |
返回
数据
- Body
- DealResponse
添加交易 （V2） （预览版）
此作将为已授权帐户创建新交易。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Title
|
title | True | string |
交易的标题。 |
|
管道 ID
|
pipeline_id | string |
要从中提取阶段的管道的 ID。 |
|
|
阶段 ID
|
stage_id | string |
交易的阶段。 |
|
|
状态
|
status | string |
交易的状态。 |
|
|
价值
|
value | integer |
交易的货币价值。 |
|
|
货币
|
currency | string |
交易的货币。 |
|
|
联系人 ID
|
person_id | string |
与交易关联的人员的用户 ID。 |
|
|
组织编号
|
org_id | string |
与交易关联的组织的 ID。 |
|
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
所有者、关注者或整个公司。 |
返回
数据
- Body
- DealResponseV2
添加活动
此作用于为授权帐户创建新活动。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
类型
|
type | True | string |
活动类型。 |
|
Subject
|
subject | True | string |
活动的主题。 |
|
截止日期
|
due_date | string |
YYYY-MM-DD |
|
|
截止日期
|
due_time | string |
HH：MM |
|
|
持续时间
|
duration | string |
HH：MM |
|
|
注释
|
note | string | ||
|
分配到
|
user_id | integer |
将向其分配活动的用户的 ID。 |
|
|
交易 ID
|
deal_id | integer |
活动将与之关联的交易 ID。 |
|
|
联系人 ID
|
person_id | integer |
活动将与之关联的人员的 ID。 |
|
|
组织编号
|
org_id | integer |
活动将与之关联的组织的 ID。 |
返回
数据
- Body
- ActivityResponse
触发器
| 添加新交易时 [已弃用] |
此作已弃用。 请改用新交易（V2）。
|
| 添加新交易时 （V2） （预览版） |
将新交易添加到授权帐户（V2）时触发。 |
| 添加新活动时 |
将新活动添加到授权帐户时触发。 |
添加新交易时 [已弃用]
添加新交易时 （V2） （预览版）
添加新活动时
定义
StageResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
阶段 ID
|
id | integer |
阶段 ID |
|
艺名
|
name | string |
阶段名称 |
ActivityResponse
数据
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
活动 ID
|
id | integer |
活动的唯一 ID。 |
|
用户 ID
|
user_id | integer |
为其分配活动的用户的 ID。 |
|
是否完成
|
done | boolean |
0 = 未完成，1 = 完成 |
|
类型
|
type | string |
活动的类型。 |
|
截止日期
|
due_date | string |
YYYY-MM-DD |
|
截止日期
|
due_time | string |
HH：MM |
|
持续时间
|
duration | string |
HH：MM |
|
Subject
|
subject | string |
活动的主题。 |
|
交易 ID
|
deal_id | integer |
活动关联的交易 ID。 |
|
交易标题
|
deal_title | string |
与活动关联的交易标题。 |
|
组织编号
|
org_id | integer |
活动关联的组织的 ID。 |
|
组织名称
|
org_name | string |
活动与之关联的组织名称。 |
|
联系人 ID
|
person_id | integer |
活动与之关联的人员 ID。 |
|
联系人姓名
|
person_name | string |
活动与之关联的人员姓名。 |
|
已创建 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
更新 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
已完成 Date-Time
|
marked_as_done_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
Google 日历事件 ID
|
gcal_event_id | string |
google 日历事件的 ID。 |
|
Google 日历 ID
|
google_calendar_id | string |
google 日历的 ID。 |
|
注释
|
note | string |
活动说明（HTML 格式）。 |
|
分配到
|
assigned_to_user_id | integer |
为其分配活动的用户的用户 ID。 |
|
创建者
|
created_by_user_id | integer |
创建活动的用户的用户 ID。 |
|
所有者名称
|
owner_name | string |
活动所有者的名称。 |
DealResponse
数据
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
交易 ID
|
id | integer |
交易的 ID。 |
|
Id
|
creator_user_id.id | integer |
交易创建者的 ID。 |
|
Name
|
creator_user_id.name | string |
交易创建者的名称。 |
|
Email
|
creator_user_id.email | string |
交易创建者的电子邮件。 |
|
Id
|
user_id.id | integer |
交易所有者的 ID。 |
|
Name
|
user_id.name | string |
交易所有者的名称。 |
|
Email
|
user_id.email | string |
交易所有者的电子邮件。 |
|
Name
|
person_id.name | string |
与交易关联的人员的姓名。 |
|
Id
|
person_id.value | integer |
与交易关联的人员的 ID。 |
|
Name
|
org_id.name | string |
与交易关联的组织的名称。 |
|
Id
|
org_id.value | integer |
与交易关联的组织的 ID。 |
|
状态
|
status | string |
打开、获胜、丢失或删除。 |
|
交易标题
|
title | string |
交易的标题。 |
|
交易值
|
value | number |
交易的货币价值。 |
|
货币
|
currency | string |
与交易值关联的货币。 |
|
已创建 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
更新了 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
阶段 ID
|
stage_id | integer |
交易的阶段 ID 放置在管道中。 |
|
艺名
|
stage_name | string |
交易放置在管道中的阶段名称 |
|
阶段 Uodated Date-Time
|
stage_change_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
处于活动状态
|
active | boolean |
如此 如果交易处于活动状态。 |
|
已删除
|
deleted | boolean |
如此 如果交易已被删除。 |
|
下一个活动日期
|
next_activity_date | string |
yyyy-MM-dd |
|
下一个活动时间
|
next_activity_time | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
下一个活动 ID
|
next_activity_id | integer |
下一个活动的 ID。 |
|
上次活动 ID
|
last_activity_id | integer |
最后一个活动的 ID。 |
|
上次活动日期
|
last_activity_date | string |
yyyy-MM-dd |
|
丢失的原因
|
lost_reason | string |
有关交易为何丢失的信息（在 status=lost 时使用）。 |
|
Visiblity
|
visible_to | string |
所有者、关注者或整个公司。 |
|
关闭 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
管道 ID
|
pipeline_id | integer |
与交易关联的管道的 ID。 |
|
产品计数
|
products_count | integer |
与交易关联的产品数。 |
|
文件计数
|
files_count | integer |
与交易关联的文件数。 |
|
备注计数
|
notes_count | integer |
与交易关联的笔记数。 |
|
关注者计数
|
followers_count | integer |
与交易关联的关注者数。 |
|
电子邮件计数
|
email_messages_count | integer |
与交易关联的电子邮件数。 |
|
活动计数
|
activities_count | integer |
与交易关联的活动数。 |
|
完成的活动计数
|
done_activities_count | integer |
与交易关联的已完成活动数。 |
|
撤消活动计数
|
undone_activities_count | integer |
与交易关联的撤消 activitie 数。 |
|
引用的活动计数
|
reference_activities_count | integer |
与交易关联的引用活动数。 |
|
参与者计数
|
participants_count | integer |
与交易关联的参与者数。 |
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
|
下一个活动主题
|
next_activity_subject | string |
与交易关联的下一个活动的主题。 |
|
下一个活动类型
|
next_activity_type | string |
与交易关联的下一个活动的类型。 |
|
下一个活动持续时间
|
next_activity_duration | string |
与交易关联的下一个活动的持续时间。 |
|
下一个活动说明
|
next_activity_note | string |
与交易关联的下一个活动的说明 |
DealResponseV2
数据
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
交易 ID
|
id | integer |
交易的 ID。 |
|
Id
|
creator_user_id.id | integer |
交易创建者的 ID。 |
|
Name
|
creator_user_id.name | string |
交易创建者的名称。 |
|
Email
|
creator_user_id.email | string |
交易创建者的电子邮件。 |
|
Id
|
user_id.id | integer |
交易所有者的 ID。 |
|
Name
|
user_id.name | string |
交易所有者的名称。 |
|
Email
|
user_id.email | string |
交易所有者的电子邮件。 |
|
Name
|
person_id.name | string |
与交易关联的人员的姓名。 |
|
Id
|
person_id.value | integer |
与交易关联的人员的 ID。 |
|
Name
|
org_id.name | string |
与交易关联的组织的名称。 |
|
Id
|
org_id.value | integer |
与交易关联的组织的 ID。 |
|
状态
|
status | string |
打开、获胜、丢失或删除。 |
|
交易标题
|
title | string |
交易的标题。 |
|
交易值
|
value | number |
交易的货币价值。 |
|
货币
|
currency | string |
与交易值关联的货币。 |
|
已创建 Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
更新了 Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
阶段 ID
|
stage_id | integer |
交易的阶段 ID 放置在管道中。 |
|
阶段 Uodated Date-Time
|
stage_change_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
处于活动状态
|
active | boolean |
如此 如果交易处于活动状态。 |
|
已删除
|
deleted | boolean |
如此 如果交易已被删除。 |
|
下一个活动日期
|
next_activity_date | string |
yyyy-MM-dd |
|
下一个活动时间
|
next_activity_time | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
下一个活动 ID
|
next_activity_id | integer |
下一个活动的 ID。 |
|
上次活动 ID
|
last_activity_id | integer |
最后一个活动的 ID。 |
|
上次活动日期
|
last_activity_date | string |
yyyy-MM-dd |
|
丢失的原因
|
lost_reason | string |
有关交易为何丢失的信息（在 status=lost 时使用）。 |
|
Visiblity
|
visible_to | string |
所有者、关注者或整个公司。 |
|
关闭 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
管道 ID
|
pipeline_id | integer |
与交易关联的管道的 ID。 |
|
产品计数
|
products_count | integer |
与交易关联的产品数。 |
|
文件计数
|
files_count | integer |
与交易关联的文件数。 |
|
备注计数
|
notes_count | integer |
与交易关联的笔记数。 |
|
关注者计数
|
followers_count | integer |
与交易关联的关注者数。 |
|
电子邮件计数
|
email_messages_count | integer |
与交易关联的电子邮件数。 |
|
活动计数
|
activities_count | integer |
与交易关联的活动数。 |
|
完成的活动计数
|
done_activities_count | integer |
与交易关联的已完成活动数。 |
|
撤消活动计数
|
undone_activities_count | integer |
与交易关联的撤消 activitie 数。 |
|
引用的活动计数
|
reference_activities_count | integer |
与交易关联的引用活动数。 |
|
参与者计数
|
participants_count | integer |
与交易关联的参与者数。 |
|
预期关闭日期
|
expected_close_date | string |
yyyy-MM-dd |
|
下一个活动主题
|
next_activity_subject | string |
与交易关联的下一个活动的主题。 |
|
下一个活动类型
|
next_activity_type | string |
与交易关联的下一个活动的类型。 |
|
下一个活动持续时间
|
next_activity_duration | string |
与交易关联的下一个活动的持续时间。 |
|
下一个活动说明
|
next_activity_note | string |
与交易关联的下一个活动的说明 |