Anbindungen über die API

Pipedrive API worauf diese Anbindung steht

Die technische Schicht einer Pipedrive-Anbindung: Anmeldung mit einem Token, der an einem Nutzerkonto hängt, eigene Felder mit einem Hash statt eines lesbaren Namens, Pipelines und Stufen als IDs, Ratenlimit im Zehn-Sekunden-Fenster, Webhooks gegenüber zyklischer Abfrage, ein separates Testkonto und die Behandlung von Fehlern. Für die Person, die wissen will, worauf das steht, bevor sie den Umfang freigibt.

Schema: ein KI-Agent, gleichzeitig verbunden mit den Systemen, die das Unternehmen bereits nutzt - Objekte in Pipedrive, Schnittstellen, Anmeldung, Automatisierungsschicht, Systeme auf der Gegenseite, Daten und Überwachung. Der Agent liest sie als Ganzes, statt Daten von Hand zu übertragen. KI-Agent Objekte inPipedrive Schnittstellen Anmeldung Automatisierungsschicht Systeme aufder Gegenseite Daten undÜberwachung
  • 10 SekundenFenster, in dem Pipedrive Anfragen zählt. Die Warteschlange bremst von selbst, bevor der Tarif ausgereizt ist, statt in den Fehler zu laufen
  • 429Code, den Pipedrive nach dem Überschreiten des Ratenlimits zurückgibt. Das Ereignis wandert zurück in die Warteschlange und wird mit wachsendem Abstand wiederholt
  • 14 Tagevom Workshop bis zur ersten Anbindung, die auf Ihrem Konto läuft, vorher auf einem separaten Testkonto durchgespielt

Das Problem

Warum bricht eine Pipedrive-Anbindung einen Monat nach dem Start?

Am Starttag läuft alles, weil wenig Daten und wenig Verkehr im Spiel sind. Vier Wochen später bricht der nächtliche Abgleich in der Mitte ab, weil Pipedrive einen Teil der Anfragen mit dem Code 429 abgewiesen hat und das Skript weitergelaufen ist, ohne festzuhalten, welche Deals durch sind. Noch einmal vier Wochen später kommt niemand mehr an den Token, weil er im Konto eines Vertriebsmitarbeiters lag, der das Unternehmen verlassen hat.

Die zweite Gruppe von Problemen sitzt in den Feldern. Ein eigenes Feld bekommt in Pipedrive keinen sprechenden Namen, sondern einen 40-stelligen Hash als Schlüssel. Die Beschriftung ändert der Vertrieb jederzeit, der Schlüssel bleibt. Ohne eine Karte, welcher Hash welches Feld ist, liest niemand mehr eine Antwort der Schnittstelle, und ein Feld, das als freier Text angelegt wurde, taugt für keine automatische Entscheidung. Welche Schlüssel Ihr Konto führt, listet die Entwicklerdokumentation von Pipedrive über den Endpunkt für Feldbeschreibungen.

Die dritte Gruppe sind Pipeline und Stufen. Ein Deal liegt immer in genau einer Stufe, und die Stufe ist im Szenario eine Zahl. Baut der Vertrieb die Pipeline um oder legt eine zweite an, zeigt eine fest verdrahtete Zahl plötzlich auf die falsche Spalte. Der Deal wandert weiter, nur eben dorthin, wo ihn niemand sucht, und auffallen wird das erst im Monatsbericht.

  • Der Abgleich endet nach einem Teil der Datensätze und niemand weiß, welche durch sind
  • Der Token hängt am Konto einer Person, mit ihren Rechten und ihrer Sichtbarkeit
  • Der Webhook nimmt jede Anfrage an, weil den Absender niemand prüft
  • Das Feld für die Branche entstand als freier Text, also kann keine Automatik danach entscheiden
  • Die Stufen-ID steht als Zahl im Szenario und zeigt nach dem Umbau der Pipeline ins Leere

Warum jetzt

Warum schreibt man so eine Anbindung heute nicht mehr von null?

Pipedrive ist ein vertriebsorientiertes CRM, und die Schnittstelle sieht genauso aus: Deals, Personen, Organisationen, Aktivitäten, Notizen, Produkte, Pipelines, Stufen und Nutzer, dazu Webhooks. Für die interne Automatisierung reicht ein API-Token aus den Einstellungen. OAuth 2.0 bleibt dort, wo es wirklich gebraucht wird, nämlich in einer App, die andere Unternehmen bei sich installieren, und im Marketplace von Pipedrive.

Die zweite Veränderung liegt in der Zwischenschicht. Make, n8n und Zapier bringen fertige Bausteine für Pipedrive mit Token-Anmeldung mit. Eigener Code bleibt für die Stellen, an denen er wirklich nötig ist: ungewöhnliche Umformung von Daten, ein System ohne Schnittstelle und große Abrufe, die man selbst drosseln muss. Was daraus für den Ablauf folgt, steht auf der Seite zur Prozessautomatisierung.

Die dritte Veränderung ist die Gegenseite. lexoffice, sevDesk, Xentral, Shopware und die Zahlungsanbieter Stripe und Mollie haben eigene Schnittstellen, deshalb ist die Kette vom gewonnenen Deal bis zur Rechnung kurz geworden. Wie das auf der Rechnungsseite aussieht, steht auf der Seite zur lexoffice API. Pipedrive führt zwei API-Versionen parallel, und welche Version welchen Endpunkt abdeckt, prüfen wir vor dem Start in der Dokumentation statt aus dem Gedächtnis.

Was sich ändert

Was bekommt die Person, die das später betreut?

  • Ein Token, der den Weggang seines Erstellers übersteht

    Pipedrive bindet den API-Token an ein Nutzerkonto, also erbt die Anbindung dessen Rechte und dessen Sichtbarkeit. Wir legen dafür einen eigenen Integrationsnutzer an, legen den Token in die Geheimnisverwaltung und schreiben auf, wie er gewechselt wird.

    Eigener Integrationsnutzer statt Token aus dem Konto des Vertriebsleiters

  • Das Ratenlimit stoppt den Abgleich nicht mehr

    Der Verkehr läuft über eine Warteschlange, die das Restkontingent aus den Antwort-Headern liest und bremst, bevor Pipedrive mit 429 antwortet. Nach einer Abweisung wird mit wachsendem Abstand wiederholt, nicht in der Schleife.

    Ereignis zurückgestellt und wiederholt, statt eines Datensatzes, der spurlos im Log verschwindet

  • Ereignisse in Sekunden statt im Abfragetakt

    Gewonnener Deal, neue Person, geänderte Stufe kommen als Webhook direkt nach dem Ereignis. Den Absender prüfen wir am Eingang über die Basisauthentifizierung der Ziel-URL, den Empfang bestätigen wir sofort, die Arbeit macht die Warteschlange dahinter.

    Idempotente Verarbeitung, ein doppelt geliefertes Ereignis legt keinen zweiten Deal an

  • Feldschlüssel einmal dokumentiert

    Zu jedem eigenen Feld halten wir Hash, Beschriftung, Typ und Werteliste fest. Ein Feld, nach dem eine Automatik entscheiden soll, entsteht als Auswahlliste und nicht als Textzeile zum Eintippen.

    Karte Hash zu Bedeutung, damit die Antwort der Schnittstelle lesbar bleibt

  • Pipeline und Stufen als Vereinbarung, nicht als Zahl im Skript

    Stufen lösen wir zur Laufzeit über ihren Namen auf, statt IDs im Szenario einzubetonieren. Kommt eine Stufe dazu oder wird die Pipeline umgebaut, findet die Anbindung sie weiterhin.

    Umbau der Pipeline ohne Änderung am Szenario

  • Fehler sichtbar, bevor der Vertrieb ihn meldet

    Jeder fehlgeschlagene Aufruf landet in einem Alarm mit Antwortcode, Endpunkt, Feldschlüssel und der ID des betroffenen Deals. Was nicht durchging, wartet in einer eigenen Warteschlange auf die Wiederholung.

    Alarm mit Deal-ID, die sich direkt in Pipedrive öffnen lässt

Beleg

Arbeiten Sie selbst so über Schnittstellen?

Ja. Der KI-Agent in der Agentur unserer Gründer spricht seit März 2026 mit dem CRM und allen weiteren Systemen ausschließlich über Schnittstellen. Unten die Größe dieses Verkehrs, samt dem, was diese Zahl NICHT belegt.

Bei uns selbst umgesetzt. Das sind keine Kundenprojekte, sondern Umsetzungen in den eigenen Unternehmen der Gründer. Wir sagen das offen, denn ein Beleg, den man nicht prüfen kann, ist keiner.

  • JustBotJustBotihr Agent

    JustIdea Agency, Performance-Marketing-Agentur mit rund 30 Personen

    23
    Personen aus der Firma arbeiten mit dem Agenten
    38
    dauerhaft angebundene Systeme
    112
    Prozesse laufen ohne Menschen
    475
    Tausend Zeilen Agenten-Code

    Ein Agent, verbunden mit dem CRM, den Formularen der Website, Slack und dem Data Warehouse. Anmeldung über Token, Schreiben über die Schnittstelle, Formularereignisse innerhalb von Sekunden nach dem Absenden.

    8 von 38 Systemen, in denen er arbeitet

    • Google Ads
    • Meta Ads
    • HubSpot
    • ActiveCollab
    • Ahrefs
    • GA4
    • Search Console
    • BigQuery
    Vorher
    Datensätze entstanden von Hand, also gab es nichts zu protokollieren. Niemand wusste, wie viele Operationen am Tag durchlaufen, wie viele scheitern und woran.
    Nachher
    Jede Operation läuft über die Schnittstelle und hinterlässt einen Eintrag im Log, mit Art des Aufrufs und Ergebnis. Erst das erlaubte es, Limits, Fehler und den Anteil der Arbeit ohne Menschen zu zählen.

    64.903 Werkzeugaufrufe in 30 Tagen, davon 29.854 ohne Menschen, darunter 3.432 Operationen auf Leads und 1.301 auf Formularanfragen

Und bei Ihnen

Was, wenn Sie schon eine eigene Anbindung haben?

Vier Sätze hören wir von technischen Ansprechpartnern am häufigsten, hier steht, was wir darauf antworten.

Personenbezogene Daten aus dem CRM verarbeiten wir nach der Verordnung 2016/679. In die Orchestrierung gehen nur die Felder, die für die Entscheidung gebraucht werden, und Löschungen laufen über den dafür vorgesehenen Endpunkt statt über ein stilles Überschreiben.

  • Wir haben ein Skript, das die Daten liefert und läuft.

    Gut, und meistens bleibt es. Wir prüfen vier Dinge daran: ob es das Ratenlimit beachtet und nach 429 wiederholt, ob es beim Webhook den Absender prüft, ob der Token in der Geheimnisverwaltung liegt und einen dokumentierten Wechsel hat, und ob nach einem Abbruch feststeht, welche Datensätze durch sind. Wir reparieren nur, was diese Liste nicht besteht, statt alles neu zu schreiben.

  • Zugriff auf das komplette CRM bekommen Sie nicht.

    Muss auch nicht sein. Da Pipedrive den Token an ein Nutzerkonto bindet, legen wir einen eigenen Integrationsnutzer an und geben ihm nur die Sichtbarkeit und die Rechte, die der Ablauf braucht. Wir starten mit reinem Lesen und schalten das Schreiben erst nach dem Piloten frei, auf einer schmalen Liste von Operationen. Das Szenario kann auf Ihrer Infrastruktur laufen, dann verlassen die Daten Ihre Server nicht.

  • Unsere IT schreibt das selbst.

    Oft stimmt das, und wir sagen es auch so. Dann endet der Workshop mit einer Spezifikation, die Ihr Team ohne uns umsetzt: Liste der Objekte und Felder mit ihren Schlüsseln, Rechte des Integrationsnutzers, Plan für Limits und Fehler, Testfälle. Wir können auf die Durchsicht des Codes und die Einrichtung der Überwachung beschränkt bleiben.

  • Wir haben den kleinen Tarif, die Schnittstelle bringt uns nichts.

    Lesen und Schreiben über die Schnittstelle funktioniert in jedem Tarif, daran ändert sich nichts. Der Tarif entscheidet darüber, was innerhalb von Pipedrive möglich ist, etwa die Angebotsfunktion in den höheren Stufen, und über die Höhe des Ratenlimits. Die Logik selbst wohnt ohnehin in n8n oder Make, also außerhalb des Tarifs.

Objekte in Pipedrive
Deals, Personen, Organisationen, Aktivitäten, Notizen, Produkte, Dateien, Pipelines, Stufen, Nutzer
Schnittstellen
REST-API, Suchendpunkte, Filter, Feldbeschreibungen, Webhooks
Anmeldung
API-Token je Nutzerkonto, eigener Integrationsnutzer, OAuth 2.0 für Apps im Marketplace
Automatisierungsschicht
Make, n8n, Zapier, eigener Code in Node.js oder Python
Systeme auf der Gegenseite
lexoffice, sevDesk, DATEV, Xentral, Shopware, JTL, Stripe, Mollie, HubSpot, Microsoft 365, Google Workspace
Daten und Überwachung
BigQuery, Google Sheets, SQL-Datenbanken, Alarme in Slack und Microsoft Teams

Operationen auf der Pipedrive-API und woran zu denken ist

Sieben Punkte, die in dieser Anbindung immer entschieden werden müssen. Die dritte Spalte ist die wichtigste, denn dort stehen die Gründe, aus denen eine Anbindung nach dem ersten Monat aufhört zu funktionieren.

Art der OperationWie wir das umsetzenWoran zu denken ist
AnmeldungAPI-Token aus den Einstellungen, übergeben im Header oder als Query-Parameter; OAuth 2.0, wenn andere Firmen die App bei sich installierender Token hängt an einem Nutzerkonto und erbt dessen Rechte; wird das Konto deaktiviert, steht die Anbindung still, deshalb ein eigener Integrationsnutzer
Einzelnen Datensatz lesenAbruf von Deal, Person oder Organisation über die ID, mit ausdrücklicher Liste der Feldereigene Felder kommen als 40-stelliger Hash zurück und nicht unter ihrer Beschriftung; ohne Feldkarte ist die Antwort nicht lesbar
SuchenSuchendpunkte für Personen, Organisationen und Deals, mit Begrenzung auf bestimmte Felderdie Suche greift nicht auf jedes Feld zu; das Feld für den Abgleich, meist E-Mail oder Umsatzsteuer-Identifikationsnummer, legen wir vorher fest
Blätternseitenweiser Abruf über Offset oder Cursor, je nach Endpunkt und API-Versionbei langen Abrufen speichern wir die Position, damit ein Abbruch nicht bei null neu beginnt
Schreiben in MengenEinzelanfragen in einer gedrosselten Warteschlange, mit Abgleich über ein eindeutiges Feldfür Deals und Personen gibt es keinen Sammel-Endpunkt wie in anderen CRM-Systemen; ein Import von 5.000 Datensätzen ist damit vor allem eine Frage der Drosselung
EreignisseWebhooks auf gewonnenen Deal, neue Person und Stufenwechsel, mit Ziel-URL und Basisauthentifizierungdie Reihenfolge ist nicht garantiert und dasselbe Ereignis kann zweimal ankommen, deshalb ist die Verarbeitung idempotent
Limits und FehlerWarteschlange mit Wiederholung: nach 429 warten, nach 5xx wachsender Abstand, nach 4xx keine Wiederholung400 ist meist ein falscher Feldschlüssel oder ein Wert außerhalb der Auswahlliste, 403 ein fehlendes Recht des Integrationsnutzers

Die Zahlen zum Ratenlimit, in der Größenordnung von 100 Anfragen je 10 Sekunden im Einstiegstarif und bis zu 400 in den höheren Tarifen, nennen wir nach der Dokumentation von Pipedrive und prüfen sie vor dem Start auf Ihrem Konto, weil sie vom Tarif abhängen und sich über die Zeit ändern. Die aktuellen Werte stehen unter <a href="https://developers.pipedrive.com/docs/api/v1" rel="noopener">developers.pipedrive.com</a>.

Wie wir arbeiten

Fünf Schritte bis zu einer Anbindung, die sich betreuen lässt

Jeder Schritt endet mit etwas, das Sie beurteilen können, bevor Sie über den nächsten entscheiden.

  1. Workshop und Prüfung des Kontos über die Schnittstelle

    Wir lesen Felder, Pipelines, Stufen, Aktivitätstypen und den Tarif aus und zählen Fakten: welche Felder wirklich gefüllt werden, welche als freier Text entstanden sind, wie viele Dubletten es gibt und welche Deals seit Wochen ohne Aktivität liegen. Wir sehen auch nach, welche Token und Apps bereits existieren, denn es sind fast immer mehr, als jemand im Kopf hat.

  2. Datenvereinbarung und Rechte

    Wir schreiben Objekte, Felder mit Schlüssel und Typ, das Feld für den Abgleich und die Rechte des Integrationsnutzers auf. Hier entscheiden wir auch, was über Webhook und was über zyklische Abfrage kommt und wo die Logik wohnt: in den Automatisierungen von Pipedrive oder in der Orchestrierung außerhalb.

  3. Pilot auf einem separaten Testkonto

    Die Anbindung läuft zuerst auf einem eigenen Testkonto mit nachgebauter Pipeline. Wir schicken hässliche Fälle hindurch: eine Person ohne E-Mail, eine Dublette, einen Deal in einer Stufe, die es nicht mehr gibt, und ein absichtlich ausgelöstes Ratenlimit, um zu sehen, wie sich die Wiederholung verhält.

  4. Produktivbetrieb mit Überwachung

    Wir schalten auf das Produktivkonto um, mit Alarmen auf Fehlercodes und einer eigenen Warteschlange für Ereignisse, die nicht durchgingen. Es bleibt ein Handbuch: was nach 429 zu tun ist, was nach 5xx, wie ein Ereignis wiederholt wird und woher die Deal-ID für die Meldung kommt.

  5. Messung nach 30 und 90 Tagen

    Nach 30 Tagen sehen wir uns die Zahl der Ereignisse an, die nicht durchgingen, und wie viele davon nach der Wiederholung von selbst zurückkamen. Nach 90 Tagen zählt nur, ob überhaupt jemand die Anbindung von Hand anfassen musste. Wenn ja, reparieren wir die Stelle, statt eine Anleitung dazuzuschreiben.

Vorher und nachher

Wie sich der Tag der Person ändert, die die Anbindung betreut

Vorher

  • Der Token liegt im Konto eines Vertriebsmitarbeiters, mit dessen Rechten
  • Der nächtliche Abgleich hält in der Mitte an und niemand weiß, welche Deals durch sind
  • Ein Stufenwechsel erreicht das zweite System bei der nächsten Abfrage, nach 15 Minuten
  • Nach einer Antwort mit 400 rät jemand, welcher Feldschlüssel falsch ist

Nachher

  • Eigener Integrationsnutzer, Token in der Geheimnisverwaltung, Wechsel dokumentiert
  • Die Warteschlange kennt für jeden Datensatz das Ergebnis, Fehlgeschlagenes kommt zurück
  • Der Webhook liefert das Ereignis in Sekunden, der Absender wird am Eingang geprüft
  • Der Alarm trägt Antwortcode, Endpunkt, Feldschlüssel und die Deal-ID

Pilot auf dem Testkonto in der ersten Woche, erste Anbindung im Produktivbetrieb 14 Tage nach dem Workshop. Die Zahl der Ereignisse, die nicht durchgingen, beurteilen wir nach 30 Tagen, den Bedarf an Handarbeit nach 90 Tagen.

Für die Person, die das beauftragt

Was die Person davon hat, die für die Systeme verantwortlich ist

Das Risiko in so einem Vorhaben liegt nicht im Bau der Anbindung, sondern in dem, was nach dem Bau übrig bleibt. Datenvereinbarung, Rechteliste und Handbuch sorgen dafür, dass die Anbindung nicht das Wissen einer einzelnen Person ist. Geht diese Person in Urlaub oder aus dem Unternehmen, beginnt die nächste bei einem Dokument und nicht beim Lesen von Code.

Der zweite Punkt nimmt Ihnen das Risiko der Entscheidung vor der Umsetzung ab. Statt den Umfang zu schätzen, bekommen Sie nach einer Woche Workshop eine Spezifikation mit Feldern, Rechten und Randfällen. Wenn Sie danach entscheiden, es selbst zu bauen, bleibt das Dokument bei Ihnen und behält seinen Wert.

  • Datenvereinbarung schriftlich: Objekte, Felder, Schlüssel, Typen, Feld für den Abgleich
  • Eigener Integrationsnutzer, also hält der Weggang einer Person die Anbindung nicht an
  • Pilot auf einem Testkonto, also ist das Produktivkonto kein Übungsplatz
  • Handbuch: was nach 429, was nach 5xx und was bei einem Ereignis zu tun ist, das nicht durchging

Was das kostet

Der Workshop hat einen offenen Preis, die Anbindung ein Angebot danach

Der Workshop kostet 3.500 EUR netto pro Woche, üblich sind eine bis sieben Wochen, bei einer einzelnen Anbindung reicht meistens eine. Der Umfang ist schmal: welche Operationen, auf welchen Objekten, mit welchen Rechten und was passiert, wenn sie scheitern. Die Anbindung kalkulieren wir erst nach dem Workshop, wenn feststeht, wie viele Operationen im Spiel sind und in welchem Zustand die Felder sind.

Die Lizenz für Pipedrive zahlen Sie direkt an Pipedrive, ebenso die Betriebskosten der Szenarien in Make oder n8n, oder Sie zahlen sie gar nicht, wenn das Szenario auf Ihrer Infrastruktur läuft. Ohne Aufschlag von uns. Kommt ein KI-Agent dazu, liegen die Kosten des Modells beim Anbieter, in der Größenordnung von 0,005 bis 0,07 EUR pro Anfrage, abhängig vom Modell und von der Länge der Frage.

  • Workshop

    3.500 EUR netto

    pro Woche, bei einer Anbindung meist eine Woche

    Abgeschlossene Einheit. Endet mit einer technischen Spezifikation, die Ihr Team ohne uns umsetzen kann.

    • Prüfung des Kontos über die Schnittstelle: Felder, Pipelines, Stufen, Tarif, bestehende Token
    • Datenvereinbarung: Objekte, Feldschlüssel, Typen, Feld für den Abgleich der Datensätze
    • Plan für Limits, Fehler und Ereignisse: Webhook oder Abfrage, was wiederholt wird
    • Rechte des Integrationsnutzers und Testfälle für den Piloten
    Mit dem Workshop beginnen
  • Am häufigsten gewählt

    Workshop und Anbindung

    Angebot nach dem Workshop

    der Umfang folgt aus der Zahl der Operationen und dem Zustand der Felder

    Die meistgewählte Variante. Eine laufende Anbindung, zuerst auf dem Testkonto geprüft, danach im Produktivbetrieb.

    • Alles aus dem Workshop
    • Anbindung in n8n, Make oder eigenem Code, mit Token-Anmeldung
    • Warteschlange mit Wiederholung, Drosselung und Webhooks mit Prüfung des Absenders
    • Pilot auf dem Testkonto und Umschaltung mit Überwachung der Fehler
    • Handbuch und Einweisung der Person, die das ohne uns weiterführt
    Über die Umsetzung sprechen
  • Anbindung und KI-Agent

    Angebot nach dem Workshop

    für Teams, die mehrmals täglich nach Zahlen aus dem CRM fragen

    Alles aus der Anbindung, dazu BOND, der Firmen-KI-Agent, der über dieselbe Schnittstelle aus Pipedrive liest.

    • Alles aus der Anbindung
    • KI-Agent mit Pipedrive verbunden: Pipeline, Deals ohne Aktivität, Prognose, Quellen
    • Rechte des Agenten getrennt für Lesen und Schreiben, Schreiben erst nach dem Piloten
    • Antwort aus aktuellen Daten in 5 bis 10 Sekunden, jede Operation im Log
    Nach dem Agenten fragen

Der Workshop endet mit einem Dokument, das ohne uns Bestand hat: Datenvereinbarung, Rechteliste und Plan für Limits und Fehler. Zeigt die Prüfung des Kontos, dass ein fertiger Baustein in Make oder eine Automatisierung, die Sie bereits haben, ausreicht, sagen wir das. Dann endet die Sache beim Workshop und nicht bei einer Anbindung, die Sie nicht brauchen.

Häufige Fragen

Wie meldet man sich an der Pipedrive-API an?

Pipedrive nutzt eine Anmeldung über Token. Den Token finden Sie in den Einstellungen Ihres Kontos im Bereich für persönliche Einstellungen und die Schnittstelle. Sie übergeben ihn als Query-Parameter oder im Kopf der Anfrage. Wichtig ist die Folge daraus: der Token hängt an einem Nutzerkonto und erbt dessen Rechte und Sichtbarkeit. Deshalb legen wir für jede Anbindung einen eigenen Integrationsnutzer an, statt den Token einer echten Person zu verwenden.

Wie viele Anfragen erlaubt die Pipedrive-API?

Das Limit wird in einem kurzen Zeitfenster von zehn Sekunden gezählt und hängt vom Tarif ab, in der Größenordnung von 100 Anfragen je Fenster im Einstiegstarif und bis zu 400 in den höheren Stufen. Die genauen Werte stehen in der Dokumentation von Pipedrive, und wir prüfen sie vor dem Start auf Ihrem Konto, weil sie sich ändern. Die praktische Regel hängt nicht an der Zahl: die Anbindung liest das Restkontingent aus den Antwort-Headern, bremst selbst und hat eine Warteschlange.

Warum haben eigene Felder in Pipedrive keinen lesbaren Namen?

Weil Pipedrive jedem eigenen Feld einen 40-stelligen Hash als Schlüssel gibt und die Beschriftung nur für Menschen führt. Das hat einen Vorteil: die Beschriftung lässt sich jederzeit ändern, ohne dass eine Anbindung bricht. Und einen Preis: ohne eine Karte, welcher Hash welches Feld ist, versteht niemand die Antwort der Schnittstelle. Diese Karte legen wir im Workshop an und halten sie zusammen mit Typ und Werteliste fest.

Webhook oder zyklische Abfrage?

Webhook überall dort, wo Pipedrive ein passendes Ereignis kennt, denn er liefert die Änderung in Sekunden und erzeugt keine leeren Anfragen. Die zyklische Abfrage nach dem Änderungsdatum bleibt als Ergänzung: für Ereignisse ohne Webhook und als Netz für den Fall, dass der Empfänger kurz nicht erreichbar war. Bei Webhooks gehen wir davon aus, dass ein Ereignis zweimal und in falscher Reihenfolge ankommen kann, deshalb ist die Verarbeitung idempotent.

Was tun Sie, wenn Pipedrive mit 429 antwortet?

Das Ereignis wandert zurück in die Warteschlange und wird mit wachsendem Abstand wiederholt, mit einer kleinen zufälligen Streuung, damit nicht mehrere Prozesse in derselben Sekunde zurückkommen. Der Code 429 ist kein Fehler der Anbindung, sondern ein normaler Zustand bei mehr Verkehr, deshalb alarmieren wir nicht beim ersten, sondern bei einer Serie, die nicht aufhört. Große Importe drosseln wir von vornherein.

Gibt es für Pipedrive eine Sandbox?

Eine garantierte Sandbox wie in manchen anderen CRM-Systemen gehört nicht zum Standard, deshalb arbeiten wir mit einem separaten Testkonto. Dort bauen wir Pipeline, Stufen und die eigenen Felder nach und spielen hässliche Fälle durch: Person ohne E-Mail, Dublette, Deal in einer Stufe, die es nicht mehr gibt. Die Token der Umgebungen liegen getrennt, damit ein Test nie durch einen Konfigurationsfehler auf dem Produktivkonto landet.

Lassen sich Produkte und Angebote über die Schnittstelle steuern?

Ja. Pipedrive führt einen Produktkatalog, und Produkte lassen sich einem Deal mit Menge und Preis zuordnen, alles über die Schnittstelle. Die Angebotsfunktion gehört zu den höheren Tarifen, also prüfen wir im Workshop, ob Ihr Tarif sie enthält. Für die Rechnung selbst nutzen wir ohnehin die Gegenseite, also lexoffice, sevDesk oder Xentral, und schreiben die Rechnungsnummer als Notiz zurück an den Deal.

Wie bindet man Pipedrive an lexoffice oder sevDesk an?

Über das Ereignis für den gewonnenen Deal. Der Webhook löst ein Szenario aus, das die Daten der Organisation und den Wert des Deals liest, den Kontakt in lexoffice oder sevDesk sucht oder anlegt und die Rechnung erzeugt. Danach schreibt das Szenario die Rechnungsnummer als Notiz an den Deal zurück, damit der Vertrieb sie ohne Wechsel des Systems sieht. Der heikle Punkt ist die Zuordnung: welches Feld gilt als eindeutig, meist die Umsatzsteuer-Identifikationsnummer.

Sehen wir uns an, worauf Ihre Pipedrive-Anbindung steht

Das kostenlose Erstgespräch dauert 30 Minuten. Sie sagen, was heute Daten an Pipedrive schickt und von dort holt, womit es sich anmeldet und was passiert, wenn eine Anfrage scheitert. Wir sagen, welche drei Dinge zuerst zu ändern sind und was ein fertiger Baustein erledigt und was eigenen Code braucht. Zugang zum Konto brauchen wir dafür nicht.

Wir führen höchstens zwei Umsetzungen gleichzeitig, damit bei jeder wirklich jemand sitzt.

Kostenloses Erstgespräch

PS. Wenn bei Ihnen in diesem Monat jemand einen Abgleich von Hand neu gestartet oder gesucht hat, warum Pipedrive mit 400 geantwortet hat, dann ist genau das der Punkt. Eine Anbindung mit Datenvereinbarung, Warteschlange und einem Alarm samt Deal-ID braucht keine menschliche Wachsamkeit mehr. Wir beginnen mit dem Workshop, denn ohne festgelegte Feldschlüssel und Rechte liefert man schneller nur Unordnung.

Beschreiben Sie Ihre Herausforderung

Sie schreiben direkt an Paweł. Kein Spam.