Make-Integration mit Personyze

Make (ehemals Integromat) ist eine No-Code-Automatisierungsplattform. Wenn Sie sie mit Personyze verbinden, können Sie Ihr Konto mit über 2.000 anderen Apps verknüpfen — einen neuen CRM-Kontakt an Personyze übertragen, einen Käufer zu einem Segment hinzufügen oder erfasste Leads in eine Tabelle schreiben, ohne Code zu schreiben.

Personyze bietet keine eigene Make-App — Sie verbinden sich über das generische HTTP-Request-Modul von Make 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 › Make.

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

Einen Schlüssel erhalten

Öffnen Sie Einstellungen › Integrationen und klicken Sie auf der Make-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 Make verbinden

Fügen Sie Ihrem Szenario ein Modul HTTP › Make a request hinzu und konfigurieren Sie es so:

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 die Zugangsdaten einmal, und Make bietet diese Verbindung jedem HTTP-Modul im Szenario an.

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.