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

Das Pipedrive Link-Klick-Tracking in Elido verwandelt Short-Link-Meilensteine in Pipeline-Ereignisse. Wenn einer deiner Links 100, 1.000 oder 10.000 Klicks überschreitet, erstellt ein 5-Minuten-Cron einen Deal in der von dir gewählten Pipedrive-Pipeline und dem ausgewählten Stage - mit Link-Slug, UTM-Quelle und einem Direktlink zurück zu Elido in den Deal-Notizen. Kein Zapier dazwischen, kein manueller Export, keine Kalender-Erinnerung zum Überprüfen von Link-Reports.

Das ist die Überschrift. Die Mechanik dahinter ist wichtiger, deshalb behandelt dieser Beitrag die drei Dinge, die Sales-Ops-Teams verstehen müssen, bevor sie das aktivieren. Erstens: Wie der Connect-Flow tatsächlich funktioniert - wo der persönliche API-Token gespeichert wird, was der Pipeline-Picker ausliest und wie das Token nach dem Einfügen gespeichert wird. Zweitens: Was der Schwellenwert-Cron bei jedem Lauf macht und wie er verhindert, doppelte Deals zu erstellen, wenn ein Link über Nacht viral geht. Drittens: Wie man die Integration über die drei Standard-Schwellenwerte hinaus erweitert - zu benutzerdefinierten Klickzahlen, UTM-basierten Triggern und eigenen Pipedrive-Feldern - mit dem Elido SDK und einem kleinen Webhook-Handler.

Pipedrive wurde am 22. Mai 2026 für Elido live geschaltet. Davor befand es sich zwei Wochen in der Beta, während wir Edge Cases rund um Stage-IDs und Token-Rotation ausgeräumt haben. Der Integrationscode liegt unter services/api-core/internal/integrations/pipedrive/, falls du selbst hostest und den Quellcode lesen möchtest. Alles in diesem Beitrag entspricht dem aktuellen Stand - keine Roadmap.

Pipedrive in zwei Minuten verbinden

Öffne den Integrationskatalog in deinem Elido-Workspace und klicke auf die Pipedrive-Karte. Das Connect-Modal fragt zunächst nach einem persönlichen API-Token. Diesen erhältst du in deinem Pipedrive-Konto über das Profilmenü, dann Persönliche Einstellungen und anschließend den Reiter API. Pipedrives eigene Anleitung zu how to find the Personal API token zeigt den genauen Weg mit Screenshots, da sich die Benutzeroberfläche etwa jedes Quartal ändert.

Token einfügen. Elido führt im Hintergrund zwei Dinge aus. Es validiert das Token durch einen Aufruf von GET /users/me gegen die Pipedrive API - das bestätigt, dass das Token aktiv ist, und teilt uns mit, zu welchem Pipedrive-Unternehmen es gehört. Außerdem ruft es die Liste der Pipelines und Stages für dieses Unternehmen ab, sodass der nächste Schritt im Modal echte Optionen anzeigt und keine Freitextfelder.

Das Modal stellt dann zwei weitere Fragen. In welche Pipeline sollen neue Deals kommen? In welchem Stage dieser Pipeline? Die Dropdowns werden aus deinen Live-Pipedrive-Daten befüllt. Wenn du drei Pipelines namens Inbound, Outbound und Partners hast, siehst du genau diese drei. Wähle die passende aus - für marketinggesteuerte Signale in der Regel Inbound - und wähle dann den ersten qualifizierenden Stage. Klicke auf Verbinden.

Was nach dem Verbinden mit dem Token passiert: Elido verschlüsselt es, bevor es Postgres berührt - mithilfe von Envelope Encryption mit einem mandantenspezifischen Datenverschlüsselungsschlüssel, der von einem Workspace-KMS-Schlüssel umhüllt 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 Arbeitsspeicher und wird niemals protokolliert, auch nicht auf Debug-Level. Wenn du das Token in Pipedrive rotierst, erhält der nächste Cron-Lauf einen 401-Fehler und Elido markiert die Integration als "Erneute Authentifizierung erforderlich" - sichtbar als Banner im Workspace, kein stilles Versagen. Token-Hygiene liegt bei dir, der Ausfall ist laut.

Der Pipeline-Picker ist ein kleines, aber wichtiges Detail. Eine häufige Fehlerquelle bei CRM-Integrationen ist das Erstellen von Deals in der falschen Pipeline, weil die Integration zu einer Zeit gebaut wurde, als das Unternehmen eine Pipeline hatte und jetzt sechs besitzt. Dem Benutzer die Wahl beim Verbinden zu lassen - und die aktuelle Liste statt einer einen Monat alten Zwischenablage anzuzeigen - eliminiert diese ganze Fehlerklasse. Du kannst jederzeit neu verbinden, um das Pipeline-Ziel zu ändern, ohne die Schwellenwert-Historie zu verlieren.

Was der 5-Minuten-Cron tatsächlich macht

In services/api-core gibt es einen Job namens click_threshold_hook. Er läuft alle fünf Minuten. Bei jedem Tick führt er drei Dinge der Reihe nach aus - pro Workspace, der Pipedrive verbunden hat.

Erstens: Er fragt ClickHouse nach den per-Link-Klickzahlen, die in den letzten sechs Minuten aktualisiert wurden - plus einem Puffer von einer Minute für späte Ereignisse. ClickHouse speichert die Klick-Ereignisse in einer clicks-Tabelle, partitioniert nach Datum. Das abgefragte Rollup ist eine materialisierte View, die nach Short-Link-ID aufgeschlüsselt ist. Die Abfrage gibt Links zurück, deren Summen sich seit dem letzten Cron-Lauf geändert haben - nicht die gesamte Tabelle. Bei einem Workspace mit 50.000 aktiven Links und normalem Klickmuster bleibt diese Abfrage unter 200 ms.

Zweitens: Es vergleicht die neue Summe jedes Links mit den aufgezeichneten Schwellenwerten. Die Standardschwellen sind 100, 1.000 und 10.000. Für jeden Link verfolgt Elido den höchsten je erreichten Schwellenwert in einer kleinen link_threshold_state-Zeile, geordnet nach Link-ID. Wenn ein Link beim letzten Lauf bei 80 Klicks war und nun bei 240 steht, zeigt der Vergleich, dass der 100er-Schwellenwert überschritten wurde und der 1.000er noch nicht erreicht ist. Wir markieren 100 als erreicht und stellen eine Deal-Erstellung in die Warteschlange. Wenn ein Link von 80 auf 1.200 gesprungen ist, wurden sowohl 100 als auch 1.000 überschritten - wir stellen zwei Erstellungen in die Warteschlange.

Drittens: Für jeden Deal in der Warteschlange ruft Elido Pipedrives Deals API mit einem POST an /deals auf. Der Body setzt die Pipeline-ID und Stage-ID aus dem Connect-Picker, benennt den Deal lesbar wie Link <Slug> hat <Schwellenwert> Klicks erreicht und schreibt UTM-Quelle, -Medium und -Kampagne in die Deal-Notiz, zusammen mit einem klickbaren Link zur Elido-Analytics-Ansicht für diesen Link. Wir speichern die Link-ID auch in einem benutzerdefinierten Pipedrive-Feld, wenn der Workspace eines konfiguriert hat - das macht es möglich, Pipedrive später nach allen Deals zu einem bestimmten Elido-Link abzufragen.

Ein paar Dinge, die dieser Cron nicht tut: Er versucht nicht endlos Pipedrive-5xx-Fehler zu wiederholen. Gibt Pipedrive 500 oder 503 zurück, versucht er es innerhalb desselben Cron-Ticks zweimal mit exponentiellem Backoff und überlässt die Arbeit dann dem nächsten Tick. Pipedrives Rate-Limit liegt in der Praxis bei 100 Anfragen pro 2 Sekunden pro Unternehmens-Token - genug Spielraum für die Volumes, die die meisten Teams erreichen werden. Wir erstellen auch keine Deals für Links, die als Test, intern oder im Besitz eines Workspace-Mitglieds markiert sind, das über seine persönlichen Einstellungen dem CRM-Sync widersprochen hat.

Die Duplikat-Verhinderung war der Teil, der die meiste Iteration erforderte. Die erste Version hatte eine Race Condition: Wenn zwei Cron-Pods gleichzeitig liefen, konnten beide denselben Link bei 100 sehen und beide einen Deal posten. Wir haben das mit einem Postgres-Advisory-Lock auf der Workspace-ID zu Beginn jedes Cron-Ticks gelöst, plus einem Unique Constraint auf (link_id, threshold) in link_threshold_state. Versucht der zweite Pod, eine doppelte Zeile einzufügen, lehnt Postgres das ab, und der POST in der Warteschlange wird gelöscht, bevor er Pipedrive erreicht. Doppelte Absicherung.

Über die drei Standardwerte hinausgehen

Die mitgelieferten Schwellenwerte sind 100, 1.000 und 10.000. Die meisten Teams behalten diese, weil sie natürlich zu einer Vertriebs-Erzählung passen. Hundert Klicks sind ein schwaches Signal, das einen Blick wert ist. Tausend sind eine Kampagne, die einen Anruf rechtfertigt. Zehntausend sind heiß genug, dass ein Mitarbeiter bereits tätig werden sollte. Das gesagt: du möchtest vielleicht andere Zahlen, und das SDK unterstützt das.

Die Elido Pipedrive-Integration akzeptiert eine benutzerdefinierte Schwellenwertliste auf Workspace-Ebene. Du setzt sie über den Endpunkt PATCH /v1/workspaces/:id/integrations/pipedrive mit einem JSON-Body wie {"thresholds": [50, 500, 5000, 50000]}. Der Cron übernimmt die neue Liste beim nächsten Tick. Die State-Tabelle bewahrt die Historie, sodass das Ändern von Schwellenwerten keine Deals rückwirkend erzeugt - es verändert nur, welche zukünftigen Überschreitungen ausgelöst werden.

Für umfangreichere Trigger stellt das SDK einen CreateDeal-Hook bereit, den du aus jedem Service registrieren kannst. Der klassische Fall: Einen Deal nur erstellen, wenn ein Link einen Schwellenwert überschreitet UND die UTM-Quelle deine bezahlte Social-Kampagne ist, nicht dein organischer Blog. Das ist ein einzeiliger Filter im Hook. Ein weiterer häufiger Fall: Nur bei Links in einem bestimmten Elido-Ordner auslösen, weil dieser Ordner dein Kampagnen-Ordner ist und alles andere Rauschen ist. Derselbe Hook kann auch benutzerdefinierte Pipedrive-Felder wie Deal-Quelle, Lead-Kanal oder welche Taxonomie auch immer dein Sales-Ops-Team verwendet, setzen. Der Leitfaden zur Konversionsweiterleitung behandelt dasselbe Hook-Muster für Ad-Plattformen - der Pipedrive-Fall ist strukturell identisch.

Ein Hinweis zu benutzerdefinierten Feldern: Das SDK akzeptiert entweder das menschlesbare Label oder den von Pipedrive intern verwendeten Hash-API-Key. Wenn du ein Label referenzierst, das beim verbundenen Unternehmen nicht existiert, wird der Deal trotzdem erstellt, und das fehlende Feld wird als Warnung protokolliert - nie als Fehler. Ein fehlendes benutzerdefiniertes Feld sollte kein echtes Vertriebssignal blockieren.

Teams mit vielen Links pro Kampagne möchten manchmal Schwellenwerte über einen Ordner hinweg aggregieren. Setze aggregation: "folder" in der Workspace-Integrationskonfiguration, und der Cron gruppiert Klick-Summen nach Ordner und prüft dann die Summe. Der Deal benennt den Ordner und listet die drei meistbeitragenden Links in den Notizen auf.

Wo das Token liegt und wie man es rotiert

Ein kurzer Abschnitt, weil er bei jeder Sicherheitsprüfung aufkommt. Das persönliche API-Token wird im Ruhezustand mit AES-256-GCM mit einem mandantenspezifischen Datenverschlüsselungsschlüssel verschlüsselt. Der DEK wird seinerseits von einem Workspace-Level-Schlüssel in unserem KMS umhüllt, und nur der api-core-Prozess kann ihn entpacken. Es gibt kein Klartext-Token in irgendeinem Protokoll, keiner Sicherung oder einem Fehler-Trace. Wir haben das mit einer Fehlerinjektion getestet, die einen Pipedrive-401 mitten in einer Anfrage erzwang, und der Fehlerpfad bereinigt das Token aus der Antwort, bevor es Sentry erreicht.

Rotation: Erstelle ein neues persönliches API-Token in Pipedrive, widerrufe das alte, dann füge das neue in das Elido Connect-Modal ein. Die Integration validiert das neue Token, tauscht es aus, und der nächste Cron-Tick verwendet es. Wenn du vergisst, Elido nach dem Widerrufen des alten Tokens zu aktualisieren, erhält der nächste Cron-Tick einen 401 und die Integration wechselt in den Zustand "Erneute Authentifizierung erforderlich" - sichtbar als gelbes Banner im Workspace-Dashboard. Keine stillen toten Tokens.

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

Einordnung in einen größeren Funnel

Pipedrive-Deal-Trigger aus Klicks sind ein Teil eines größeren Musters. Klickzahlen sind ein vorlaufender Indikator, keine Umsatzzahl - deshalb möchtest du sie in der Regel in ein CRM fließen lassen, wo der übrige Vertriebskontext liegt. Der Deal ist die Übergabe: Marketing hat seine Arbeit getan, der Vertrieb übernimmt. Von dort greifen deine normalen Pipedrive-Workflows: Deal einem Mitarbeiter zuweisen, bewerten, durch Stages bewegen, abschließen.

Wenn du auch Konversionen an Ad-Plattformen weiterleitest, speist dieselben Klickdaten beide Flows. Das Conversion-Tracking-Feature kümmert sich um die Ad-Seite, die Pipedrive-Integration um die CRM-Seite - und die beiden kämpfen nie um dasselbe Ereignis. Diese Kombination sehen wir am häufigsten auf der Marketer-Lösungsseite, wo der gesamte Stack aus bezahlter Akquise über Branded Links in einen CRM-Funnel besteht.

Für Analysten, die ihre Zahlen sauber halten möchten, behandeln zwei frühere Beiträge die vorgelagerten Aspekte. Short link analytics: what to measure erklärt, welche Klick-Metriken tatsächlich mit Umsatz korrelieren, und Track UTM end to end behandelt die UTM-Hygiene, die Deal-Notizen nützlich statt unverständlich macht. Beide ergänzen diese Integration gut, da der von Pipedrive erstellte Deal nur so nützlich ist wie die UTM-Daten, die er trägt.

Ein letztes Detail zu Plänen: Die Pipedrive-Integration ist in jedem kostenpflichtigen Elido-Tier enthalten, und die 14-tägige Testphase schließt sie ein, damit du deine Schwellenwertliste prüfen kannst, bevor du dich anmeldest. Kostenlose Workspaces können die Verbindung zu Testzwecken erstellen, aber der Cron läuft nicht für kostenlose Links. Auf der Preisseite findest du die Aufschlüsselung nach Tier.

Einrichtungs-Checkliste

Drucke das aus, erledige es einmal.

1. In Pipedrive: Profilmenü, Persönliche Einstellungen, Reiter API, Token kopieren.
2. In Elido: Integrationen, Pipedrive-Karte, Verbinden.
3. Token einfügen. Auf Validierung warten.
4. Pipeline und Stage auswählen. Standard: Inbound und der erste qualifizierende Stage.
5. Auf Verbinden klicken.
6. Optional: Schwellenwertliste bearbeiten, wenn 100/1k/10k nicht zu deiner Vertriebs-Bewegung passt.
7. Optional: Benutzerdefinierten CreateDeal-Hook für UTM-Filter oder Ordner-Aggregationen registrieren.
8. Fünf Minuten warten. Test-Klicks senden. Den ersten Deal beobachten.

Das ist alles. Beim Self-Hosting möchtest du außerdem sicherstellen, dass der Cron aktiv ist, indem du prüfst, ob kubectl get cronjob api-core-click-threshold-hook einen gesunden Zeitplan zurückgibt. Bei Elido Cloud wird der Cron für dich verwaltet.