Customermates-Workflows in n8n erstellen
Visuelle Abläufe mit generischen CRM-Datensatzereignissen und der Datensatz-API erstellen.
Verbinden Sie n8n über einen Webhook-Node für CRM-Änderungen und HTTP-Request-Nodes für die Customermates-REST-API; für JSON-RPC-Clients gibt es den MCP-Endpunkt. Der Customermates Community Node (@customermates/n8n-nodes-crm) unterstützt die konfigurierbare Datensatz-API ab Version 2.0.0; aktualisieren Sie ältere Installationen, bevor Sie seine CRM-Aktionen nutzen.
Wann passt n8n?
n8n passt, wenn Ihr Team visuelle Abläufe statt Code bevorzugt, wenn Datensatzereignisse vor der Weitergabe an andere Dienste umgewandelt werden sollen oder wenn Sie n8n bereits für andere Automationen verwenden. Für CRM-Arbeit im Gespräch können Sie MCP ergänzend oder stattdessen verwenden.
Wie löse ich n8n durch CRM-Änderungen aus?
Webhook-Node in n8n anlegen
Kopieren Sie die erzeugte URL.
In Customermates abonnieren
Öffnen Sie Webhooks, klicken Sie auf Hinzufügen und fügen Sie die URL ein. Wählen Sie unter Ereignisse Datensatz erstellt, Datensatz aktualisiert oder Datensatz in den Papierkorb verschoben, dann die zu beobachtende Liste und optional Filter. Tragen Sie ein Secret ein und klicken Sie auf Speichern. Zum Anlegen brauchen Sie Erstellen bei API & Webhooks.
Payload verarbeiten
Prüfen Sie die Signatur und verwenden Sie in weiteren Schritten die Ereignis-ID und die stabile
typeId/recordId-Referenz aus dem Payload des Datensatzereignisses.
Mit dem Customermates Community Node legt dessen Customermates Trigger dieses Webhook-Abonnement beim Aktivieren (Veröffentlichen) des Workflows selbst an.
Webhooks beschreibt Payloads, Wiederholungen und Signaturprüfung. Zustellungen können mehrfach oder in anderer Reihenfolge eintreffen; deduplizieren Sie anhand der Ereignis-ID.
Ab wann empfängt ein Trigger Ereignisse?
Seit n8n 2.x kehrt die Aktivierung zurück, bevor n8n den Trigger fertig eingerichtet hat. Das Abonnement besteht meist innerhalb einer Sekunde; Änderungen davor werden auch später nicht zugestellt. Wenn ein Ablauf einen Workflow aktiviert und sofort Datensätze anlegt, sollte er zuerst warten, bis n8ns GET /rest/workflows/{id}/publication-status published meldet oder das Abonnement unter Webhooks erscheint. Selbst gehostetes n8n stellt mit N8N_USE_WORKFLOW_PUBLICATION_SERVICE=false das wartende Aktivieren wieder her.
Wie kann ich aus n8n Datensätze anlegen, lesen, ändern oder löschen?
Verwenden Sie einen HTTP Request-Node mit einer x-api-key-Credential und JSON gemäß der OpenAPI-Spezifikation. Die Datensatz-Routen funktionieren für Startlisten und selbst angelegte Listen:
| Ziel | Methode und Pfad |
|---|---|
| Listen nach Namen finden | POST /api/v1/model/discover |
| Felder, Beziehungen und stabile IDs lesen | POST /api/v1/model/read |
| Datensätze abfragen oder suchen | POST /api/v1/records/query oder POST /api/v1/records/search |
| Einen Datensatz lesen | POST /api/v1/records/read |
| Anlegen, ändern, löschen oder verknüpfen | POST /api/v1/records/mutate |
| Löschung vorab prüfen | POST /api/v1/records/preview-deletion |
| Export (JSON oder XLSX) oder Import | POST /api/v1/records/export oder POST /api/v1/records/import |
| Papierkorb-Einträge auflisten, wiederherstellen oder endgültig löschen | POST /api/v1/trash/query, POST /api/v1/trash/restore, POST /api/v1/trash/preview, POST /api/v1/trash/delete-permanently oder POST /api/v1/trash/empty |
| Konfigurationsänderung vorab prüfen oder anwenden | POST /api/v1/model/preview oder POST /api/v1/model/apply |
| Werte für einen Bericht aggregieren | POST /api/v1/reports/query |
| Ausstehende Operation verfolgen, abbrechen oder fortsetzen | POST /api/v1/operations/status, POST /api/v1/operations/cancel oder POST /api/v1/operations/resume |
Breaking Change: Diese Routen ersetzen die früheren entitätsspezifischen Endpunkte, die entfernt wurden. Passen Sie HTTP-Request-Nodes an, die noch einen Endpunkt für Kontakte, Organisationen, Deals, Leistungen oder Aufgaben aufrufen.
Die Basis-URL ist die Adresse, unter der Sie Customermates öffnen. Eine Mutation enthält eine stabile typeId, einen Idempotenzschlüssel und die erwartete Konfigurationsrevision; Änderungen und Löschungen enthalten außerdem Datensatzreferenz und erwartete Version. Felder sind typisierte Zuweisungen, Verknüpfungen nennen ihre Beziehungsdefinition. Eine Löschung kann den Hash einer aktuellen Auswirkungs-Vorschau verlangen. Abfrageformen stehen unter Filtersyntax.
Wie rufe ich MCP-Tools aus n8n auf?
Senden Sie POST <BASE_URL>/api/v1/mcp mit Content-Type: application/json, Accept: application/json, text/event-stream und Ihrer x-api-key-Credential. Beispiel für die Typ-Ermittlung:
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"discover_record_types","arguments":{}}}Das Ergebnis kann als Server-Sent Event eintreffen; parsen Sie die JSON-RPC-Zeile data:. Eine Tool-Ablehnung enthält result.isError: true, und Argumente außerhalb des Tool-Schemas werden vor der Ausführung abgelehnt. get_record_model liest IDs, query_crm_records fragt ab, und mutate_crm_record ändert Datensätze oder Verknüpfungen. Siehe MCP-Katalog.
Wie führe ich geplante Jobs aus?
Mit dem Zeitplan-Trigger von n8n und der Datensatz-API können Sie passende Datensätze finden, exportieren oder validiert ändern. Eine Customermates-Routine kann stattdessen Mate innerhalb des Produkts nach Zeitplan ausführen. Deal-Phasen, Task-Prioritäten und eigene Listen sind Workspace-Konfiguration; ermitteln Sie vor dem Filtern oder Schreiben ihre IDs.
Wie funktioniert die Authentifizierung?
Öffnen Sie API-Schlüssel und erstellen Sie mit Hinzufügen einen Key. Speichern Sie ihn als n8n-Header Auth-Credential namens x-api-key und verwenden Sie dieselbe Credential in allen Nodes. Der Key handelt mit den Rechten seines Besitzers. Ein falscher, abgelaufener oder gelöschter Key führt zu einem Authentifizierungsfehler, und der Key eines inaktiven Besitzers kann nicht handeln. Siehe API-Keys.
Was sind häufige Stolperfallen?
- Beziehungen: Verwenden Sie
mutate_crm_recordmitlinkoderunlinkstatt alter Arrays wieorganizationIds. - Wiederholungen: Nutzen Sie für exakt dieselbe Mutation denselben Idempotenzschlüssel. Ein geänderter Payload braucht einen neuen Schlüssel.
- Webhooks: Zustellungen sind weder strikt geordnet noch genau einmalig. Deduplizieren Sie nach Ereignis-ID und verwenden Sie den Zeitstempel des Payloads zur Ordnung.