Pipedrive
Pipedrive to narzędzie do zarządzania potokami i CRM, które pomaga skupić się na akcjach, które mają znaczenie.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://www.pipedrive.com/ |
| Zasady ochrony prywatności | https://www.pipedrive.com/privacy |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
| Częstotliwość sond wyzwalacza | 1 | 120 sekund |
Akcje
| Aktualizowanie stanu transakcji |
Ta operacja służy do aktualizowania stanu skojarzonego z transakcją, biorąc pod uwagę jego identyfikator. |
| Dodawanie działania |
Ta operacja służy do tworzenia nowego działania dla autoryzowanego konta. |
| Dodawanie transakcji (wersja 2) (wersja zapoznawcza) |
Ta operacja tworzy nową transakcję dla autoryzowanego konta. |
| Dodawanie transakcji [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Add deal (V2).
|
| Etap transakcji aktualizacji (wersja 2) (wersja zapoznawcza) |
Ta operacja służy do aktualizowania etapu skojarzonego z transakcją, biorąc pod uwagę jego identyfikator. |
| Etap transakcji aktualizacji [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj etapu transakcji aktualizacji (wersja 2).
|
| Pobieranie etapu według identyfikatora |
Ta operacja zwraca dane dotyczące określonego etapu. |
| Uzyskiwanie transakcji według identyfikatora |
Ta operacja pobiera wszystkie szczegóły istniejącej transakcji, biorąc pod uwagę jego identyfikator. |
Aktualizowanie stanu transakcji
Ta operacja służy do aktualizowania stanu skojarzonego z transakcją, biorąc pod uwagę jego identyfikator.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator transakcji
|
dealId | True | integer |
Transakcja |
|
Status
|
status | True | string |
Stan transakcji. |
|
Utracona przyczyna
|
lost_reason | string |
Wiadomość o tym, dlaczego transakcja została utracona. |
Zwraca
dane
- Body
- DealResponse
Dodawanie działania
Ta operacja służy do tworzenia nowego działania dla autoryzowanego konta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ
|
type | True | string |
Typ działania. |
|
Temat
|
subject | True | string |
Temat działania. |
|
Data upływu
|
due_date | string |
RRRR —MM-DD |
|
|
Czas ukończenia
|
due_time | string |
HH:MM |
|
|
Czas trwania
|
duration | string |
HH:MM |
|
|
Notatki
|
note | string | ||
|
Przypisano do
|
user_id | integer |
Identyfikator użytkownika, do którego zostanie przypisane działanie. |
|
|
Identyfikator transakcji
|
deal_id | integer |
Identyfikator transakcji, z którymi zostanie skojarzone działanie. |
|
|
Identyfikator kontaktu
|
person_id | integer |
Identyfikator osoby, z którą zostanie skojarzone działanie. |
|
|
Identyfikator organizacji
|
org_id | integer |
Identyfikator organizacji, z które będzie skojarzone działanie. |
Zwraca
dane
- Body
- ActivityResponse
Dodawanie transakcji (wersja 2) (wersja zapoznawcza)
Ta operacja tworzy nową transakcję dla autoryzowanego konta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Title
|
title | True | string |
Tytuł transakcji. |
|
Identyfikator potoku
|
pipeline_id | string |
Identyfikator potoku do pobrania etapów. |
|
|
Identyfikator etapu
|
stage_id | string |
Etap transakcji. |
|
|
Status
|
status | string |
Stan transakcji. |
|
|
Wartość
|
value | integer |
Wartość pieniężna transakcji. |
|
|
Waluta
|
currency | string |
Waluta transakcji. |
|
|
Identyfikator kontaktu
|
person_id | string |
Identyfikator użytkownika osoby, z którą jest skojarzona transakcja. |
|
|
Identyfikator organizacji
|
org_id | string |
Identyfikator organizacji skojarzonej z transakcją. |
|
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Właściciel, obserwatorzy lub cała firma. |
Zwraca
dane
- Body
- DealResponseV2
Dodawanie transakcji [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Add deal (V2).
Ta operacja tworzy nową transakcję dla autoryzowanego konta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Title
|
title | True | string |
Tytuł transakcji. |
|
Identyfikator etapu
|
stage_id | string |
Etap transakcji. |
|
|
Status
|
status | string |
Stan transakcji. |
|
|
Wartość
|
value | integer |
Wartość pieniężna transakcji. |
|
|
Waluta
|
currency | string |
Waluta transakcji. |
|
|
Identyfikator kontaktu
|
person_id | string |
Identyfikator użytkownika osoby, z którą jest skojarzona transakcja. |
|
|
Identyfikator organizacji
|
org_id | string |
Identyfikator organizacji skojarzonej z transakcją. |
|
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Właściciel, obserwatorzy lub cała firma. |
Zwraca
dane
- Body
- DealResponse
Etap transakcji aktualizacji (wersja 2) (wersja zapoznawcza)
Ta operacja służy do aktualizowania etapu skojarzonego z transakcją, biorąc pod uwagę jego identyfikator.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator transakcji
|
dealId | True | integer |
Transakcja |
|
Identyfikator potoku
|
pipeline_id | True | string |
Identyfikator potoku do pobrania etapów. |
|
Identyfikator etapu
|
stage_id | True | string |
Etap transakcji. |
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
Zwraca
dane
- Body
- DealResponseV2
Etap transakcji aktualizacji [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj etapu transakcji aktualizacji (wersja 2).
Ta operacja służy do aktualizowania etapu skojarzonego z transakcją, biorąc pod uwagę jego identyfikator.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator transakcji
|
dealId | True | integer |
Transakcja |
|
Identyfikator etapu
|
stage_id | True | string |
Etap transakcji. |
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
Zwraca
dane
- Body
- DealResponse
Pobieranie etapu według identyfikatora
Ta operacja zwraca dane dotyczące określonego etapu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator etapu
|
stageId | True | integer |
Identyfikator etapu |
Zwraca
- Body
- StageResponse
Uzyskiwanie transakcji według identyfikatora
Ta operacja pobiera wszystkie szczegóły istniejącej transakcji, biorąc pod uwagę jego identyfikator.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator transakcji
|
dealId | True | integer |
Transakcja |
Zwraca
dane
- Body
- DealResponse
Wyzwalacze
| Po dodaniu nowego działania |
Wyzwala po dodaniu nowego działania do autoryzowanego konta. |
| Po dodaniu nowej transakcji (wersja 2) (wersja zapoznawcza) |
Wyzwala wyzwalane po dodaniu nowej transakcji do autoryzowanego konta (V2). |
| Po dodaniu nowej transakcji [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Po dodaniu nowej transakcji (wersja 2).
|
Po dodaniu nowego działania
Po dodaniu nowej transakcji (wersja 2) (wersja zapoznawcza)
Wyzwala wyzwalane po dodaniu nowej transakcji do autoryzowanego konta (V2).
Zwraca
dane
- Body
- DealResponseV2
Po dodaniu nowej transakcji [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Po dodaniu nowej transakcji (wersja 2).
Wyzwala po dodaniu nowej transakcji do autoryzowanego konta.
Zwraca
dane
- Body
- DealResponse
Definicje
StageResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator etapu
|
id | integer |
Identyfikator etapu |
|
Nazwa etapu
|
name | string |
Pseudonim sceniczny |
ActivityResponse
dane
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator działania
|
id | integer |
Unikatowy identyfikator działania. |
|
Identyfikator użytkownika
|
user_id | integer |
Identyfikator użytkownika, do którego przypisano działanie. |
|
Jest gotowe
|
done | boolean |
0 = Nie gotowe, 1 = Gotowe |
|
Typ
|
type | string |
Typ działania. |
|
Data upływu
|
due_date | string |
RRRR —MM-DD |
|
Czas ukończenia
|
due_time | string |
HH:MM |
|
Czas trwania
|
duration | string |
HH:MM |
|
Temat
|
subject | string |
Temat działania. |
|
Identyfikator transakcji
|
deal_id | integer |
Identyfikator transakcji, z którymi jest skojarzone działanie. |
|
Tytuł transakcji
|
deal_title | string |
Tytuł transakcji, z którymi jest skojarzone działanie. |
|
Identyfikator organizacji
|
org_id | integer |
Identyfikator organizacji, z tym działaniem jest skojarzone. |
|
Nazwa organizacji
|
org_name | string |
Nazwa organizacji, z która jest skojarzona aktywność. |
|
Identyfikator kontaktu
|
person_id | integer |
Identyfikator osoby, z którą jest skojarzone działanie. |
|
Nazwa kontaktu
|
person_name | string |
Nazwisko osoby, z którą jest skojarzone działanie. |
|
Utworzono Date-Time
|
add_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Aktualizacje Date-Time
|
update_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Ukończono Date-Time
|
marked_as_done_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator zdarzenia kalendarza Google
|
gcal_event_id | string |
Identyfikator zdarzenia kalendarza google. |
|
Identyfikator kalendarza Google
|
google_calendar_id | string |
Identyfikator kalendarza google. |
|
Uwaga / Notatka
|
note | string |
Zanotuj działanie (format HTML). |
|
Przypisano do
|
assigned_to_user_id | integer |
Identyfikator użytkownika, do którego przypisano działanie. |
|
Utworzone przez
|
created_by_user_id | integer |
Identyfikator użytkownika, który utworzył działanie. |
|
Nazwa właściciela
|
owner_name | string |
Nazwa właściciela działania. |
DealResponse
dane
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator transakcji
|
id | integer |
Identyfikator transakcji. |
|
Id
|
creator_user_id.id | integer |
Identyfikator twórcy transakcji. |
|
Name
|
creator_user_id.name | string |
Nazwa twórcy transakcji. |
|
Email
|
creator_user_id.email | string |
Adres e-mail twórcy transakcji. |
|
Id
|
user_id.id | integer |
Identyfikator właściciela transakcji. |
|
Name
|
user_id.name | string |
Nazwa właściciela transakcji. |
|
Email
|
user_id.email | string |
Adres e-mail właściciela transakcji. |
|
Name
|
person_id.name | string |
Nazwisko osoby skojarzonej z transakcją. |
|
Id
|
person_id.value | integer |
Identyfikator osoby skojarzonej z transakcją. |
|
Name
|
org_id.name | string |
Nazwa organizacji skojarzonej z transakcją. |
|
Id
|
org_id.value | integer |
Identyfikator organizacji skojarzonej z transakcją. |
|
Status
|
status | string |
Otwarte, wygrane, utracone lub usunięte. |
|
Tytuł transakcji
|
title | string |
Tytuł transakcji. |
|
Wartość transakcji
|
value | number |
Wartość pieniężna transakcji. |
|
Waluta
|
currency | string |
Waluta skojarzona z wartością transakcji. |
|
Utworzono Date-Time
|
add_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Zaktualizowano Date-Time
|
update_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator etapu
|
stage_id | integer |
Identyfikator etapu transakcji jest umieszczany w potoku. |
|
Nazwa etapu
|
stage_name | string |
Nazwa etapu transakcji jest umieszczana w potoku |
|
Date-Time uodowane etapy
|
stage_change_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Jest aktywny
|
active | boolean |
Wartość true, jeśli transakcja jest aktywna. |
|
Jest usuwany
|
deleted | boolean |
Prawda, jeśli transakcja została usunięta. |
|
Data następnego działania
|
next_activity_date | string |
yyyy-MM-dd |
|
Czas następnego działania
|
next_activity_time | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Następny identyfikator działania
|
next_activity_id | integer |
Identyfikator następnego działania. |
|
Ostatni identyfikator działania
|
last_activity_id | integer |
Identyfikator ostatniego działania. |
|
Data ostatniego działania
|
last_activity_date | string |
yyyy-MM-dd |
|
Utracona przyczyna
|
lost_reason | string |
Komunikat o tym, dlaczego transakcja została utracona (do użycia, gdy status=utracono). |
|
Visiblity
|
visible_to | string |
Właściciel, obserwatorzy lub cała firma. |
|
Zamknięta Date-Time
|
close_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator potoku
|
pipeline_id | integer |
Identyfikator potoku, z którymi jest skojarzona transakcja. |
|
Liczba produktów
|
products_count | integer |
Liczba produktów skojarzonych z transakcją. |
|
Liczba plików
|
files_count | integer |
Liczba plików skojarzonych z transakcją. |
|
Liczba notatek
|
notes_count | integer |
Liczba notatek skojarzonych z transakcją. |
|
Liczba obserwujących
|
followers_count | integer |
Liczba obserwujących skojarzonych z transakcją. |
|
Liczba wiadomości e-mail
|
email_messages_count | integer |
Liczba wiadomości e-mail skojarzonych z transakcją. |
|
Liczba działań
|
activities_count | integer |
Liczba działań skojarzonych z transakcją. |
|
Liczba wykonanych działań
|
done_activities_count | integer |
Liczba wykonanych działań skojarzonych z transakcją. |
|
Liczba cofnięć działań
|
undone_activities_count | integer |
Liczba cofnięć aktywitie skojarzonych z transakcjami. |
|
Liczba działań, do których odwołuje się odwołanie
|
reference_activities_count | integer |
Liczba działań, do których odwołuje się transakcja. |
|
Liczba uczestników
|
participants_count | integer |
Liczba uczestników związanych z transakcją. |
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
|
Następny temat działania
|
next_activity_subject | string |
Temat następnego działania skojarzonego z transakcją. |
|
Następny typ działania
|
next_activity_type | string |
Typ następnego działania skojarzonego z transakcją. |
|
Następny czas trwania działania
|
next_activity_duration | string |
Czas trwania następnego działania skojarzonego z transakcją. |
|
Następna notatka o działaniu
|
next_activity_note | string |
Uwagi dotyczące następnego działania skojarzonego z transakcją |
DealResponseV2
dane
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator transakcji
|
id | integer |
Identyfikator transakcji. |
|
Id
|
creator_user_id.id | integer |
Identyfikator twórcy transakcji. |
|
Name
|
creator_user_id.name | string |
Nazwa twórcy transakcji. |
|
Email
|
creator_user_id.email | string |
Adres e-mail twórcy transakcji. |
|
Id
|
user_id.id | integer |
Identyfikator właściciela transakcji. |
|
Name
|
user_id.name | string |
Nazwa właściciela transakcji. |
|
Email
|
user_id.email | string |
Adres e-mail właściciela transakcji. |
|
Name
|
person_id.name | string |
Nazwisko osoby skojarzonej z transakcją. |
|
Id
|
person_id.value | integer |
Identyfikator osoby skojarzonej z transakcją. |
|
Name
|
org_id.name | string |
Nazwa organizacji skojarzonej z transakcją. |
|
Id
|
org_id.value | integer |
Identyfikator organizacji skojarzonej z transakcją. |
|
Status
|
status | string |
Otwarte, wygrane, utracone lub usunięte. |
|
Tytuł transakcji
|
title | string |
Tytuł transakcji. |
|
Wartość transakcji
|
value | number |
Wartość pieniężna transakcji. |
|
Waluta
|
currency | string |
Waluta skojarzona z wartością transakcji. |
|
Utworzono Date-Time
|
add_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Zaktualizowano Date-Time
|
update_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator etapu
|
stage_id | integer |
Identyfikator etapu transakcji jest umieszczany w potoku. |
|
Date-Time uodowane etapy
|
stage_change_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Jest aktywny
|
active | boolean |
Wartość true, jeśli transakcja jest aktywna. |
|
Jest usuwany
|
deleted | boolean |
Prawda, jeśli transakcja została usunięta. |
|
Data następnego działania
|
next_activity_date | string |
yyyy-MM-dd |
|
Czas następnego działania
|
next_activity_time | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Następny identyfikator działania
|
next_activity_id | integer |
Identyfikator następnego działania. |
|
Ostatni identyfikator działania
|
last_activity_id | integer |
Identyfikator ostatniego działania. |
|
Data ostatniego działania
|
last_activity_date | string |
yyyy-MM-dd |
|
Utracona przyczyna
|
lost_reason | string |
Komunikat o tym, dlaczego transakcja została utracona (do użycia, gdy status=utracono). |
|
Visiblity
|
visible_to | string |
Właściciel, obserwatorzy lub cała firma. |
|
Zamknięta Date-Time
|
close_time | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator potoku
|
pipeline_id | integer |
Identyfikator potoku, z którymi jest skojarzona transakcja. |
|
Liczba produktów
|
products_count | integer |
Liczba produktów skojarzonych z transakcją. |
|
Liczba plików
|
files_count | integer |
Liczba plików skojarzonych z transakcją. |
|
Liczba notatek
|
notes_count | integer |
Liczba notatek skojarzonych z transakcją. |
|
Liczba obserwujących
|
followers_count | integer |
Liczba obserwujących skojarzonych z transakcją. |
|
Liczba wiadomości e-mail
|
email_messages_count | integer |
Liczba wiadomości e-mail skojarzonych z transakcją. |
|
Liczba działań
|
activities_count | integer |
Liczba działań skojarzonych z transakcją. |
|
Liczba wykonanych działań
|
done_activities_count | integer |
Liczba wykonanych działań skojarzonych z transakcją. |
|
Liczba cofnięć działań
|
undone_activities_count | integer |
Liczba cofnięć aktywitie skojarzonych z transakcjami. |
|
Liczba działań, do których odwołuje się odwołanie
|
reference_activities_count | integer |
Liczba działań, do których odwołuje się transakcja. |
|
Liczba uczestników
|
participants_count | integer |
Liczba uczestników związanych z transakcją. |
|
Oczekiwana data zamknięcia
|
expected_close_date | string |
yyyy-MM-dd |
|
Następny temat działania
|
next_activity_subject | string |
Temat następnego działania skojarzonego z transakcją. |
|
Następny typ działania
|
next_activity_type | string |
Typ następnego działania skojarzonego z transakcją. |
|
Następny czas trwania działania
|
next_activity_duration | string |
Czas trwania następnego działania skojarzonego z transakcją. |
|
Następna notatka o działaniu
|
next_activity_note | string |
Uwagi dotyczące następnego działania skojarzonego z transakcją |