Tracciamento dei clic Pipedrive: deal generati dai click sugli short link

Il tracciamento dei clic Pipedrive in Elido trasforma i traguardi degli short link in eventi di pipeline. Quando uno dei tuoi link supera 100, 1.000 o 10.000 clic, un cron di 5 minuti crea un deal nella pipeline Pipedrive che hai scelto, intitolato con lo slug del link e il traguardo raggiunto. Sono previste note del deal con la sorgente UTM e un deep link di ritorno verso Elido. Nessuno Zapier in mezzo, nessun export manuale, nessun promemoria in calendario per controllare i report dei link.

Questo è il titolo. La meccanica conta di più, quindi questo articolo affronta le tre cose che i team di sales ops devono verificare prima di attivare questa funzione. Primo, come funziona davvero il flusso di connessione: dove vive il token API personale, cosa legge il selettore di pipeline, e come viene archiviato il token dopo averlo incollato. Secondo, cosa fa il cron delle soglie a ogni esecuzione e come evita di creare deal duplicati quando un link diventa virale nel giro di una notte. Terzo, cosa puoi e non puoi cambiare oltre le tre soglie predefinite, e cosa è previsto in futuro.

Pipedrive è diventato disponibile per Elido il 22 maggio 2026. Prima è rimasto due settimane in Beta mentre sistemavamo i casi limite legati agli ID degli stage e alla rotazione dei token. Il codice dell'integrazione si trova in services/api-core/internal/integrations/pipedrive/ se fai self-hosting e vuoi leggere i sorgenti. Dove qualcosa qui sotto è previsto ma non ancora rilasciato, l'articolo lo indica.

Connettere Pipedrive in due minuti

Apri il catalogo delle integrazioni nel tuo workspace Elido e clicca sulla card Pipedrive. La modale di connessione chiede prima una sola cosa: un token API personale. Lo ottieni dal tuo account Pipedrive aprendo il menu del profilo, scegliendo Preferenze personali, poi la scheda API. La guida ufficiale di Pipedrive su come trovare il Personal API token mostra il percorso esatto con gli screenshot, dato che la loro interfaccia cambia più o meno ogni trimestre.

Incolla il token. Elido fa due cose in background. Valida il token chiamando GET /users/me sulla API di Pipedrive, il che conferma che il token è attivo e ci dice a quale azienda Pipedrive appartiene. Recupera anche l'elenco delle pipeline attive per quell'azienda, così il passo successivo della modale mostra opzioni reali e non campi di testo libero.

La modale pone poi un'ultima domanda: in quale pipeline devono atterrare i nuovi deal? Il menu a tendina è popolato dai tuoi dati Pipedrive in tempo reale. Se hai tre pipeline chiamate Inbound, Outbound e Partners, vedi proprio quelle tre. Scegli quella più adatta al lavoro, di solito Inbound per i segnali generati dal marketing, e clicca su Connetti. I deal atterrano sul primo stage di quella pipeline; la possibilità di scegliere uno stage target diverso è prevista.

Cosa succede al token dopo la connessione. Elido lo cifra prima che raggiunga Postgres, usando cifratura a busta con una chiave di cifratura dati per tenant avvolta da una chiave KMS di workspace. Il blob cifrato è ciò che risiede nella tabella integration_credentials. Il token in chiaro esiste in memoria solo per la durata di una singola chiamata API, e non lo registriamo mai nei log, nemmeno a livello di debug. Se ruoti il token in Pipedrive, la successiva esecuzione del cron riceve un 401 ed Elido contrassegna l'integrazione come da riautenticare, cosa che si manifesta come un banner nel workspace, non come un fallimento silenzioso. L'igiene della rotazione spetta a te; il guasto è rumoroso.

Il selettore di pipeline è un dettaglio piccolo ma importante. Un modo di fallire comune nelle integrazioni CRM è creare deal nella pipeline sbagliata perché l'integrazione fu costruita quando l'azienda aveva una sola pipeline e ora ne ha sei. Lasciare che sia l'utente a scegliere in fase di connessione, mostrando l'elenco aggiornato invece di uno memorizzato in cache un mese prima, elimina del tutto questa classe di errori. Puoi anche riconnetterti in qualsiasi momento per cambiare il target del selettore senza perdere lo storico delle soglie.

Cosa fa davvero il cron di 5 minuti

Dentro services/api-core c'è un job chiamato click_threshold_hook. Viene eseguito ogni cinque minuti. A ogni tick fa tre cose in ordine, per ogni workspace con Pipedrive connesso.

Primo, elenca i link attivi del workspace e legge il contatore di clic in tempo reale di ciascuno, lo stesso contatore che il servizio di redirect incrementa a ogni clic. I link eliminati e inattivi vengono saltati.

Secondo, confronta il nuovo totale di ogni link con le soglie registrate. Le soglie predefinite sono 100, 1.000 e 10.000. Per ogni link, Elido registra ogni soglia che ha già prodotto un deal in una riga della tabella integration_pipedrive_deals, indicizzata per workspace, link e soglia. Se un link era a 80 clic all'ultima esecuzione ed è ora a 240, il confronto mostra che la soglia di 100 è stata superata mentre quella di 1.000 non è ancora stata toccata. Segniamo 100 come raggiunta e mettiamo in coda una creazione di deal. Se un link è passato da 80 a 1.200, sia 100 che 1.000 sono state superate, quindi mettiamo in coda due creazioni.

Terzo, per ogni deal in coda, Elido chiama la Deals API di Pipedrive con un POST a /deals. Il corpo imposta l'ID pipeline scelto nel selettore di connessione, chiama il deal Engagement: <slug> (<threshold> clicks), e lascia il valore a zero. Scrivere la sorgente UTM, il medium e la campagna in una nota del deal con un link di ritorno alla vista analytics di Elido è previsto, così come memorizzare l'ID del link in un campo personalizzato Pipedrive.

Alcune cose che questo cron non fa. Non ritenta all'interno dello stesso tick. Se Pipedrive restituisce un errore, per quella soglia non viene registrato nulla, quindi il tick successivo semplicemente riprova. Il rate limit di Pipedrive è in pratica di 100 richieste ogni 2 secondi per token aziendale, il che lascia ampio margine per i volumi che la maggior parte dei team raggiungerà. Inoltre guarda solo ai link attivi, quindi i link eliminati o inattivi non creano mai deal.

La prevenzione dei duplicati poggia su quella tabella. Prima di ogni creazione, il cron controlla se esiste già una riga (workspace_id, link_id, threshold_bucket), e l'inserimento successivo è protetto da un vincolo univoco sulle stesse tre colonne, quindi un crash seguito da una nuova esecuzione non produce un secondo deal per lo stesso traguardo.

Andare oltre le tre soglie predefinite

Le soglie rilasciate sono 100, 1.000 e 10.000. La maggior parte dei team le mantiene perché si adattano naturalmente a una narrativa di vendita. Cento clic sono un segnale debole che merita uno sguardo. Mille è una campagna che vale una chiamata. Diecimila è abbastanza caldo che un commerciale dovrebbe già essersi mosso. Detto questo, potresti volere numeri diversi, e oggi non puoi impostarli.

L'integrazione Pipedrive di Elido usa gli stessi tre traguardi per ogni workspace, e non esiste ancora un endpoint o un'impostazione per un elenco di soglie personalizzato.

Trigger più sofisticati sono nella roadmap, non ancora rilasciati. Il piano dell'integrazione include un trigger di soglia ristretto a una campagna con un UTM candidato a deal, e un trigger di conversione che crea un deal con il valore dell'ordine catturato. Anche gli stage target configurabili dall'utente e i campi personalizzati Pipedrive come Deal Source o Lead Channel sono previsti per la prossima versione. Finché non arrivano, se ti serve un filtro UTM o un aggregato per cartella, interroga l'API analytics di Elido dal tuo job e crea il deal tramite l'API di Pipedrive per conto tuo.

Dove vive il token e come ruotarlo

Una sezione breve perché emerge in ogni revisione di sicurezza. Il token API personale è cifrato a riposo con AES-256-GCM usando una chiave di cifratura dati per tenant. La DEK è a sua volta avvolta da una chiave a livello di workspace nel nostro KMS, e solo il processo api-core può decifrarla. Non esiste alcun token in chiaro in nessun log, backup o traccia di errore. Lo abbiamo testato con un'iniezione di guasto che ha forzato un 401 di Pipedrive a metà richiesta, e il percorso di errore ripulisce il token dalla risposta prima che raggiunga Sentry.

Per ruotare: genera un nuovo token API personale in Pipedrive, revoca quello vecchio, poi incolla il nuovo nella modale di connessione di Elido. L'integrazione valida il nuovo token, lo sostituisce e il tick del cron successivo lo usa. Se dimentichi di aggiornare Elido dopo aver revocato il vecchio token, il tick del cron successivo riceve un 401 e l'integrazione entra nello stato Necessita riautenticazione, visibile come un banner giallo sulla dashboard del workspace. Nessun token morto in silenzio.

Nel self-hosting il KMS è configurabile: basato su file per impostazione predefinita, sostituibile con HashiCorp Vault o il tuo KMS cloud. ADR-0036 copre i dettagli.

Come si inserisce in un funnel più ampio

I trigger di deal Pipedrive dai clic sono un tassello di un pattern più grande. I conteggi dei clic sono un indicatore anticipatore, non un numero di fatturato, quindi in genere vuoi che confluiscano in un CRM dove vive il resto del contesto di vendita. Il deal è il passaggio di consegne: il marketing ha fatto il suo lavoro, le vendite lo raccolgono. Da lì i tuoi normali workflow Pipedrive prendono il sopravvento: assegnare il deal a un commerciale, valutarlo, farlo avanzare tra gli stage, chiuderlo.

Se stai anche inoltrando conversioni alle piattaforme pubblicitarie, gli stessi dati di clic alimentano entrambi i flussi. La funzione di conversion tracking gestisce il lato ads, l'integrazione Pipedrive gestisce il lato CRM, e le due non si contendono mai lo stesso evento. Vediamo questa combinazione più spesso nella pagina delle soluzioni per marketer, dove l'intero stack va dall'acquisizione a pagamento a link brandizzati fino a un funnel CRM.

Per gli analisti che vogliono mantenere onesti i propri numeri, due articoli precedenti coprono le questioni a monte. Short link analytics: cosa misurare copre quali metriche di clic correlano davvero con il fatturato, e Traccia gli UTM end-to-end copre l'igiene UTM che rende utili le note del deal invece che rumorose. Entrambi si abbinano bene a questa integrazione, dato che il deal creato da Pipedrive è utile solo quanto i dati UTM che porta con sé.

Un ultimo dettaglio sui piani. L'integrazione Pipedrive è disponibile su ogni livello Elido a pagamento, e la prova di 14 giorni la include così puoi validare il tuo elenco di soglie prima di sottoscrivere. I workspace gratuiti possono creare la connessione per testare, ma il cron non si attiva per i link gratuiti. La pagina dei prezzi riporta il dettaglio per livello.

Checklist di configurazione

Stampala, seguila una volta sola.

1. In Pipedrive: menu del profilo, Preferenze personali, scheda API, copia il token.
2. In Elido: Integrazioni, card Pipedrive, Connetti.
3. Incolla il token. Attendi la validazione.
4. Scegli la pipeline. Predefinito Inbound; i deal atterrano sul suo primo stage.
5. Clicca su Connetti.
6. Attendi cinque minuti. Invia qualche clic di test. Osserva l'arrivo del primo deal.

Tutto qui. Se fai self-hosting, il cron gira dentro il processo api-core invece che come job separato, e richiede la connessione Redis e la chiave master dei secret configurate; senza entrambe si disattiva in silenzio. Su Elido Cloud il cron è gestito per te.