Kontakte, fünf Operationen
Anlegen, abrufen, auflisten, aktualisieren und archivieren. Die Liste filtert nach Suchbegriff, Plattform, E-Mail, externer ID und Updated Since, dem Filter, auf dem eine inkrementelle Synchronisierung läuft.
n8n-Node
Business-PlanInstallieren Sie n8n-nodes-pinlyx über das Panel Community Nodes, fügen Sie einen API-Schlüssel ein, und schon wird aus einem abgeschickten Formular ein Kontakt, aus einem gewonnenen Deal eine Rechnung und aus einer unbeantworteten Unterhaltung eine Nachricht in dem Kanal, den Ihr Team im Blick hat. Acht Operationen auf drei Ressourcen, keine Laufzeitabhängigkeiten, MIT-Lizenz.
Dauerhaft kostenloser Plan · Keine Kreditkarte nötig · Jederzeit kündbar
Zuletzt aktualisiert:
Definition
Ein n8n-Community-Node ist ein auf npm veröffentlichtes Paket, das eine n8n-Instanz zur Laufzeit installiert und das der Arbeitsfläche einen neuen Baustein hinzufügt. Es ist kein Fork von n8n und auch kein Webhook-Empfänger, den Sie selbst hosten und am Laufen halten müssen.
n8n-nodes-pinlyx ist der Node von Pinlyx. Er authentifiziert sich mit einem API-Schlüssel, den Sie im Panel erzeugen, und gibt einem Workflow acht Operationen für Kontakte, Deals und Unterhaltungen. Die Cursor-Paginierung übernimmt er für Sie.
Auf npm veröffentlicht als n8n-nodes-pinlyx, Quellcode auf GitHub unter MIT-Lizenz. Getestet mit n8n ab Version 1.60 auf Node.js ab 20.15. npm · GitHub
Der Node spricht mit derselben öffentlichen REST-API wie ein Skript. Alles, was er tut, lässt sich also mit curl nachstellen, und alles, was er nicht kann, ist nur einen HTTP Request Node entfernt.
Drei Ressourcen, ausgewählt, weil eine Automatisierung genau nach ihnen greift. Alles hier setzt die API durch, nicht der Node.
Anlegen, abrufen, auflisten, aktualisieren und archivieren. Die Liste filtert nach Suchbegriff, Plattform, E-Mail, externer ID und Updated Since, dem Filter, auf dem eine inkrementelle Synchronisierung läuft.
Einen Deal mit Titel, Wert, Währung, Phase, Wahrscheinlichkeit, erwartetem Abschlussdatum und Notizen anlegen. Auflisten mit Filtern für Phase, Kontakt und eine Titelsuche.
Die Threads, in denen zuletzt etwas passiert ist, über alle verbundenen Kanäle hinweg, die neuesten zuerst. Jede Zeile enthält die Kontakt-ID, den Kanal, ein Ungelesen-Flag und eine kurze Vorschau der letzten Nachricht.
Schreiben Sie Ihre eigene Kennung auf einen Kontakt, und ein erneuter Lauf wird mit HTTP 409 abgewiesen, der den bereits vorhandenen Datensatz nennt. So entsteht nicht stillschweigend eine zweite Kopie derselben Person.
Schalten Sie Return All ein, und der Node geht alle Seiten für Sie durch. Lassen Sie es aus und setzen Sie ein Limit. Eine Seite fasst höchstens 100 Zeilen bei Kontakten und Deals und 50 bei Unterhaltungen, eine große Liste bedeutet also immer viele Anfragen, egal wie Sie sie stellen.
Die Zugangsdaten enthalten einen API-Schlüssel. Jede Operation gibt an, welchen Scope sie braucht. Ein Schlüssel ohne contacts:write scheitert beim Anlegen also mit einem 403, statt scheinbar zu funktionieren und nichts zu ändern.
Der Node ist auf npm als n8n-nodes-pinlyx veröffentlicht und wird wie jeder Community-Node installiert: aus n8n heraus, nicht durch das Kopieren von Dateien auf einen Server.
Oder auf einer selbst gehosteten Instanz über die Kommandozeile:
npm install n8n-nodes-pinlyx
# then restart n8nEine Einschränkung sollten Sie kennen, bevor Sie damit planen: n8n Cloud bietet nur Community-Nodes an, die n8n selbst geprüft und verifiziert hat, und dieses Paket hat diese Prüfung noch nicht durchlaufen. Selbst gehostete Instanzen installieren jedes veröffentlichte Paket. In der Cloud erreichen Sie dieselben Operationen über den HTTP Request Node und die REST-API. Das ist die ehrliche Antwort, kein Detail, das wir lieber verschweigen würden.
Das Paket deklariert keine Laufzeitabhängigkeiten. Jede Anfrage läuft über den HTTP-Helper von n8n selbst. Nur so können die Zugangsdaten den Authorization-Header einfügen, und genau das hält die Installation klein.
Der Node authentifiziert sich mit einem Pinlyx-API-Schlüssel: ein Schlüssel, ein Header, kein OAuth-Umweg.
Der Verbindungstest macht den günstigsten authentifizierten Aufruf, den es gibt:
curl https://api.pinlyx.com/v1/me \
-H "Authorization: Bearer csk_live_YOUR_KEY"API-Schlüssel gehören zum Business-Plan. Mit Free und Pro gibt es keinen Schlüssel zu erzeugen, die Zugangsdaten hätten also nichts, was sie speichern könnten. Das ist die eine Voraussetzung, die Sie prüfen sollten, bevor Sie irgendetwas installieren.
Standardmäßig stehen 60 Anfragen pro Minute und Schlüssel zur Verfügung. Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, und wer die Grenze überschreitet, bekommt HTTP 429 mit einem Retry-After in Sekunden. Weil das Limit pro Schlüssel gilt und nicht pro Workspace, bremst sich ein Workflow in einer Endlosschleife selbst aus, statt Ihren übrigen Integrationen die Luft abzuschnüren.
Das ist der gesamte Funktionsumfang, keine Auswahl der Höhepunkte.
Jede Operation entspricht genau einem Endpunkt der öffentlichen v1-API. Nichts hier verhält sich also anders als eine Anfrage, die Sie von Hand schreiben würden.
Das Plattformfeld eines Kontakts akzeptiert Telegram, WhatsApp, Instagram, LinkedIn, X und Email. Es hält fest, über welchen Kanal eine Person gekommen ist, und danach gruppiert das CRM später ihre Unterhaltungen.
Was nicht auf dieser Liste steht, ist nicht im Node. Nachrichten senden, Tags vergeben, Lead-Scoring, Aufgaben, Rechnungen und Sequenzen gibt es alle in der REST-API. Sie gehören nur nicht zu diesen acht Operationen.
Der häufigste Grund, zu diesem Node zu greifen. Ein Lead füllt ein Formular aus, und der Datensatz steht im CRM, bevor irgendjemand einen Tab öffnet.
Wenn Sie echtes Upsert-Verhalten statt eines 409 brauchen: Die REST-API hat einen Batch-Endpunkt, der über externe ID, E-Mail, Telefon oder Benutzername abgleicht und bis zu 200 Zeilen pro Anfrage annimmt. Der Node bietet ihn nicht an. Richten Sie einen HTTP Request Node auf POST /v1/contacts/batch, und Sie erhalten dasselbe Verhalten mit einem Aufruf statt zweihundert.
Lesen Sie das, bevor Sie es bauen, denn der naheliegende Aufbau ist der falsche.
Ein Deal lässt sich über die API überhaupt nicht auf Gewonnen setzen. Ein gewonnener Deal bucht einen Einnahmeposten im Journal des CRM, deshalb ist dieser Übergang bewusst dem Panel vorbehalten, wo ein Mensch draufschaut. Der Node bildet das ab: Deal, Create lehnt die Phasen Won und Lost ab, und eine Update-Operation gibt es nicht. Gewonnene Deals lesen Sie, Sie schreiben sie nicht.
Wenn fünfzehn Minuten zu langsam sind, verkürzen Sie nicht das Abfrageintervall, sondern abonnieren Sie das Ereignis: Pinlyx sendet bei deal.won einen ausgehenden Webhook, signiert mit HMAC-SHA256 im Header X-Webhook-Signature und mit dem Ereignisnamen in X-Webhook-Event. Richten Sie ihn auf einen n8n Webhook Node, und die Rechnung geht Sekunden nach dem Abschluss raus, ohne dass Sie Abfragebudget verbrauchen. Dasselbe gilt für contact.created, contact.updated und message.received.
Conversation, Get Many liefert die Threads, in denen zuletzt etwas passiert ist, über alle verbundenen Kanäle: Telegram, WhatsApp, Instagram, X, E-Mail und Live-Chat auf der Website in einer Liste. Jede Zeile enthält die Kontakt-ID, den Kanal, ob sie ungelesen ist, und bis zu 160 Zeichen der letzten Nachricht.
Zwei Grenzen sollten Sie kennen, bevor Sie das bauen. Die Vorschau ist eine Vorschau: Der Node kann nicht durch einen ganzen Nachrichtenverlauf blättern, ein Klassifikator sieht also immer nur die letzte Nachricht. Und der Node kann einen Kontakt weder taggen noch eine Antwort senden. Beides gibt es in der REST-API und auf dem MCP-Server, aber nicht unter diesen acht Operationen.
Drei Verhaltensweisen, die entscheiden, ob ein Workflow seine erste echte Woche übersteht.
Eine Listenantwort der API, auf der der Node aufsetzt:
{
"items": [ { "Id": 812, "Name": "Sarah Lin", "Platform": "email" } ],
"nextCursor": 764,
"hasMore": true
}Inkrementelle Synchronisierungen laufen über Updated Since. Speichern Sie den Zeitstempel des letzten erfolgreichen Laufs, übergeben Sie ihn beim nächsten, und Sie holen nur die Handvoll Kontakte, die sich geändert haben, statt aller. Das ist der Unterschied zwischen einem nächtlichen Abgleich, der fertig wird, und einem, der sein ganzes Budget für Zeilen verbraucht, die niemand angefasst hat.
Ehrliche Grenzen
Sechs Dinge, die Sie besser hier lesen, als sie mitten im Aufbau eines Workflows zu entdecken.
Die REST-API kann eine Telegram-Nachricht oder eine X-DM in die Warteschlange stellen, der MCP-Server ebenfalls. Diese Operationen sind nicht in diesem Node. Muss ein Workflow einen Kunden erreichen, nehmen Sie einen HTTP Request Node oder einen der Kanal-Nodes von n8n.
Ein gewonnener Deal bucht einen Einnahmeposten im Journal, deshalb gibt es diesen Übergang nur im Panel. Der Node legt Deals an und listet sie auf. Er schließt sie nicht ab, und Create lehnt die Phasen Won und Lost von vornherein ab.
Das ist ein Aktions-Node. Um einen Workflow durch ein Ereignis im CRM zu starten, registrieren Sie einen ausgehenden Webhook und empfangen ihn mit dem Webhook Node von n8n. Abfragen per Schedule Trigger funktioniert auch, kostet Sie aber Rate-Limit-Budget, das der Webhook nicht braucht.
Tags, Lead-Scores, Zuweisung an Verantwortliche, Aufgaben und Pipeline-Verschiebungen gibt es alle in der REST-API. Keines davon gehört zu den acht Operationen. Contact, Update schreibt die einfachen Felder und sonst nichts.
Keine Rechnungen, keine Buchungen, keine Zahlungen, keine Erstattungen. Nichts in diesem Node bewegt Geld in irgendeine Richtung, und genau dieselbe Grenze zieht auch der MCP-Server.
API-Schlüssel sind eine Funktion des Business-Plans. Mit Free und Pro gibt es keinen Schlüssel, den Sie in die Zugangsdaten einfügen könnten, und der Node hat nichts, womit er sich authentifizieren kann, egal wie korrekt er installiert ist.
Drei Wege, dasselbe CRM anzubinden, jeder richtig für eine andere Aufgabe. Die meisten Teams nutzen am Ende zwei davon.
Feste Abläufe nach Zeitplan oder Auslöser
Sie wissen genau, was wann passieren soll. Ein Formular kommt an, ein Kontakt wird angelegt. Ein Deal wird abgeschlossen, eine Rechnung geht raus. Die Logik liegt auf einer Arbeitsfläche, die Ihr ganzes Team lesen kann, und eine fehlgeschlagene Ausführung steht samt verursachendem Payload in der Liste der Ausführungen.
Ideal, wenn die Regel feststeht und das Volumen gleichmäßig ist.
Reagieren, sobald etwas passiert
Registrieren Sie im CRM einen Endpunkt, und es sendet Ihnen contact.created, contact.updated, message.received, deal.won und weitere Ereignisse. Signiert mit HMAC-SHA256, mit Backoff wiederholt und aus einem Zustellprotokoll erneut abspielbar. Kombiniert mit einem n8n Webhook Node bekommen Sie Push statt Polling.
Ideal, wenn Latenz wichtiger ist als Einfachheit.
Urteilsvermögen statt Verkabelung
Ein KI-Assistent entscheidet im Moment des Aufrufs, mit dem tatsächlichen Verlauf vor sich, statt einer Regel zu folgen, die vor Wochen geschrieben wurde. Tools, Ressourcen und Prompts über einen authentifizierten Endpunkt, wobei jeder Aufruf durch die Scopes des Schlüssels begrenzt ist.
Ideal, wenn die Antwort davon abhängt, die Lage zu verstehen.
Die Fragen aus der ersten Stunde, beantwortet mit dem tatsächlichen Verhalten.
Die anderen Zugänge zu denselben Daten und die Bereiche des CRM, in die ein Workflow schreiben wird.
Die Schnittstelle unter dem Node: Schlüssel mit Scopes, Cursor-Paginierung, idempotente Schreibzugriffe, Rate-Limit-Header und ausgehende Webhooks.
Dasselbe CRM für einen KI-Assistenten statt für einen Workflow: Tools, Ressourcen und Prompts über einen authentifizierten Endpunkt.
Ein Durchgang für Entwickler: Schlüssel erzeugen, erste authentifizierte Anfrage, Prüfung der Webhook-Signatur und Backoff bei Rate-Limits.
Wann ein Assistent im Moment des Aufrufs entscheiden sollte, wann Sie Code schreiben und wann ein No-Code-Trigger die richtige Antwort ist.
Gmail, Outlook, Calendly, Zoom, GitHub und die ausgehenden Webhooks, die das CRM mit allem anderen verketten.
Was ein Kontaktdatensatz tatsächlich enthält: Tags, benutzerdefinierte Felder, Lead-Score, Verantwortliche und eine vollständige Aktivitätschronik.
Die Pipeline, in die die Deal-Operationen schreiben, und warum der Übergang zu Gewonnen Umsatz bucht und im Panel bleibt.
Der Planvergleich, einschließlich des Business-Plans mit API-Schlüsseln und Webhooks und des MCP-Servers, der in jedem Plan enthalten ist.
Startklar
Installieren Sie den Node, erzeugen Sie einen Schlüssel mit zwei Scopes und lassen Sie die erste Formularübermittlung als Kontakt ankommen. Alles Weitere ist nur noch ein Node mehr, den Sie auf die Arbeitsfläche ziehen.