Connetti Pipedrive a Elido

L'integrazione Pipedrive crea trattative e aggiorna la loro fase quando Elido attiva un evento di conversione o un link supera una soglia di clic. Basato su API token — nessun OAuth, nessuna registrazione app.

Ottieni il tuo API token Pipedrive#

1. Accedi a Pipedrive.
2. Fai clic sul tuo avatar → Personal preferences → API.
3. Copia il token mostrato. È una stringa esadecimale di 40 caratteri. Non confonderlo con un client secret OAuth — questo è il token personale legato al tuo account.

Configura in Elido#

1. Vai su Dashboard → Webhook → Aggiungi Pipedrive.
2. Incolla l'API token. Fai clic su Recupera pipeline — Elido interroga l'API Pipedrive ed elenca ogni pipeline che il tuo account può vedere.
3. Seleziona la pipeline di destinazione e la fase predefinita della trattativa per le nuove trattative.
4. (Opzionale) Seleziona un utente proprietario per le trattative create automaticamente.
5. Fai clic su Salva.

Configura i trigger#

In Dashboard → Webhook → Pipedrive → Trigger, configura cosa attiva un'azione Pipedrive:

• Conversione registrata → crea una nuova trattativa. Il titolo della trattativa è impostato sullo slug del link e sulla campagna UTM se presente (es. spring-2026 / newsletter). Il campo valore viene popolato dal value e dalla currency dichiarati dalla conversione.
• Soglia superata → sposta una trattativa esistente alla fase successiva. Elido fa il match tramite il click_id del link memorizzato nel campo personalizzato della trattativa (lo configurerai nel passaggio 3 di seguito).
• Scansione fallita → crea una trattativa con un'etichetta "Needs review". Usalo se un link segnalato è un asset commerciale che necessita di follow-up manuale.

Aggiungi il campo personalizzato click_id (per il trigger di soglia)#

Affinché lo spostamento dalla soglia alla fase funzioni, Pipedrive deve memorizzare il click_id Elido nella trattativa in modo che Elido possa cercarla in seguito.

1. In Pipedrive, vai su Settings → Data fields → Deals → Add custom field.
2. Tipo: Text, etichetta: Elido Click ID.
3. Copia la chiave del campo (Pipedrive la mostra nella lista dei campi, es. 8b2a4c...).
4. Incollala in Dashboard → Webhook → Pipedrive → Click ID field key.

Cosa non si sincronizza#

• Trattative storiche — Elido crea trattative solo dagli eventi che avvengono dopo la connessione.
• Pipedrive → Elido — solo in uscita. Le modifiche di fase delle trattative in Pipedrive non influenzano i link Elido.

Risoluzione dei problemi#

"401 Unauthorized" — L'API token è errato. Confermalo chiamando https://api.pipedrive.com/v1/users/me?api_token=TOKEN in un browser. Se vedi il tuo profilo utente, il token è valido.

La pipeline non è nella lista — Il tuo utente Pipedrive potrebbe non avere accesso a quella pipeline. Le impostazioni di visibilità di Pipedrive possono limitare l'accesso alla pipeline per team. Verifica con il tuo amministratore Pipedrive.

Trattative create senza proprietario — Se il campo proprietario è vuoto nella configurazione Elido, le trattative vengono assegnate all'utente di cui hai usato l'API token. Imposta un proprietario esplicito se vuoi che le trattative siano assegnate altrove.

Trattative duplicate — Ogni evento di conversione crea una trattativa. Se vedi duplicati, controlla se lo stesso workspace Elido è configurato con due connessioni Pipedrive (raro ma possibile se hai ri-aggiunto l'integrazione).