Klantly Developers

Make und n8n

Verbinden Sie Klantly ohne Programmierung mit Hunderten anderer Apps, mit Make oder n8n.

Mit Make und n8n bauen Sie Verbindungen, indem Sie Bausteine zusammenklicken. Klantly funktioniert mit beiden, über zwei Bausteine: einen Webhook, um zu erfahren, dass etwas passiert ist, und eine HTTP-Anfrage, um etwas in Klantly zu tun.

Bevor Sie beginnen

Erstellen Sie in Klantly unter Integrationen → API einen eigenen Schlüssel für Make oder n8n, mit nur den Scopes, die Ihr Szenario braucht. So können Sie ihn später widerrufen, ohne dass andere Verbindungen stoppen.

Mit einem Event aus Klantly starten

Make

  1. Erstellen Sie ein neues Szenario und wählen Sie als erstes Modul Webhooks → Custom webhook.
  2. Legen Sie einen neuen Webhook an und kopieren Sie die Adresse, die Make anzeigt.
  3. Erstellen Sie in Klantly unter Integrationen → API, Tab Webhooks, einen Endpunkt mit dieser Adresse und wählen Sie die Events, die Sie brauchen.
  4. Make wartet jetzt auf eine erste Nachricht, um zu lernen, welche Daten sie enthält. Lösen Sie ein echtes Event aus, zum Beispiel indem Sie einen Testkunden anlegen. Die Testnachricht ping hat eine andere Form als die echten Events.

n8n

  1. Fügen Sie einen Webhook-Node hinzu und stellen Sie die HTTP-Methode auf POST.
  2. Verwenden Sie die Production URL als Adresse des Endpunkts in Klantly. Die Test URL funktioniert nur, solange Sie im Editor auf eine Testnachricht warten.
  3. Aktivieren Sie den Workflow.

Das Objekt steht in der Nachricht unter data.object; in n8n ist das body.data.object. Welche Felder es gibt, sehen Sie beim Objekt in der API-Referenz. Die Art des Events steht in type.

Warnung

Make und n8n prüfen die Signatur von Klantly nicht. Halten Sie die Webhook-Adresse daher geheim: Wer sie kennt, kann Nachrichten dorthin senden. Bei sensiblen Aktionen verarbeiten Sie die Nachrichten besser auf einem eigenen Server, der die Signatur prüft. Wie das geht, lesen Sie unter Webhooks.

Etwas in Klantly tun

Make

Verwenden Sie das Modul HTTP → Make a request:

Einstellung Wert
URL zum Beispiel https://app.klantly.com/api/v1/customers
Method POST
Headers Authorization mit dem Wert Bearer kly_…
Body type Raw, mit dem Content Type JSON (application/json)
Request content das JSON, zum Beispiel {"email": "jan@example.com", "name": "Jan de Vries"}
Parse response an

n8n

Verwenden Sie den Node HTTP Request:

  1. Wählen Sie bei Authentication den Eintrag Generic Credential Type und danach Header Auth. Legen Sie ein Credential mit dem Namen Authorization und dem Wert Bearer kly_… an. So steht der Schlüssel nicht im Workflow selbst.
  2. Wählen Sie Methode und URL, zum Beispiel POST und https://app.klantly.com/api/v1/customers.
  3. Schalten Sie Send Body ein, mit JSON als Content Type.

Beispiel: ein gewonnener Deal in Slack

  1. Starten Sie mit einem Webhook für das Event deal.won.
  2. Rufen Sie den Kunden mit einer HTTP-Anfrage ab: GET https://app.klantly.com/api/v1/customers/<customer_id>, mit customer_id aus dem Event.
  3. Senden Sie mit dem Slack-Modul eine Nachricht in Ihren Vertriebskanal, mit Titel und Wert des Deals und dem Namen des Kunden.

Tipps

  • Senden Sie beim Erstellen einen Idempotency-Key mit, zum Beispiel die id des Events, mit dem das Szenario begann. Führt Make oder n8n einen Schritt erneut aus, entsteht kein doppelter Datensatz.
  • Ein Szenario, das Tausende Datensätze auf einmal verarbeitet, kann an die Rate Limits stoßen. Lassen Sie es bei 429 warten und es erneut versuchen.
  • Ein Fehler von Klantly hat immer einen festen code. Unter Fehlercodes steht pro Code, was Sie dagegen tun können.

Zuletzt aktualisiert am 15. September 2026