n8n-Integration mit Personyze

n8n ist ein Tool zur Workflow-Automatisierung, das Sie in der n8n Cloud nutzen oder selbst hosten können. Wenn Sie es mit Personyze verbinden, können Sie Workflows für Ihr Konto bauen — Kontakte, Segmente, Käufe und erfasste Leads synchronisieren —, mit der Option, alles in Ihrer eigenen Infrastruktur zu behalten.

Personyze bietet keine eigene n8n-App — Sie verbinden sich über das generische HTTP-Request-Modul von n8n und einen Personyze-API-Schlüssel. Das klingt nach mehr Arbeit, als es ist: Jeder Personyze-Endpunkt ist ein einfacher HTTPS-Aufruf mit Basic-Authentifizierung, sodass Ihnen eine einmal eingerichtete Verbindung die gesamte API zugänglich macht.

Im Panel: Einstellungen › Integrationen › n8n.

Der n8n-Integrationsbereich mit aktiven API-Schlüsseln und der Schaltfläche zum Erzeugen eines Schlüssels — Der n8n-Bereich. Er verwaltet die API-Schlüssel — die Verbindung selbst wird auf der Seite von n8n eingerichtet. Zum Vergrößern klicken.

Einen Schlüssel erhalten

Öffnen Sie Einstellungen › Integrationen und klicken Sie auf der n8n-Karte auf Konfigurieren.
Klicken Sie auf Neuen Schlüssel erzeugen und halten Sie den Wert bereit.
Bewahren Sie ihn sicher auf — wer einen Schlüssel besitzt, kann im Namen Ihres Kontos handeln. Wenn Sie einen Schlüssel hier widerrufen, stoppt sofort alles, was ihn noch verwendet.

Das sind dieselben Schlüssel wie bei der Vollwertigen API und bei Zapier. Ein auf einer dieser Karten erzeugter Schlüssel erscheint auf allen und authentifiziert jeden Endpunkt. Trotzdem lohnt es sich, pro Automatisierung einen eigenen Schlüssel zu erzeugen, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.

In n8n verbinden

Fügen Sie einen Knoten HTTP Request hinzu und legen Sie Zugangsdaten vom Typ Basic Auth an:

Authentifizierung: Basic Auth
Benutzername: api
Passwort: der von Ihnen erzeugte Schlüssel
Basis-URL: https://app.personyze.com/rest/

Manche Tools bevorzugen Zugangsdaten, die in die URL eingebettet sind; auch das funktioniert:

https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/email=john@example.com

Speichern Sie sie in n8n als wiederverwendbare Zugangsdaten, damit jeder HTTP-Request-Knoten im Workflow sie auswählen kann, statt den Schlüssel in jedem Knoten einzeln einzutragen.

Hinweis zum Selbst-Hosting. Personyze muss Ihre n8n-Instanz für diese Aufrufe nicht erreichen — Ihr Workflow ruft Personyze auf, sodass ein selbst gehostetes n8n hinter einer Firewall ohne eingehenden Zugriff funktioniert. Das ändert sich erst, wenn Sie später einen Personyze-Webhook hinzufügen, der auf n8n zeigt; dafür ist eine erreichbare URL nötig.

Was Sie aufrufen können

Alles in der REST-API. Die üblichen Automatisierungsmuster:

Einen Kontakt an Personyze übertragen — POST /rest/users mit dem Feld email. Erneutes Senden derselben E-Mail führt zusammen, statt zu duplizieren; ein wiederholt laufender Workflow bleibt also sicher.
Jemanden zu einem Segment hinzufügen — POST /rest/user_list_users mit user_list_id und user_email.
Einen Kauf melden — POST /rest/products_interactions.
Erfasste Leads abrufen — GET /rest/forms, mit Paginierung über time.
Kampagnenergebnisse abrufen — GET /rest/summary_actions.

Vollständige Referenz: Überblick über die REST-API, Pfadparameter und Fehler, Limits und Wiederholungen. Der Integrationsleitfaden behandelt die Verhaltensweisen, die Sie kennen sollten, bevor Sie eine Synchronisierungsschleife bauen.

Zwei Dinge, die Sie sonst erwischen

Verknüpfen Sie Ihre Nutzer über email. Das ist der Identifikator, der einem bestehenden Profil zugeordnet wird. Ein Workflow, der Ihre eigene internal_id als Schlüssel verwendet, legt bei jedem Lauf einen neuen Nutzer an.
Fehlerantworten sind reiner Text, kein JSON. Ein Modul, das jede Antwort als JSON parst, wirft beim Fehler eine Ausnahme und verbirgt die eigentliche Meldung. Prüfen Sie den Statuscode: 400 bedeutet, dass die Anfrage fehlerhaft ist und eine Wiederholung nicht hilft; 503 lohnt eine Wiederholung mit Backoff.