8 Min. LesezeitIntegrationen

Pipedrive-Link-Klick-Tracking: Deals aus Short-Link-Treffern

Erstellt automatisch Pipedrive-Deals, wenn ein Elido-Short-Link 100, 1.000 oder 10.000 Klicks überschreitet. Einrichtung, Pipeline-Auswahl, Token-Rotation.

Ana Kowalska
Marketing solutions engineering
Pipedrive-Link-Klick-Tracking: Ein Short-Link speist Klickzahlen in einen 5-Minuten-Cronjob, der bei 100, 1.000 und 10.000 Klicks Pipedrive-Deals erstellt

Pipedrive-Link-Klick-Tracking in Elido macht aus Short-Link-Meilensteinen Pipeline-Ereignisse. Sobald einer deiner Links 100, 1.000 oder 10.000 Klicks überschreitet, erstellt ein 5-Minuten-Cronjob einen Deal in der von dir gewählten Pipedrive-Pipeline, betitelt mit dem Link-Slug und dem Meilenstein. Deal-Notizen mit der UTM-Quelle und einem Deep Link zurück zu Elido sind geplant. Kein Zapier dazwischen, kein manueller Export, keine Kalendererinnerung, um Link-Reports zu prüfen.

Das ist die Kurzfassung. Wichtiger ist die Mechanik dahinter, deshalb geht dieser Beitrag die drei Dinge durch, die Sales-Ops-Teams vertrauen müssen, bevor sie das aktivieren. Erstens, wie der Connect-Ablauf tatsächlich funktioniert: wo das persönliche API-Token liegt, was die Pipeline-Auswahl ausliest und wie das Token nach dem Einfügen gespeichert wird. Zweitens, was der Schwellenwert-Cronjob bei jedem Lauf tut und wie er verhindert, dass doppelte Deals entstehen, wenn ein Link über Nacht viral geht. Drittens, was du über die drei Standard-Schwellenwerte hinaus ändern kannst und was nicht, und was als Nächstes geplant ist.

Pipedrive ist für Elido am 22. Mai 2026 live gegangen. Davor lag es zwei Wochen in der Beta, während wir Randfälle rund um Stage-IDs und Token-Rotation ausbügelten. Der Integrationscode liegt unter services/api-core/internal/integrations/pipedrive/, falls du selbst hostest und den Quellcode lesen möchtest. Wo im Folgenden etwas geplant statt bereits ausgeliefert ist, steht das ausdrücklich dabei.

Pipedrive in zwei Minuten verbinden

Öffne den Integrationskatalog in deinem Elido-Workspace und klicke auf die Pipedrive-Kachel. Das Connect-Modal fragt zuerst nach einer Sache: einem persönlichen API-Token. Du bekommst es in deinem Pipedrive-Konto, indem du das Profilmenü öffnest, dort Persönliche Einstellungen wählst und dann den Tab API. Pipedrives eigene Anleitung zum Auffinden des persönlichen API-Tokens zeigt den genauen Weg mit Screenshots, da sich ihre Oberfläche etwa vierteljährlich ändert.

Füge das Token ein. Elido erledigt im Hintergrund zwei Dinge. Es validiert das Token mit einem Aufruf von GET /users/me gegen die Pipedrive-API, was bestätigt, dass das Token gültig ist, und uns verrät, zu welchem Pipedrive-Unternehmen das Token gehört. Außerdem ruft es die Liste der aktiven Pipelines für dieses Unternehmen ab, sodass der nächste Schritt im Modal echte Optionen zeigt und keine Freitextfelder.

Danach stellt das Modal noch eine Frage: In welcher Pipeline sollen neue Deals landen? Das Dropdown wird mit deinen aktuellen Pipedrive-Daten befüllt. Hast du drei Pipelines namens Inbound, Outbound und Partners, siehst du genau diese drei. Wähle die, die zur Arbeit passt, in der Regel Inbound für marketinggetriebene Signale, und klicke auf Connect. Deals landen auf der ersten Stufe dieser Pipeline; eine andere Zielstufe auszuwählen ist geplant.

Flussdiagramm: Ein Short-Link erhält Klicks, ein Zähler pro Link verfolgt sie, ein 5-Minuten-Cronjob prüft die Gesamtzahlen pro Link gegen die Schwellenwerte 100, 1.000 und 10.000, und bei Erreichen ruft er die Pipedrive Deals API auf, um einen Deal zu erstellen

Was mit dem Token nach dem Connect passiert: Elido verschlüsselt es, bevor es Postgres erreicht, mit Envelope Encryption über einen Datenverschlüsselungsschlüssel pro Tenant, der wiederum von einem Workspace-KMS-Schlüssel umschlossen wird. Der verschlüsselte Blob ist das, was in der Tabelle integration_credentials liegt. Das Klartext-Token existiert nur für die Dauer eines einzelnen API-Aufrufs im Speicher, und wir loggen es nie, auch nicht auf Debug-Ebene. Rotierst du das Token in Pipedrive, erhält der nächste Cronjob-Lauf einen 401, und Elido markiert die Integration als erneut zu authentifizieren, was als Banner im Workspace sichtbar wird, kein stiller Fehler. Die Rotationshygiene liegt bei dir, der Ausfall ist laut.

Die Pipeline-Auswahl ist ein kleines, aber wichtiges Detail. Ein häufiger Fehler bei CRM-Integrationen besteht darin, Deals in der falschen Pipeline anzulegen, weil die Integration gebaut wurde, als das Unternehmen eine Pipeline hatte, und es inzwischen sechs sind. Dass der Nutzer die Auswahl beim Connect selbst trifft und die aktuelle Liste angezeigt wird statt eine, die einen Monat alt zwischengespeichert ist, beseitigt diese ganze Fehlerklasse. Du kannst dich außerdem jederzeit neu verbinden, um das Ziel der Auswahl zu ändern, ohne die Schwellenwert-Historie zu verlieren.

Was der 5-Minuten-Cronjob tatsächlich tut

Innerhalb von services/api-core gibt es einen Job namens click_threshold_hook. Er läuft alle fünf Minuten. Bei jedem Durchlauf erledigt er pro Workspace mit verbundenem Pipedrive der Reihe nach drei Dinge.

Erstens listet er die aktiven Links des Workspace auf und liest für jeden den laufenden Klickzähler aus, denselben Zähler, den der Redirect-Service bei jedem Klick hochzählt. Gelöschte und inaktive Links werden übersprungen.

Zweitens vergleicht er den neuen Gesamtwert jedes Links mit den erfassten Schwellenwerten. Die Standard-Schwellenwerte sind 100, 1.000 und 10.000. Für jeden Link speichert Elido jeden Schwellenwert, der bereits einen Deal erzeugt hat, in einer Zeile der Tabelle integration_pipedrive_deals, die nach Workspace, Link und Schwellenwert indiziert ist. Lag ein Link beim letzten Lauf bei 80 Klicks und steht jetzt bei 240, zeigt der Vergleich, dass der Schwellenwert 100 überschritten wurde und der Wert 1.000 noch nicht erreicht ist. Wir markieren 100 als erreicht und stellen die Erstellung eines Deals in die Warteschlange. Sprang ein Link von 80 auf 1.200, wurden sowohl 100 als auch 1.000 überschritten, also stellen wir zwei Erstellungen in die Warteschlange.

Drittens ruft Elido für jeden Deal in der Warteschlange Pipedrives Deals API mit einem POST auf /deals auf. Der Body setzt die Pipeline-ID aus der Connect-Auswahl, benennt den Deal Engagement: <slug> (<threshold> clicks) und lässt den Wert bei null. Das Schreiben von UTM-Quelle, -Medium und -Kampagne in eine Deal-Notiz mit einem Link zurück zur Elido-Analytics-Ansicht ist geplant, ebenso wie das Speichern der Link-ID in einem Pipedrive-Custom-Field.

Ein paar Dinge tut dieser Cronjob nicht. Er wiederholt sich nicht innerhalb eines Durchlaufs. Gibt Pipedrive einen Fehler zurück, wird für diesen Schwellenwert nichts vermerkt, sodass der nächste Durchlauf es einfach erneut versucht. Pipedrives Rate-Limit liegt in der Praxis bei 100 Anfragen pro 2 Sekunden pro Unternehmens-Token, was für die Volumina, die die meisten Teams erreichen, reichlich Spielraum lässt. Außerdem betrachtet er nur aktive Links, sodass gelöschte oder inaktive Links nie Deals erzeugen.

Die Duplikatvermeidung stützt sich auf diese Tabelle. Vor jeder Erstellung prüft der Cronjob auf eine bestehende Zeile (workspace_id, link_id, threshold_bucket), und das anschließende Insert ist durch einen Unique Constraint auf denselben drei Spalten abgesichert, sodass ein Absturz und ein erneuter Lauf keinen zweiten Deal für denselben Meilenstein erzeugen.

Über die drei Standardwerte hinaus erweitern

Die ausgelieferten Schwellenwerte sind 100, 1.000 und 10.000. Die meisten Teams behalten sie bei, weil sie sich natürlich in eine Vertriebserzählung einfügen. Hundert Klicks sind ein leises Signal, das einen Blick wert ist. Tausend sind eine Kampagne, die einen Anruf wert ist. Zehntausend sind heiß genug, dass ein Vertriebler bereits in Bewegung sein sollte. Trotzdem willst du vielleicht andere Zahlen, und die kannst du heute nicht einstellen.

Die Pipedrive-Integration von Elido verwendet für jeden Workspace dieselben drei Stufen, und es gibt noch keinen Endpunkt oder keine Einstellung für eine eigene Liste von Schwellenwerten.

Umfangreichere Trigger stehen auf der Roadmap, sind aber noch nicht ausgeliefert. Der Integrationsplan umfasst einen Schwellenwert-Trigger, der auf eine Kampagne mit einer Deal-Kandidaten-UTM eingegrenzt ist, sowie einen Conversion-Trigger, der einen Deal mit dem erfassten Bestellwert erstellt. Nutzerkonfigurierbare Zielstufen und Pipedrive-Custom-Fields wie Deal Source oder Lead Channel sind ebenfalls für die nächste Version geplant. Bis sie da sind, kannst du, falls du einen UTM-Filter oder ein Ordner-Rollup brauchst, die Elido-Analytics-API aus deinem eigenen Job abfragen und den Deal selbst über Pipedrives API erstellen.

UX-Mockup des Elido-Connect-Modals für Pipedrive mit einem Feld für das persönliche API-Token, einem Pipeline-Dropdown mit drei Pipelines und einem primären Connect-Button

Wo das Token liegt und wie man es rotiert

Ein kurzer Abschnitt, weil er in jedem Security-Review zur Sprache kommt. Das persönliche API-Token wird im Ruhezustand mit AES-256-GCM und einem Datenverschlüsselungsschlüssel pro Tenant verschlüsselt. Der DEK wiederum wird von einem Schlüssel auf Workspace-Ebene in unserem KMS umschlossen, und nur der api-core-Prozess kann ihn entschlüsseln. Es gibt kein Klartext-Token in irgendeinem Log, irgendeinem Backup oder irgendeiner Fehlerspur. Wir haben das mit einer Fault Injection getestet, die mitten in der Anfrage einen Pipedrive-401 erzwang, und der Fehlerpfad entfernt das Token aus der Antwort, bevor sie Sentry erreicht.

So rotierst du es: Erzeuge ein neues persönliches API-Token in Pipedrive, widerrufe das alte und füge das neue anschließend wieder in das Elido-Connect-Modal ein. Die Integration validiert das neue Token, tauscht es aus, und der nächste Cronjob-Lauf verwendet es. Vergisst du, Elido nach dem Widerruf des alten Tokens zu aktualisieren, erhält der nächste Cronjob-Lauf einen 401, und die Integration wechselt in den Zustand Needs Reauth, sichtbar als gelbes Banner im Workspace-Dashboard. Keine still toten Tokens.

Beim Self-Hosting ist das KMS austauschbar: standardmäßig dateibasiert, du kannst HashiCorp Vault oder dein Cloud-KMS einsetzen. ADR-0036 behandelt die Langfassung.

Wo das in einen größeren Funnel passt

Pipedrive-Deal-Trigger aus Klicks sind ein Baustein eines größeren Musters. Klickzahlen sind ein Frühindikator, keine Umsatzzahl, deshalb sollen sie meist in ein CRM fließen, in dem der restliche Vertriebskontext lebt. Der Deal ist die Übergabe: Marketing hat seinen Job gemacht, der Vertrieb übernimmt. Von dort an greifen deine gewohnten Pipedrive-Workflows: den Deal einem Vertriebler zuweisen, ihn bewerten, durch die Stufen bewegen, abschließen.

Wenn du Conversions zusätzlich an Ad-Plattformen weiterleitest, speisen dieselben Klickdaten beide Abläufe. Das Conversion-Tracking-Feature übernimmt die Ad-Seite, die Pipedrive-Integration die CRM-Seite, und die beiden konkurrieren nie um dasselbe Ereignis. Diese Kombination sehen wir am häufigsten auf der Marketer-Lösungsseite, wo der gesamte Stack aus bezahlter Akquise über gebrandete Links in einen CRM-Funnel besteht.

Für Analysten, die ihre Zahlen ehrlich halten wollen, decken zwei frühere Beiträge die vorgelagerten Themen ab. Short-Link-Analytics: was du messen solltest behandelt, welche Klick-Metriken tatsächlich mit Umsatz korrelieren, und UTM end to end tracken behandelt die UTM-Hygiene, die Deal-Notizen nützlich statt verrauscht macht. Beide passen gut zu dieser Integration, denn der Deal, den Pipedrive erstellt, ist nur so nützlich wie die UTM-Daten, die er trägt.

Ein letztes Detail zu den Plänen. Die Pipedrive-Integration ist in jeder bezahlten Elido-Stufe enthalten, und die 14-tägige Testphase schließt sie ein, damit du deine Schwellenwertliste ausprobieren kannst, bevor du dich anmeldest. Kostenlose Workspaces können die Verbindung zu Testzwecken herstellen, aber der Cronjob löst für kostenlose Links nicht aus. Die Preisseite enthält die Aufschlüsselung nach Stufe.

Einrichtungs-Checkliste

Drucke das aus, mach es einmal.

  1. In Pipedrive: Profilmenü, Persönliche Einstellungen, Tab API, Token kopieren.
  2. In Elido: Integrationen, Pipedrive-Kachel, Connect.
  3. Token einfügen. Auf die Validierung warten.
  4. Pipeline auswählen. Standardmäßig Inbound; Deals landen auf deren erster Stufe.
  5. Auf Connect klicken.
  6. Fünf Minuten warten. Ein paar Testklicks senden. Beobachten, wie der erste Deal landet.

Das war's. Wenn du selbst hostest, läuft der Cronjob innerhalb des api-core-Prozesses statt als eigenständiger Job, und er benötigt die Redis-Verbindung und den konfigurierten Secrets-Master-Key; fehlt eines von beiden, überspringt er den Lauf stillschweigend. Auf Elido Cloud wird der Cronjob für dich verwaltet.

Häufig gestellte Fragen

Wie funktioniert Pipedrive-Link-Klick-Tracking in Elido?

Elido führt für jeden Short-Link einen laufenden Klickzähler, und ein 5-Minuten-Cronjob prüft in jedem verbundenen Workspace, welche Links die Schwellenwerte 100, 1.000 oder 10.000 Klicks überschritten haben. Wird ein Schwellenwert erreicht, ruft Elido die Pipedrive Deals API auf und erstellt in der beim Connect ausgewählten Pipeline einen Deal auf deren erster Stufe. Der Deal-Titel nennt den Link-Slug und den Meilenstein, zum Beispiel Engagement: spring-sale (1000 clicks).

Brauche ich einen bezahlten Pipedrive-Plan für die Integration?

Jeder Pipedrive-Plan, mit dem du ein persönliches API-Token erzeugen kannst, funktioniert, was heute jede Pipedrive-Stufe ab Essential einschließt. Die Integration nutzt nur die öffentliche Deals API, du brauchst also für die Verbindung selbst kein Advanced oder höher. Manche nachgelagerten Aktionen wie benutzerdefinierte Felder existieren ebenfalls in niedrigeren Stufen, aber die Feldlimits je Stufe gelten weiterhin auf der Pipedrive-Seite.

Warum arbeitet die Pipedrive-Integration mit Token-Einfügen statt mit OAuth?

Pipedrive unterstützt OAuth für Marketplace-Apps, aber private Workspace-Integrationen setzen weiterhin auf ein persönliches API-Token, das schneller auszuliefern und leichter zu rotieren ist. Das Token wird in Elido mit Envelope Encryption verschlüsselt gespeichert, nie geloggt, und du kannst es mit zwei Klicks aus deinem Pipedrive-Profil widerrufen. Wir stellen die Integration auf OAuth um, sobald Pipedrive das für Nicht-Marketplace-Tenants öffnet.

Kann ich ändern, welche Schwellenwerte Deals erstellen?

Die Standardwerte sind 100, 1.000 und 10.000 Klicks, was dem entspricht, wie die meisten Vertriebsteams weiche, mittlere und heiße Signale einstufen. Heute sind sie für jeden Workspace fest, es gibt keine Einstellung und keine API für eine eigene Liste von Schwellenwerten. Ein Schwellenwert-Trigger, der auf die UTM einer Kampagne eingegrenzt ist, steht auf der Roadmap der Integration, ist aber noch nicht ausgeliefert.

Was passiert, wenn ein Klickzähler in fünf Minuten zwei Schwellenwerte überschreitet?

Der Cronjob löst pro Schwellenwert und pro Link einmal aus, also erzeugt ein schnell wachsender Link, der zwischen zwei Läufen von 80 auf 1.200 Klicks springt, zwei Deals hintereinander: einen für den Meilenstein 100, einen für den Meilenstein 1.000. Jeder Schwellenwert, der bereits einen Deal erzeugt hat, wird pro Link erfasst, sodass ein erneuter Versuch nie ein Duplikat erzeugt, und ein einzelner Link kann über seine gesamte Lebensdauer höchstens drei Deals erzeugen, einen pro Meilenstein.

Elido testen

URL einfügen, kurzer Link in Sekunden

Kein Konto nötig. Link bleibt 30 Tage aktiv. Konto erstellen, um ihn dauerhaft zu behalten.

Kostenlos, keine Anmeldung erforderlich · 2 pro Tag

Elido testen

URL-Shortener mit EU-Hosting: eigene Domains, tiefe Analytik und eine offene API. Kostenloser Tarif - keine Kreditkarte nötig.

Tags
pipedrive link click tracking
pipedrive automation
pipedrive deal triggers
pipedrive crm short links
pipedrive token api

Weiterlesen