Pipedrive
Pipedrive je nástroj pro správu kanálů a CRM, který vám pomůže soustředit se na akce, které jsou důležité.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL |
Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://www.pipedrive.com/ |
| Zásady ochrany osobních údajů | https://www.pipedrive.com/privacy |
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč rozhraní API | securestring | Klíč rozhraní API | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
| Frekvence dotazování triggerů | 1 | 120 sekund |
Akce
| Aktualizace fáze dohody (V2) (Preview) |
Tato operace slouží k aktualizaci fáze přidružené k dohodě vzhledem k ID. |
| Aktualizace stavu dohody |
Tato operace slouží k aktualizaci stavu přidruženého k dohodě vzhledem k ID. |
| Fáze aktualizace dohody [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte fázi dohody o aktualizaci (V2).
|
| Přidat dohodu [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte možnost Přidat dohodu (V2 ).
|
| Přidání aktivity |
Tato operace slouží k vytvoření nové aktivity pro autorizovaný účet. |
| Přidání dohody (V2) (Preview) |
Tato operace vytvoří novou dohodu pro autorizovaný účet. |
| Získání dohody podle ID |
Tato operace načte všechny podrobnosti existující dohody s id. |
| Získání fáze podle ID |
Tato operace vrací data o konkrétní fázi. |
Aktualizace fáze dohody (V2) (Preview)
Tato operace slouží k aktualizaci fáze přidružené k dohodě vzhledem k ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID dohody
|
dealId | True | integer |
Obchodovat |
|
ID kanálu
|
pipeline_id | True | string |
ID kanálu, ze které se mají načítat fáze. |
|
ID fáze
|
stage_id | True | string |
Fáze dohody. |
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
Návraty
data
- Body
- DealResponseV2
Aktualizace stavu dohody
Tato operace slouží k aktualizaci stavu přidruženého k dohodě vzhledem k ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID dohody
|
dealId | True | integer |
Obchodovat |
|
Stav
|
status | True | string |
Stav dohody. |
|
Důvod ztráty
|
lost_reason | string |
Zpráva o tom, proč došlo ke ztrátě dohody. |
Návraty
data
- Body
- DealResponse
Fáze aktualizace dohody [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte fázi dohody o aktualizaci (V2).
Tato operace slouží k aktualizaci fáze přidružené k dohodě vzhledem k ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID dohody
|
dealId | True | integer |
Obchodovat |
|
ID fáze
|
stage_id | True | string |
Fáze dohody. |
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
Návraty
data
- Body
- DealResponse
Přidat dohodu [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte možnost Přidat dohodu (V2 ).
Tato operace vytvoří novou dohodu pro autorizovaný účet.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Název dohody. |
|
ID fáze
|
stage_id | string |
Fáze dohody. |
|
|
Stav
|
status | string |
Stav dohody. |
|
|
Hodnota
|
value | integer |
Peněžní hodnota dohody. |
|
|
Měna
|
currency | string |
Měna dohody. |
|
|
ID kontaktu
|
person_id | string |
ID uživatele osoby, ke které je dohoda přidružena. |
|
|
ID organizace
|
org_id | string |
ID organizace přidružené k dohodě. |
|
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Vlastník, sledující nebo celá společnost. |
Návraty
data
- Body
- DealResponse
Přidání aktivity
Tato operace slouží k vytvoření nové aktivity pro autorizovaný účet.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ
|
type | True | string |
Typ aktivity. |
|
Předmět
|
subject | True | string |
Předmět činnosti. |
|
Termín splnění
|
due_date | string |
YYYY-MM-DD |
|
|
Termín splnění
|
due_time | string |
HH:MM |
|
|
Doba trvání
|
duration | string |
HH:MM |
|
|
Poznámky
|
note | string | ||
|
Přiřazeno komu
|
user_id | integer |
ID uživatele, kterému se bude aktivita přiřazovat. |
|
|
ID dohody
|
deal_id | integer |
ID dohody, ke které se aktivita přidružuje. |
|
|
ID kontaktu
|
person_id | integer |
ID osoby, ke které bude aktivita přidružena. |
|
|
ID organizace
|
org_id | integer |
ID organizace, ke které bude aktivita přidružená. |
Návraty
data
- Body
- ActivityResponse
Přidání dohody (V2) (Preview)
Tato operace vytvoří novou dohodu pro autorizovaný účet.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Název dohody. |
|
ID kanálu
|
pipeline_id | string |
ID kanálu, ze které se mají načítat fáze. |
|
|
ID fáze
|
stage_id | string |
Fáze dohody. |
|
|
Stav
|
status | string |
Stav dohody. |
|
|
Hodnota
|
value | integer |
Peněžní hodnota dohody. |
|
|
Měna
|
currency | string |
Měna dohody. |
|
|
ID kontaktu
|
person_id | string |
ID uživatele osoby, ke které je dohoda přidružena. |
|
|
ID organizace
|
org_id | string |
ID organizace přidružené k dohodě. |
|
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Vlastník, sledující nebo celá společnost. |
Návraty
data
- Body
- DealResponseV2
Získání dohody podle ID
Tato operace načte všechny podrobnosti existující dohody s id.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID dohody
|
dealId | True | integer |
Obchodovat |
Návraty
data
- Body
- DealResponse
Získání fáze podle ID
Tato operace vrací data o konkrétní fázi.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID fáze
|
stageId | True | integer |
ID fáze |
Návraty
- Body
- StageResponse
Aktivační události
| Při přidání nové aktivity |
Aktivuje se při přidání nové aktivity do autorizovaného účtu. |
| Při přidání nové dohody (V2) (Preview) |
Aktivuje se při přidání nové dohody do autorizovaného účtu (V2). |
| Při přidání nové dohody [ZASTARALÉ] |
Tato akce je zastaralá. Použijte místo toho novou dohodu (V2).
|
Při přidání nové aktivity
Při přidání nové dohody (V2) (Preview)
Při přidání nové dohody [ZASTARALÉ]
Tato akce je zastaralá. Použijte místo toho novou dohodu (V2).
Aktivuje se při přidání nové dohody do autorizovaného účtu.
Návraty
data
- Body
- DealResponse
Definice
StageResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID fáze
|
id | integer |
ID fáze |
|
Název fáze
|
name | string |
Název fáze |
ActivityResponse
data
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID aktivity
|
id | integer |
Jedinečné ID aktivity |
|
ID uživatele
|
user_id | integer |
ID uživatele, kterému je aktivita přiřazena. |
|
Hotovo
|
done | boolean |
0 = Není hotovo, 1 = Hotovo |
|
Typ
|
type | string |
Typ aktivity |
|
Termín splnění
|
due_date | string |
YYYY-MM-DD |
|
Termín splnění
|
due_time | string |
HH:MM |
|
Doba trvání
|
duration | string |
HH:MM |
|
Předmět
|
subject | string |
Předmět činnosti. |
|
ID dohody
|
deal_id | integer |
ID dohody, ke které je aktivita přidružená. |
|
Název dohody
|
deal_title | string |
Název dohody, ke které se aktivita přidružuje. |
|
ID organizace
|
org_id | integer |
ID organizace, ke které je aktivita přidružená. |
|
Název organizace
|
org_name | string |
Název organizace, ke které je aktivita přidružená. |
|
ID kontaktu
|
person_id | integer |
ID osoby, ke které je aktivita přidružená. |
|
Jméno kontaktu
|
person_name | string |
Jméno osoby, ke které je aktivita přidružená. |
|
Vytvořeno Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Aktualizace Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Dokončeno Date-Time
|
marked_as_done_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID události kalendáře Google
|
gcal_event_id | string |
ID události kalendáře Google. |
|
ID kalendáře Google
|
google_calendar_id | string |
ID kalendáře Google. |
|
Poznámka:
|
note | string |
Všimněte si aktivity (formát HTML). |
|
Přiřazeno komu
|
assigned_to_user_id | integer |
ID uživatele, kterému je aktivita přiřazena. |
|
Vytvořil(a)
|
created_by_user_id | integer |
ID uživatele, který aktivitu vytvořil |
|
Jméno vlastníka
|
owner_name | string |
Jméno vlastníka aktivity. |
DealResponse
data
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID dohody
|
id | integer |
ID dohody. |
|
identifikační číslo
|
creator_user_id.id | integer |
ID tvůrce dohody. |
|
Název
|
creator_user_id.name | string |
Jméno tvůrce dohody. |
|
Email
|
creator_user_id.email | string |
E-mail tvůrce dohody |
|
identifikační číslo
|
user_id.id | integer |
ID vlastníka dohody. |
|
Název
|
user_id.name | string |
Jméno vlastníka dohody. |
|
Email
|
user_id.email | string |
E-mail vlastníka dohody |
|
Název
|
person_id.name | string |
Jméno osoby přidružené k dohodě. |
|
identifikační číslo
|
person_id.value | integer |
ID osoby přidružené k dohodě. |
|
Název
|
org_id.name | string |
Název organizace přidružené k dohodě. |
|
identifikační číslo
|
org_id.value | integer |
ID organizace přidružené k dohodě. |
|
Stav
|
status | string |
Otevřete, vyhráli, ztratili nebo odstranili. |
|
Název dohody
|
title | string |
Název dohody. |
|
Hodnota dohody
|
value | number |
Peněžní hodnota dohody. |
|
Měna
|
currency | string |
Měna přidružená k hodnotě dohody. |
|
Vytvořeno Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Aktualizace Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID fáze
|
stage_id | integer |
ID fáze, ve které se obchod nachází, se umístí do kanálu. |
|
Název fáze
|
stage_name | string |
Název fáze, ve které se obchod umístí do kanálu |
|
Date-Time dílčí fáze
|
stage_change_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Je aktivní
|
active | boolean |
Hodnota True, pokud je obchod aktivní. |
|
Je odstraněno.
|
deleted | boolean |
Hodnota True, pokud byla dohoda odstraněna. |
|
Datum další aktivity
|
next_activity_date | string |
yyyy-MM-dd |
|
Čas příští aktivity
|
next_activity_time | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID další aktivity
|
next_activity_id | integer |
ID další aktivity. |
|
ID poslední aktivity
|
last_activity_id | integer |
ID poslední aktivity. |
|
Datum poslední aktivity
|
last_activity_date | string |
yyyy-MM-dd |
|
Důvod ztráty
|
lost_reason | string |
Zpráva o tom, proč došlo ke ztrátě dohody (k použití při ztrátě stavu). |
|
Visiblity
|
visible_to | string |
Vlastník, sledující nebo celá společnost. |
|
Uzavřená Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID kanálu
|
pipeline_id | integer |
ID kanálu, ke které je dohoda přidružená. |
|
Počet produktů
|
products_count | integer |
Počet produktů spojených s dohodou |
|
Počet souborů
|
files_count | integer |
Početsouborůch |
|
Počet poznámek
|
notes_count | integer |
Počet poznámek spojených s dohodou |
|
Počet sledujících uživatelů
|
followers_count | integer |
Počet sledujících přidružených k dohodě. |
|
Počet e-mailových zpráv
|
email_messages_count | integer |
Počet e-mailových zpráv přidružených k dohodě |
|
Počet aktivit
|
activities_count | integer |
Počet aktivit spojených s dohodou |
|
Počet dokončených aktivit
|
done_activities_count | integer |
Počet provedených aktivit spojených s dohodou |
|
Počet vrácených aktivit
|
undone_activities_count | integer |
Počet vrácených aktivit spojených s obchody. |
|
Počet odkazovaných aktivit
|
reference_activities_count | integer |
Počet odkazovaných aktivit spojených s dohodou |
|
Počet účastníků
|
participants_count | integer |
Počet účastníků přidružených k dohodě |
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
|
Předmět další aktivity
|
next_activity_subject | string |
Předmět další činnosti spojené s dohodou. |
|
Typ další aktivity
|
next_activity_type | string |
Typ další aktivity spojené s dohodou |
|
Doba trvání další aktivity
|
next_activity_duration | string |
Doba trvání další aktivity spojené s dohodou. |
|
Poznámka k další aktivitě
|
next_activity_note | string |
Poznámky k další aktivitě spojené s dohodou |
DealResponseV2
data
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID dohody
|
id | integer |
ID dohody. |
|
identifikační číslo
|
creator_user_id.id | integer |
ID tvůrce dohody. |
|
Název
|
creator_user_id.name | string |
Jméno tvůrce dohody. |
|
Email
|
creator_user_id.email | string |
E-mail tvůrce dohody |
|
identifikační číslo
|
user_id.id | integer |
ID vlastníka dohody. |
|
Název
|
user_id.name | string |
Jméno vlastníka dohody. |
|
Email
|
user_id.email | string |
E-mail vlastníka dohody |
|
Název
|
person_id.name | string |
Jméno osoby přidružené k dohodě. |
|
identifikační číslo
|
person_id.value | integer |
ID osoby přidružené k dohodě. |
|
Název
|
org_id.name | string |
Název organizace přidružené k dohodě. |
|
identifikační číslo
|
org_id.value | integer |
ID organizace přidružené k dohodě. |
|
Stav
|
status | string |
Otevřete, vyhráli, ztratili nebo odstranili. |
|
Název dohody
|
title | string |
Název dohody. |
|
Hodnota dohody
|
value | number |
Peněžní hodnota dohody. |
|
Měna
|
currency | string |
Měna přidružená k hodnotě dohody. |
|
Vytvořeno Date-Time
|
add_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Aktualizace Date-Time
|
update_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID fáze
|
stage_id | integer |
ID fáze, ve které se obchod nachází, se umístí do kanálu. |
|
Date-Time dílčí fáze
|
stage_change_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Je aktivní
|
active | boolean |
Hodnota True, pokud je obchod aktivní. |
|
Je odstraněno.
|
deleted | boolean |
Hodnota True, pokud byla dohoda odstraněna. |
|
Datum další aktivity
|
next_activity_date | string |
yyyy-MM-dd |
|
Čas příští aktivity
|
next_activity_time | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID další aktivity
|
next_activity_id | integer |
ID další aktivity. |
|
ID poslední aktivity
|
last_activity_id | integer |
ID poslední aktivity. |
|
Datum poslední aktivity
|
last_activity_date | string |
yyyy-MM-dd |
|
Důvod ztráty
|
lost_reason | string |
Zpráva o tom, proč došlo ke ztrátě dohody (k použití při ztrátě stavu). |
|
Visiblity
|
visible_to | string |
Vlastník, sledující nebo celá společnost. |
|
Uzavřená Date-Time
|
close_time | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID kanálu
|
pipeline_id | integer |
ID kanálu, ke které je dohoda přidružená. |
|
Počet produktů
|
products_count | integer |
Počet produktů spojených s dohodou |
|
Počet souborů
|
files_count | integer |
Početsouborůch |
|
Počet poznámek
|
notes_count | integer |
Počet poznámek spojených s dohodou |
|
Počet sledujících uživatelů
|
followers_count | integer |
Počet sledujících přidružených k dohodě. |
|
Počet e-mailových zpráv
|
email_messages_count | integer |
Počet e-mailových zpráv přidružených k dohodě |
|
Počet aktivit
|
activities_count | integer |
Počet aktivit spojených s dohodou |
|
Počet dokončených aktivit
|
done_activities_count | integer |
Počet provedených aktivit spojených s dohodou |
|
Počet vrácených aktivit
|
undone_activities_count | integer |
Počet vrácených aktivit spojených s obchody. |
|
Počet odkazovaných aktivit
|
reference_activities_count | integer |
Počet odkazovaných aktivit spojených s dohodou |
|
Počet účastníků
|
participants_count | integer |
Počet účastníků přidružených k dohodě |
|
Očekávané datum uzavření
|
expected_close_date | string |
yyyy-MM-dd |
|
Předmět další aktivity
|
next_activity_subject | string |
Předmět další činnosti spojené s dohodou. |
|
Typ další aktivity
|
next_activity_type | string |
Typ další aktivity spojené s dohodou |
|
Doba trvání další aktivity
|
next_activity_duration | string |
Doba trvání další aktivity spojené s dohodou. |
|
Poznámka k další aktivitě
|
next_activity_note | string |
Poznámky k další aktivitě spojené s dohodou |