Pipedrive

Pipedrive è uno strumento di gestione di CRM e pipeline che consente di concentrarsi sulle azioni importanti.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Microsoft
URL	Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps

Metadati del connettore
Editore	Microsoft
Sito web	https://www.pipedrive.com/
Informativa sulla privacy	https://www.pipedrive.com/privacy

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
Chiave API	securestring	Chiave API	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi
Frequenza dei polling dei trigger	1	120 secondi

Azioni

Aggiornare lo stato della trattativa	Questa operazione viene usata per aggiornare lo stato associato a una trattativa, dato il relativo ID.
Aggiungere un'attività	Questa operazione viene usata per creare una nuova attività per l'account autorizzato.
Aggiungi trattativa (V2) (anteprima)	Questa operazione crea una nuova trattativa per l'account autorizzato.
Aggiungi trattativa [DEPRECATO]	Questa azione è stata deprecata. Usare invece Aggiungi trattativa (V2). Questa operazione crea una nuova trattativa per l'account autorizzato.
Fase di aggiornamento della trattativa (V2) (anteprima)	Questa operazione viene usata per aggiornare la fase associata a una trattativa, in base all'ID.
Fase di aggiornamento della trattativa [DEPRECATO]	Questa azione è stata deprecata. Usare invece la fase di aggiornamento della trattativa (V2). Questa operazione viene usata per aggiornare la fase associata a una trattativa, in base all'ID.
Ottenere la fase in base all'ID	Questa operazione restituisce i dati relativi a una fase specifica.
Ottenere la trattativa in base all'ID	Questa operazione recupera tutti i dettagli di una trattativa esistente, in base al relativo ID.

Aggiornare lo stato della trattativa

ID operazione:

UpdateDealStatus

Questa operazione viene usata per aggiornare lo stato associato a una trattativa, dato il relativo ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID trattativa	dealId	True	integer	Affare
stato	status	True	string	Stato della trattativa.
Motivo perso	lost_reason		string	Messaggio sul motivo per cui la trattativa è stata persa.

Restituisce

data

Corpo

DealResponse

Aggiungere un'attività

ID operazione:

AddActivity

Questa operazione viene usata per creare una nuova attività per l'account autorizzato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
TIPO	type	True	string	Tipo di attività.
Oggetto	subject	True	string	Oggetto dell'attività.
Data di scadenza	due_date		string	AAAA-MM-DD
Scadenza	due_time		string	HH:MM
Durata	duration		string	HH:MM
Note	note		string
Assegnata a	user_id		integer	ID dell'utente a cui verrà assegnata l'attività.
ID trattativa	deal_id		integer	ID della trattativa a cui verrà associata l'attività.
ID contatto	person_id		integer	ID della persona a cui verrà associata l'attività.
ID organizzazione	org_id		integer	ID dell'organizzazione a cui verrà associata l'attività.

Restituisce

data

Corpo

ActivityResponse

Aggiungi trattativa (V2) (anteprima)

ID operazione:

AddDealV2

Questa operazione crea una nuova trattativa per l'account autorizzato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Titolo	title	True	string	Titolo della trattativa.
Pipeline Id	pipeline_id		string	ID della pipeline da cui recuperare le fasi.
ID fase	stage_id		string	Fase dell'accordo.
stato	status		string	Stato della trattativa.
Value	value		integer	Valore monetario dell'accordo.
Valuta	currency		string	Valuta dell'accordo.
ID contatto	person_id		string	ID utente della persona a cui è associata la trattativa.
ID organizzazione	org_id		string	ID dell'organizzazione associata alla trattativa.
Data di chiusura prevista	expected_close_date		string	yyyy-MM-dd
Visibilità	visible_to		string	Proprietario, follower o intera azienda.

Restituisce

data

Corpo

DealResponseV2

Aggiungi trattativa [DEPRECATO]

ID operazione:

AddDeal

Questa azione è stata deprecata. Usare invece Aggiungi trattativa (V2).

Questa operazione crea una nuova trattativa per l'account autorizzato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Titolo	title	True	string	Titolo della trattativa.
ID fase	stage_id		string	Fase dell'accordo.
stato	status		string	Stato della trattativa.
Value	value		integer	Valore monetario dell'accordo.
Valuta	currency		string	Valuta dell'accordo.
ID contatto	person_id		string	ID utente della persona a cui è associata la trattativa.
ID organizzazione	org_id		string	ID dell'organizzazione associata alla trattativa.
Data di chiusura prevista	expected_close_date		string	yyyy-MM-dd
Visibilità	visible_to		string	Proprietario, follower o intera azienda.

Restituisce

data

Corpo

DealResponse

Fase di aggiornamento della trattativa (V2) (anteprima)

ID operazione:

UpdateDealStageV2

Questa operazione viene usata per aggiornare la fase associata a una trattativa, in base all'ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID trattativa	dealId	True	integer	Affare
Pipeline Id	pipeline_id	True	string	ID della pipeline da cui recuperare le fasi.
ID fase	stage_id	True	string	Fase dell'accordo.
Data di chiusura prevista	expected_close_date		string	yyyy-MM-dd

Restituisce

data

Corpo

DealResponseV2

Fase di aggiornamento della trattativa [DEPRECATO]

ID operazione:

UpdateDealStage

Questa azione è stata deprecata. Usare invece la fase di aggiornamento della trattativa (V2).

Questa operazione viene usata per aggiornare la fase associata a una trattativa, in base all'ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID trattativa	dealId	True	integer	Affare
ID fase	stage_id	True	string	Fase dell'accordo.
Data di chiusura prevista	expected_close_date		string	yyyy-MM-dd

Restituisce

data

Corpo

DealResponse

Ottenere la fase in base all'ID

ID operazione:

GetStage

Questa operazione restituisce i dati relativi a una fase specifica.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID fase	stageId	True	integer	ID fase

Restituisce

Corpo

StageResponse

Ottenere la trattativa in base all'ID

ID operazione:

GetDeal

Questa operazione recupera tutti i dettagli di una trattativa esistente, in base al relativo ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID trattativa	dealId	True	integer	Affare

Restituisce

data

Corpo

DealResponse

Trigger

Quando viene aggiunta una nuova attività	Attiva quando viene aggiunta una nuova attività all'account autorizzato.
Quando viene aggiunta una nuova trattativa (V2) (anteprima)	Si attiva quando viene aggiunta una nuova trattativa all'account autorizzato (V2).
Quando viene aggiunta una nuova trattativa [DEPRECATO]	Questa azione è stata deprecata. Usare invece Quando viene aggiunta una nuova trattativa (V2). Si attiva quando viene aggiunta una nuova trattativa all'account autorizzato.

Quando viene aggiunta una nuova attività

ID operazione:

TrigNewActivity

Attiva quando viene aggiunta una nuova attività all'account autorizzato.

Restituisce

data

Corpo

ActivityResponse

Quando viene aggiunta una nuova trattativa (V2) (anteprima)

ID operazione:

TrigNewDealV2

Si attiva quando viene aggiunta una nuova trattativa all'account autorizzato (V2).

Restituisce

data

Corpo

DealResponseV2

Quando viene aggiunta una nuova trattativa [DEPRECATO]

ID operazione:

TrigNewDeal

Questa azione è stata deprecata. Usare invece Quando viene aggiunta una nuova trattativa (V2).

Si attiva quando viene aggiunta una nuova trattativa all'account autorizzato.

Restituisce

data

Corpo

DealResponse

Definizioni

StageResponse

Nome	Percorso	Tipo	Descrizione
ID fase	id	integer	ID fase
Nome fase	name	string	Nome della fase

ActivityResponse

data

Nome	Percorso	Tipo	Descrizione
ID attività	id	integer	ID univoco dell'attività.
ID utente	user_id	integer	ID dell'utente a cui è assegnata l'attività.
Operazione completata	done	boolean	0 = Non fatto, 1 = Operazione completata
TIPO	type	string	Tipo dell'attività.
Data di scadenza	due_date	string	AAAA-MM-DD
Scadenza	due_time	string	HH:MM
Durata	duration	string	HH:MM
Oggetto	subject	string	Oggetto dell'attività.
ID trattativa	deal_id	integer	ID della trattativa a cui è associata l'attività.
Titolo trattativa	deal_title	string	Titolo della trattativa a cui è associata l'attività.
ID organizzazione	org_id	integer	ID dell'organizzazione a cui è associata l'attività.
Nome organizzazione	org_name	string	Nome dell'organizzazione a cui è associata l'attività.
ID contatto	person_id	integer	ID della persona a cui è associata l'attività.
Nome del contatto	person_name	string	Nome della persona a cui è associata l'attività.
Creazione di Date-Time	add_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Aggiornamenti Date-Time	update_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Completato Date-Time	marked_as_done_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
ID evento di Google Calendar	gcal_event_id	string	ID dell'evento google calendar.
Google Calendar Id	google_calendar_id	string	ID del calendario google.
Annotazioni	note	string	Nota dell'attività (formato HTML).
Assegnata a	assigned_to_user_id	integer	ID utente dell'utente a cui è assegnata l'attività.
Creato da	created_by_user_id	integer	ID utente dell'utente che ha creato l'attività.
Nome proprietario	owner_name	string	Nome del proprietario dell'attività.

DealResponse

data

Nome	Percorso	Tipo	Descrizione
ID trattativa	id	integer	ID della trattativa.
id	creator_user_id.id	integer	ID dell'autore della trattativa.
Nome	creator_user_id.name	string	Nome dell'autore della trattativa.
Email	creator_user_id.email	string	Messaggio di posta elettronica dell'autore della trattativa.
id	user_id.id	integer	ID del proprietario della trattativa.
Nome	user_id.name	string	Nome del proprietario della trattativa.
Email	user_id.email	string	Indirizzo di posta elettronica del proprietario della trattativa.
Nome	person_id.name	string	Nome della persona associata alla trattativa.
id	person_id.value	integer	ID della persona associata alla trattativa.
Nome	org_id.name	string	Nome dell'organizzazione associata alla trattativa.
id	org_id.value	integer	ID dell'organizzazione associata alla trattativa.
stato	status	string	Aprire, vincere, perdere o eliminare.
Titolo trattativa	title	string	Titolo della trattativa.
Valore dell'accordo	value	number	Valore monetario dell'accordo.
Valuta	currency	string	Valuta associata al valore della trattativa.
Creazione di Date-Time	add_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Date-Time aggiornato	update_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
ID fase	stage_id	integer	ID della fase in cui la trattativa viene inserita in una pipeline.
Nome fase	stage_name	string	Nome della fase in cui la trattativa viene inserita in una pipeline
Stage Uodated Date-Time	stage_change_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
È attivo	active	boolean	True se la trattativa è attiva.
È Eliminato	deleted	boolean	True se la trattativa è stata eliminata.
Data attività successiva	next_activity_date	string	yyyy-MM-dd
Ora attività successiva	next_activity_time	string	aaaa-MM-ggTHH:mm:ss.fffZ
ID attività successivo	next_activity_id	integer	ID dell'attività successiva.
ULTIMO ID attività	last_activity_id	integer	ID dell'ultima attività.
Data ultima attività	last_activity_date	string	yyyy-MM-dd
Motivo perso	lost_reason	string	Messaggio sul motivo per cui la trattativa è stata persa (da usare quando status=lost).
Visibilità	visible_to	string	Proprietario, follower o intera azienda.
Date-Time chiuso	close_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Pipeline Id	pipeline_id	integer	ID della pipeline a cui è associata la trattativa.
Conteggio prodotti	products_count	integer	Numero di prodotti associati alla trattativa.
Conteggio file	files_count	integer	Numero di file associati alla trattativa.
Conteggio note	notes_count	integer	Numero di note associate alla trattativa.
Conteggio follower	followers_count	integer	Numero di follower associati all'accordo.
Numero messaggi di posta elettronica	email_messages_count	integer	Numero di messaggi di posta elettronica associati alla trattativa.
Conteggio attività	activities_count	integer	Numero di attività associate alla trattativa.
Conteggio attività completate	done_activities_count	integer	Numero di attività eseguite associate alla trattativa.
Conteggio attività annullate	undone_activities_count	integer	Numero di attività annullate associate alle trattative.
Conteggio delle attività a cui si fa riferimento	reference_activities_count	integer	Numero di attività di riferimento associate alla trattativa.
Conteggio partecipanti	participants_count	integer	Numero di partecipanti associati alla trattativa.
Data di chiusura prevista	expected_close_date	string	yyyy-MM-dd
Oggetto successivo dell'attività	next_activity_subject	string	Oggetto dell'attività successiva associata all'accordo.
Tipo di attività successivo	next_activity_type	string	Tipo di attività successiva associata alla trattativa.
Durata attività successiva	next_activity_duration	string	Durata dell'attività successiva associata alla trattativa.
Nota attività successiva	next_activity_note	string	Note per l'attività successiva associata alla trattativa

DealResponseV2

data

Nome	Percorso	Tipo	Descrizione
ID trattativa	id	integer	ID della trattativa.
id	creator_user_id.id	integer	ID dell'autore della trattativa.
Nome	creator_user_id.name	string	Nome dell'autore della trattativa.
Email	creator_user_id.email	string	Messaggio di posta elettronica dell'autore della trattativa.
id	user_id.id	integer	ID del proprietario della trattativa.
Nome	user_id.name	string	Nome del proprietario della trattativa.
Email	user_id.email	string	Indirizzo di posta elettronica del proprietario della trattativa.
Nome	person_id.name	string	Nome della persona associata alla trattativa.
id	person_id.value	integer	ID della persona associata alla trattativa.
Nome	org_id.name	string	Nome dell'organizzazione associata alla trattativa.
id	org_id.value	integer	ID dell'organizzazione associata alla trattativa.
stato	status	string	Aprire, vincere, perdere o eliminare.
Titolo trattativa	title	string	Titolo della trattativa.
Valore dell'accordo	value	number	Valore monetario dell'accordo.
Valuta	currency	string	Valuta associata al valore della trattativa.
Creazione di Date-Time	add_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Date-Time aggiornato	update_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
ID fase	stage_id	integer	ID della fase in cui la trattativa viene inserita in una pipeline.
Stage Uodated Date-Time	stage_change_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
È attivo	active	boolean	True se la trattativa è attiva.
È Eliminato	deleted	boolean	True se la trattativa è stata eliminata.
Data attività successiva	next_activity_date	string	yyyy-MM-dd
Ora attività successiva	next_activity_time	string	aaaa-MM-ggTHH:mm:ss.fffZ
ID attività successivo	next_activity_id	integer	ID dell'attività successiva.
ULTIMO ID attività	last_activity_id	integer	ID dell'ultima attività.
Data ultima attività	last_activity_date	string	yyyy-MM-dd
Motivo perso	lost_reason	string	Messaggio sul motivo per cui la trattativa è stata persa (da usare quando status=lost).
Visibilità	visible_to	string	Proprietario, follower o intera azienda.
Date-Time chiuso	close_time	date-time	aaaa-MM-ggTHH:mm:ss.fffZ
Pipeline Id	pipeline_id	integer	ID della pipeline a cui è associata la trattativa.
Conteggio prodotti	products_count	integer	Numero di prodotti associati alla trattativa.
Conteggio file	files_count	integer	Numero di file associati alla trattativa.
Conteggio note	notes_count	integer	Numero di note associate alla trattativa.
Conteggio follower	followers_count	integer	Numero di follower associati all'accordo.
Numero messaggi di posta elettronica	email_messages_count	integer	Numero di messaggi di posta elettronica associati alla trattativa.
Conteggio attività	activities_count	integer	Numero di attività associate alla trattativa.
Conteggio attività completate	done_activities_count	integer	Numero di attività eseguite associate alla trattativa.
Conteggio attività annullate	undone_activities_count	integer	Numero di attività annullate associate alle trattative.
Conteggio delle attività a cui si fa riferimento	reference_activities_count	integer	Numero di attività di riferimento associate alla trattativa.
Conteggio partecipanti	participants_count	integer	Numero di partecipanti associati alla trattativa.
Data di chiusura prevista	expected_close_date	string	yyyy-MM-dd
Oggetto successivo dell'attività	next_activity_subject	string	Oggetto dell'attività successiva associata all'accordo.
Tipo di attività successivo	next_activity_type	string	Tipo di attività successiva associata alla trattativa.
Durata attività successiva	next_activity_duration	string	Durata dell'attività successiva associata alla trattativa.
Nota attività successiva	next_activity_note	string	Note per l'attività successiva associata alla trattativa