CRM-Integration über offene Schnittstellen statt App-Marktplatz

CRM-Integration heißt: Daten und Auslöser fließen zwischen dem CRM und Ihren anderen Systemen, ohne dass jemand einen Deal von einem Fenster ins nächste abtippt. Customermates setzt dafür auf vier offene Schnittstellen statt auf einen App-Marktplatz: eine REST-API, ausgehende Webhooks, einen MCP-Endpunkt für KI-Clients und eine Community-Node für n8n. Alle vier stehen in jedem Tarif zur Verfügung, auch in selbst gehosteten Installationen.

Das hat eine Kehrseite, die Sie vorher kennen sollten. Es gibt keinen Katalog mit Ein-Klick-Apps. Soll Customermates mit Slack, Ihrer Buchhaltung oder einem Formular-Tool sprechen, richten Sie einen Webhook auf dieses Tool, rufen die API aus eigenem Code auf oder bauen den Ablauf in einem Automatisierungstool wie n8n, Make oder Zapier.

Die fünf Anbindungswege im Überblick

Webhooks, REST und MCP sind ab Starter für 12 € pro Nutzer und Monat enthalten. Der einheitliche Posteingang beginnt mit Pro für 29 € pro Nutzer und Monat, mit 1 verbundenem Konto pro Nutzer; Business enthält 3 Konten pro Nutzer und geteilte Konten. Selbst gehostete Installationen erhalten REST, Webhooks und MCP, aber keinen Posteingang. Messaging-Ereignisse werden dort also nie ausgelöst.

Welcher Weg passt zu welcher Aufgabe

Webhooks

Einen Webhook legen Sie unter Einstellungen → Webhooks → Hinzufügen an: Ziel-URL einfügen, Ereignisse wählen, unter Datensätze aus die Liste wählen, speichern. Zur Auswahl stehen 16 Ereignisse: 5 Datensatz-Ereignisse (angelegt, geändert, in den Papierkorb verschoben, wiederhergestellt und endgültig gelöscht, für jede gewählte Liste, auch Ihre eigenen) und 11 Messaging-Ereignisse, etwa eine eingegangene Nachricht oder E-Mail und eine Änderung in einem verbundenen Kalender.

Worauf es beim Aufbau ankommt:

• Signaturen. Mit einem Secret trägt jede Zustellung eine HMAC-SHA256-Signatur über den Request-Body. Der Empfänger kann gefälschte Aufrufe so abweisen.
• Wiederholungen. Timeouts, Netzwerkfehler, 5xx-Antworten sowie 408, 425 und 429 werden automatisch wiederholt, mit bis zu 10 Versuchen insgesamt. Andere 4xx-Antworten nicht.
• Zustellprotokoll. Einstellungen → Zustellungen zeigt jede Zustellung mit Statuscode und Payload. Von dort lässt sie sich erneut senden.
• Eigene Header und Body-Vorlagen. Header authentifizieren Sie beim Empfänger. Eine Body-Vorlage ersetzt den Standard-JSON-Umschlag durch das Format, das der Empfänger erwartet, mit Platzhaltern wie {{event}} und {{data.record.ref.recordId}}.
• Nur echte Änderungen. Ein record.updated-Ereignis enthält jedes geänderte Feld mit seinem Wert before und after. Ein Speichervorgang ohne Änderung löst kein Ereignis aus.

Zustellungen kommen nicht streng geordnet an. Behandeln Sie sie als idempotente Nachrichten mit der Event-id als Schlüssel und ordnen Sie sie über den timestamp der Payload und die Datensatzversion. Den vollständigen Katalog finden Sie in der Webhook-Dokumentation.

REST-API

Die API ist unter /api/v1 versioniert, wird per Header x-api-key authentifiziert und durch ein OpenAPI-Dokument beschrieben. Dieselben Aktions-Endpunkte bedienen jede Liste, die fünf Startlisten wie die Listen, die Ihr Arbeitsbereich hinzufügt, und adressieren einen Datensatz über typeId und recordId: POST /api/v1/records/query und /records/search lesen, POST /api/v1/records/mutate legt an, ändert, löscht, verknüpft und löst Verknüpfungen, und seine Aktionen updateMany und deleteMany ändern bis zu 100 Datensätze pro Anfrage. POST /api/v1/model/read liefert Ihre Felder und deren Options-IDs. Das brauchen Sie, weil die Deal-Phase ein konfigurierbares Einzelauswahl-Feld ist und kein fester Wert.

Ein API-Key erbt die Rechte des Nutzers, der ihn angelegt hat. Eine Einschränkung pro Key gibt es nicht. Legen Sie Keys deshalb mit einem Nutzer an, dessen Rolle zur Integration passt. Mehr dazu auf der Seite zur API.

MCP für KI-Clients

MCP (Model Context Protocol) ist ein offener Standard, um KI-Anwendungen mit externen Systemen zu verbinden. Customermates betreibt einen MCP-Endpunkt unter /api/v1/mcp mit 53 Tools. Claude und ChatGPT verbinden sich als benutzerdefinierter Connector mit OAuth-Anmeldung, wie in der Anleitung für Claude und ChatGPT beschrieben. Claude Code, Codex, Cursor und Gemini CLI verbinden sich per API-Key.

Client und Modell gehören Ihnen. Ihr KI-Anbieter rechnet seine Nutzung selbst ab, und MCP-Aufrufe verbrauchen keine gehosteten KI-Credits von Customermates. Messaging-, Kalender- und Social-Tools setzen einen Cloud-Tarif mit Posteingang voraus. Die MCP-Referenz listet alle Tools.

In Customermates Cloud gibt es zusätzlich Mate, den gehosteten Assistenten, der gehostete KI-Credits verbraucht. Mate kann Webhooks für Sie anlegen und ändern, und seine Routinen führen eine gespeicherte Anweisung aus, wenn sich ein Datensatz ändert. Das deckt Arbeit ab, die Lesen und Abwägen verlangt. Feste Regeln gehören in Webhooks und n8n.

n8n, Make oder Zapier

Keines dieser Tools ist in Customermates enthalten. Sie betreiben oder abonnieren sie separat, und sie bringen die großen Konnektor-Kataloge mit. Customermates dokumentiert die Muster für n8n und veröffentlicht eine Community-Node. Make und Zapier binden Sie über deren allgemeine Webhook- und HTTP-Schritte an. Diese Seite stammt von Customermates; die Tabelle gibt das Preismodell jedes Tools nach dessen eigener Preisseite wieder, Stand 8. Oktober 2026.

n8n ist Fair-Code unter der Sustainable Use License. n8n beschreibt den Quellcode als einsehbar und selbst hostbar. Das ist eine andere Lizenz als die AGPL, unter der der Kern von Customermates steht.

Zahlen Sie bereits für eines der Tools, nehmen Sie dieses. Fangen Sie bei null an und kann jemand im Team einen Container betreiben, hält ein selbst gehostetes n8n CRM und Automatisierung auf Ihren eigenen Servern. Die n8n-Anleitung zeigt den Webhook-Trigger, die HTTP-Request-Aufrufe und das Credential für x-api-key.

Slack: zwei Wege, keine native App

Customermates hat keine Slack-App, keinen Slack-Kanal im Posteingang und keine Slack-Einstellungen. Slack erreichen Sie über Webhooks oder n8n.

Weg 1, nur mit Webhook. Slacks Incoming Webhooks nehmen einen JSON-POST wie {"text": "Hallo"} an und posten ihn in einen festgelegten Channel. Eine Body-Vorlage in Customermates erzeugt genau dieses Format:

1. Slack-Incoming-Webhook anlegen

   Legen Sie in Slack eine App an, aktivieren Sie Incoming Webhooks, fügen Sie einen Webhook zum Workspace hinzu und wählen Sie den Channel. Kopieren Sie die URL und behandeln Sie sie wie ein Passwort.

2. Webhook in Customermates anlegen

   Fügen Sie unter Einstellungen → Webhooks → Hinzufügen die Slack-URL ein, wählen Sie Datensatz erstellt und unter Datensätze aus die Liste Deals.

3. Body-Vorlage schreiben

   Tragen Sie {"text": "Neuer Deal: {{data.record.ref.recordId}}"} ein. Jeder Pfad unter {{data}} funktioniert als Platzhalter.

4. Testen und Protokoll prüfen

   Legen Sie einen Test-Deal an und öffnen Sie Zustellungen. Ein 2xx-Statuscode heißt, dass Slack die Nachricht angenommen hat.

Weg 2, mit n8n. n8n brauchen Sie, sobald Logik ins Spiel kommt: nur melden, wenn die Deal-Phase einen bestimmten Wert erreicht, einmal pro Woche eine Pipeline-Übersicht aus einem geplanten POST /api/v1/records/query posten, oder aus einem Slack-Shortcut per API einen neuen Kontakt anlegen. Slack-Gespräche erscheinen in beiden Fällen nicht im Customermates-Posteingang.

Was nicht enthalten ist

Braucht Ihr Team Hunderte fertige, vom Anbieter gepflegte Konnektoren, die jemand ohne Technikkenntnisse in einer Einstellungsseite einschaltet, passt ein CRM mit eigenem App-Marktplatz besser. Customermates passt zu Teams, die einen Webhook selbst einrichten oder die Aufrufe einem KI-Client überlassen, und die in der Cloud wie im eigenen Rechenzentrum dieselben Schnittstellen haben wollen. Die Anbindung an ein ERP folgt demselben Muster; der Leitfaden zur CRM-ERP-Integration zeigt den Ablauf.

Häufige Fragen

Angaben zu Drittanbietern geprüft am 8. Oktober 2026 auf den Seiten n8n-Preise, n8n-Repository, Make-Preise, Zapier-Preise, Slack Incoming Webhooks und MCP-Einführung.