Pipedrive
Pipedrive 是一款 CRM 和管道管理工具，可協助您專注於重要的行動。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.pipedrive.com/ |
| 隱私策略 | https://www.pipedrive.com/privacy |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 120 秒 |
動作
| 新增交易 [已棄用] |
此動作已被取代。 請改用 新增交易 （V2）。
|
| 新增交易 （V2） （預覽版） |
此作業會為授權帳戶建立新交易。 |
| 新增活動 |
此作業可用來為授權帳戶建立新活動。 |
| 更新交易狀態 |
此作業用於更新與交易相關聯的狀態，給定其ID。 |
| 更新交易階段 [已淘汰] |
此動作已被取代。 請改用更新交易階段 （V2）。
|
| 更新交易階段 （V2） （預覽） |
此作業可用來更新與交易相關聯的階段，給定其識別碼。 |
| 透過 ID 取得階段 |
此作業會傳回特定階段的相關資料。 |
| 通過 ID 獲取交易 |
此作業會擷取現有交易的所有詳細資料，並指定其識別碼。 |
新增交易 [已棄用]
此動作已被取代。 請改用 新增交易 （V2）。
此作業會為授權帳戶建立新交易。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
交易的標題。 |
|
階段識別碼
|
stage_id | string |
交易階段。 |
|
|
地位
|
status | string |
交易狀態。 |
|
|
價值觀
|
value | integer |
交易的貨幣價值。 |
|
|
貨幣
|
currency | string |
交易的貨幣。 |
|
|
聯絡人 ID
|
person_id | string |
與交易相關聯的人員的使用者 ID。 |
|
|
組織識別碼
|
org_id | string |
與交易相關聯之組織的識別碼。 |
|
|
預計截止日期
|
expected_close_date | string |
yyyy-MM-dd |
|
|
可見性
|
visible_to | string |
所有者、追隨者或整個公司。 |
傳回
資料
- 身體
- DealResponse
新增交易 （V2） （預覽版）
此作業會為授權帳戶建立新交易。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
交易的標題。 |
|
管線識別碼
|
pipeline_id | string |
要從中擷取階段的管線識別碼。 |
|
|
階段識別碼
|
stage_id | string |
交易階段。 |
|
|
地位
|
status | string |
交易狀態。 |
|
|
價值觀
|
value | integer |
交易的貨幣價值。 |
|
|
貨幣
|
currency | string |
交易的貨幣。 |
|
|
聯絡人 ID
|
person_id | string |
與交易相關聯的人員的使用者 ID。 |
|
|
組織識別碼
|
org_id | string |
與交易相關聯之組織的識別碼。 |
|
|
預計截止日期
|
expected_close_date | string |
yyyy-MM-dd |
|
|
可見性
|
visible_to | string |
所有者、追隨者或整個公司。 |
傳回
資料
新增活動
此作業可用來為授權帳戶建立新活動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
類型
|
type | True | string |
活動類型。 |
|
主旨
|
subject | True | string |
活動主題。 |
|
到期日
|
due_date | string |
YYYY-MM-DD |
|
|
預定時間
|
due_time | string |
HH：毫米 |
|
|
持續時間
|
duration | string |
HH：毫米 |
|
|
註釋
|
note | string | ||
|
指派至
|
user_id | integer |
活動將指派給之使用者的 ID。 |
|
|
交易編號
|
deal_id | integer |
活動將與之相關聯的交易ID。 |
|
|
聯絡人 ID
|
person_id | integer |
活動將與之相關聯的人員 ID。 |
|
|
組織識別碼
|
org_id | integer |
活動將與之相關聯的組織識別碼。 |
傳回
資料
更新交易狀態
此作業用於更新與交易相關聯的狀態，給定其ID。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交易編號
|
dealId | True | integer |
交易 |
|
地位
|
status | True | string |
交易狀態。 |
|
失去理智
|
lost_reason | string |
關於交易失敗原因的消息。 |
傳回
資料
- 身體
- DealResponse
更新交易階段 [已淘汰]
此動作已被取代。 請改用更新交易階段 （V2）。
此作業可用來更新與交易相關聯的階段，給定其識別碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交易編號
|
dealId | True | integer |
交易 |
|
階段識別碼
|
stage_id | True | string |
交易階段。 |
|
預計截止日期
|
expected_close_date | string |
yyyy-MM-dd |
傳回
資料
- 身體
- DealResponse
更新交易階段 （V2） （預覽）
此作業可用來更新與交易相關聯的階段，給定其識別碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交易編號
|
dealId | True | integer |
交易 |
|
管線識別碼
|
pipeline_id | True | string |
要從中擷取階段的管線識別碼。 |
|
階段識別碼
|
stage_id | True | string |
交易階段。 |
|
預計截止日期
|
expected_close_date | string |
yyyy-MM-dd |
傳回
資料
透過 ID 取得階段
通過 ID 獲取交易
此作業會擷取現有交易的所有詳細資料，並指定其識別碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交易編號
|
dealId | True | integer |
交易 |
傳回
資料
- 身體
- DealResponse
觸發程序
| 新增交易時 [已棄用] |
此動作已被取代。 請改用新增交易時 （V2）。
|
| 新增交易時 （V2） （預覽版） |
當新交易新增至授權帳戶 （V2） 時觸發。 |
| 新增活動時 |
當新活動新增至授權帳戶時觸發。 |
新增交易時 [已棄用]
新增交易時 （V2） （預覽版）
新增活動時
定義
階段回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
階段識別碼
|
id | integer |
階段識別碼 |
|
藝名
|
name | string |
藝名 |
活動回應
資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
活動標識符
|
id | integer |
活動的唯一ID。 |
|
使用者識別碼
|
user_id | integer |
指派活動之使用者的 ID。 |
|
已完成
|
done | boolean |
0 = 未完成，1 = 完成 |
|
類型
|
type | string |
活動類型。 |
|
到期日
|
due_date | string |
YYYY-MM-DD |
|
預定時間
|
due_time | string |
HH：毫米 |
|
持續時間
|
duration | string |
HH：毫米 |
|
主旨
|
subject | string |
活動主題。 |
|
交易編號
|
deal_id | integer |
活動相關聯的交易 ID。 |
|
交易標題
|
deal_title | string |
與活動相關聯的交易標題。 |
|
組織識別碼
|
org_id | integer |
活動相關聯的組織識別碼。 |
|
組織名稱
|
org_name | string |
與活動相關聯的組織名稱。 |
|
聯絡人 ID
|
person_id | integer |
活動相關聯的人員識別碼。 |
|
連絡人姓名
|
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 |
活動擁有者的名稱。 |
交易回應
資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
交易編號
|
id | integer |
交易的 ID。 |
|
Id
|
creator_user_id.id | integer |
交易建立者的 ID。 |
|
名稱
|
creator_user_id.name | string |
交易建立者的名稱。 |
|
Email
|
creator_user_id.email | string |
交易創建者的電子郵件。 |
|
Id
|
user_id.id | integer |
交易擁有者的識別碼。 |
|
名稱
|
user_id.name | string |
交易擁有者的名稱。 |
|
Email
|
user_id.email | string |
交易擁有者的電子郵件。 |
|
名稱
|
person_id.name | string |
與交易相關聯的人員名稱。 |
|
Id
|
person_id.value | integer |
與交易相關聯之人員的標識碼。 |
|
名稱
|
org_id.name | string |
與交易相關聯的組織名稱。 |
|
Id
|
org_id.value | integer |
與交易相關聯之組織的識別碼。 |
|
地位
|
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 |
|
階段識別碼
|
stage_id | integer |
交易放置在管線中的階段識別碼。 |
|
藝名
|
stage_name | string |
交易放置在管線中的階段名稱 |
|
舞台 Uodated Date-Time
|
stage_change_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
處於活動狀態
|
active | boolean |
如果交易處於作用中狀態，則為 True。 |
|
已刪除
|
deleted | boolean |
如果交易已刪除，則為 True。 |
|
下一個活動日期
|
next_activity_date | string |
yyyy-MM-dd |
|
下次活動時間
|
next_activity_time | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
下一個活動標識符
|
next_activity_id | integer |
下一個活動的 ID。 |
|
上次活動標識符
|
last_activity_id | integer |
最後一個活動的標識碼。 |
|
上次活動日期
|
last_activity_date | string |
yyyy-MM-dd |
|
失去理智
|
lost_reason | string |
有關交易丟失原因的消息（在 status=lost 時使用）。 |
|
可見性
|
visible_to | string |
所有者、追隨者或整個公司。 |
|
關閉 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
管線識別碼
|
pipeline_id | integer |
與交易相關聯的管線標識碼。 |
|
產品數量
|
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 |
與交易相關聯的已撤銷活動數目。 |
|
參考活動計數
|
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 |
與交易相關聯的下一個活動注意事項 |
交易回應V2
資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
交易編號
|
id | integer |
交易的 ID。 |
|
Id
|
creator_user_id.id | integer |
交易建立者的 ID。 |
|
名稱
|
creator_user_id.name | string |
交易建立者的名稱。 |
|
Email
|
creator_user_id.email | string |
交易創建者的電子郵件。 |
|
Id
|
user_id.id | integer |
交易擁有者的識別碼。 |
|
名稱
|
user_id.name | string |
交易擁有者的名稱。 |
|
Email
|
user_id.email | string |
交易擁有者的電子郵件。 |
|
名稱
|
person_id.name | string |
與交易相關聯的人員名稱。 |
|
Id
|
person_id.value | integer |
與交易相關聯之人員的標識碼。 |
|
名稱
|
org_id.name | string |
與交易相關聯的組織名稱。 |
|
Id
|
org_id.value | integer |
與交易相關聯之組織的識別碼。 |
|
地位
|
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 |
|
階段識別碼
|
stage_id | integer |
交易放置在管線中的階段識別碼。 |
|
舞台 Uodated Date-Time
|
stage_change_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
處於活動狀態
|
active | boolean |
如果交易處於作用中狀態，則為 True。 |
|
已刪除
|
deleted | boolean |
如果交易已刪除，則為 True。 |
|
下一個活動日期
|
next_activity_date | string |
yyyy-MM-dd |
|
下次活動時間
|
next_activity_time | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
下一個活動標識符
|
next_activity_id | integer |
下一個活動的 ID。 |
|
上次活動標識符
|
last_activity_id | integer |
最後一個活動的標識碼。 |
|
上次活動日期
|
last_activity_date | string |
yyyy-MM-dd |
|
失去理智
|
lost_reason | string |
有關交易丟失原因的消息（在 status=lost 時使用）。 |
|
可見性
|
visible_to | string |
所有者、追隨者或整個公司。 |
|
關閉 Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
管線識別碼
|
pipeline_id | integer |
與交易相關聯的管線標識碼。 |
|
產品數量
|
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 |
與交易相關聯的已撤銷活動數目。 |
|
參考活動計數
|
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 |
與交易相關聯的下一個活動注意事項 |