Zircon CRM / KI & Integrationen
Läuft im Browser · DE / EN / HUREST-API mit eigenen Berechtigungen für jede Integration
Über die REST-API von Zircon CRM lesen und schreiben Ihre Website, Ihr Onlineshop, Ihr BI-Werkzeug oder eine Automatisierung direkt Kunden, Leads, Projekte, Tickets und Finanzdaten. Jede Integration bekommt einen eigenen API-Benutzer und darf nur, was Sie in seiner Berechtigungstabelle anhaken.
19 GeschäftsressourcenRechte pro RessourceAblaufende, tauschbare Tokens
Kurz gesagt
Wofür ist die REST-API von Zircon CRM da?
Eine REST-API ist eine standardisierte Web-Schnittstelle, über die andere Systeme Daten als JSON abfragen und senden. Zircon CRM stellt so 19 Geschäftsressourcen bereit, inklusive eigener Felder, zum Abrufen, Suchen, Anlegen, Ändern und Löschen. Jede Integration erhält einen eigenen API-Benutzer, ein ablaufendes Token und Rechte pro Ressource. Gedacht ist sie für Entwickler, Integrationspartner und BI-Analysten.
Kommt Ihnen das bekannt vor?
Die Daten fließen, aber niemand weiß, wer was mitnimmt.
Wenn Ihnen einer dieser Punkte bekannt vorkommt, laufen Ihre Integrationen noch im Blindflug.
- 01
Der Onlineshop sieht alles
Für den Abgleich der Bestellungen brauchte es einen Schlüssel, und das Admin-Konto war am einfachsten. Seitdem hat der Shop auch Zugriff auf Zahlungen und Mitarbeiterdaten.
- 02
Ein Schlüssel geleakt, drei Systeme betroffen
Das Token ist in einem öffentlichen Code-Repository gelandet. Es muss ersetzt werden, aber niemand weiß, welche Integrationen es noch nutzen.
- 03
Das nächtliche Skript gerät außer Kontrolle
Eine fehlerhafte Schleife schickt ununterbrochen Anfragen, und am Morgen ist die Oberfläche zäh. Welche Integration es war, zeigen erst die Serverprotokolle.
Was es kann
Das bietet die REST-API von Zircon CRM.
Die API verwalten Administratoren, und jede Änderung daran landet im Aktivitätsprotokoll.
19 Ressourcen mit eigenen Feldern
Kunden, Kontakte, Leads, Projekte, Meilensteine, Aufgaben, Zeiteinträge, Tickets, Rechnungen, Kostenvoranschläge, Angebote, Verträge, Gutschriften, Ausgaben, Zahlungen, Artikel, Mitarbeiter, Kalendertermine und Abonnements. Die Antworten enthalten auch die Werte eigener Felder.
Berechtigungstabelle pro Ressource
Für jeden API-Benutzer haken Sie pro Ressource an, was er darf: abrufen, suchen, anlegen, ändern, löschen. Ein Website-Formular darf dann nur Leads anlegen, ein BI-Werkzeug nur Rechnungen lesen.
Ablaufdatum, Limits, Tausch
Jeder API-Benutzer kann ein Ablaufdatum bekommen, und konfigurierbare Anfrage- und Burst-Limits schützen das System vor Überlastung. Ein Häkchen erzeugt ein neues Token: Das alte funktioniert sofort nicht mehr, die Nutzungsstatistik bleibt erhalten.
Suche in eigenen Feldern und Tags
Die Stichwortsuche durchsucht die üblichen Felder und auch die Werte eigener Felder. Tickets, Leads, Rechnungen und Projekte finden Sie auch über Tags (#), Belegnummern mit oder ohne Präfix.
Nutzungsstatistik und Reporting
Jede Anfrage wird mit Endpunkt, Antwortcode, Antwortzeit und IP-Adresse protokolliert. Pro API-Benutzer sehen Sie Statistiken über 7, 30 oder 90 Tage, und der unternehmensweite Bericht lässt sich als CSV exportieren.
Sensible Daten bleiben drinnen
Passwort-Hashes, Schlüssel zum Zurücksetzen von Passwörtern und Geheimnisse der Zwei-Faktor-Anmeldung werden aus jeder Antwort entfernt, egal welcher Endpunkt die Daten liefert.
So funktioniert es
So kommt ein Website-Formular ins CRM.
- 01
API-Benutzer anlegen
Sie geben ihm einen Namen (etwa „Website, Lead-Formular“), ein Ablaufdatum, falls er befristet ist, und legen die Anfrage-Limits fest.
- 02
Nur die nötigen Rechte vergeben
In der Tabelle haken Sie Leads → Create an und bei Bedarf Custom Fields → Get.
- 03
Der Entwickler testet
Sie geben das Token an den Entwickler weiter. Er prüft es über den Token-Check-Endpunkt, testet Aufrufe im Admin-Request-Builder und bindet dann das Formular an.
- 04
Verkehr beobachten
Neue Anfragen kommen als Leads an. Die Statistik zeigt Fehler, und falls das Token einmal geleakt wird, tauschen Sie es mit einem Speichern aus.
Arbeitet zusammen mit
Mit diesen Modulen arbeitet die API am häufigsten.
- MCP-Server für KI-AssistentenFür KI-Assistenten ist MCP der bessere Weg, weil es als Mitarbeiter mit dessen Rechten läuft.
- Lead-Formulare für die WebsiteReicht das eingebaute Formular nicht, legt Ihr eigenes Formular Leads über die API an.
- RechnungenRechnungen lassen sich mit Positionen und Summen lesen und schreiben, Zahlungen darauf buchen.
- Eigene FelderDie Werte eigener Felder wandern mit dem Datensatz in beide Richtungen.
- Datenimport und -exportCSV-Import für einmalige Umzüge, die API für laufende Synchronisation.
- Integrationendie Liste fertiger Anbindungen an Drittanbieter, die keine Entwicklung brauchen.
Ehrlich gesagt
Gut zu wissen, bevor Sie starten.
Die API beantwortet Anfragen, sendet aber keine Ereignisse (keine Webhooks), und Listen kommen ohne Paging vollständig zurück. Änderungen verfolgen Integrationen per Abfrage, große BI-Auszüge planen Sie entsprechend.
Wer einen Beleg mit Positionen ändert (Rechnung, Kostenvoranschlag, Angebot, Gutschrift), muss den vollständigen Beleg mit Positionen und Summen senden. Eine Änderung mit Dateien ersetzt die vorhandenen Anhänge.
Für API-Benutzer gelten die Sichtbarkeitsregeln der Mitarbeiter nicht. Lesezugriff auf Finanz- und Mitarbeiterdaten sollten nur vertrauenswürdige Integrationen bekommen.
Der Request-Builder ruft das Live-System auf und ändert echte Daten. Zum Ausprobieren nehmen Sie einen Test-API-Benutzer mit eingeschränkten Rechten.
Die API-Aufrufe gehen direkt an Ihre Installation von Zircon CRM, auf Ihrem eigenen Server oder in Ihrer privaten Cloud. Welche Daten eine Integration bekommt, entscheidet allein ihre Berechtigungstabelle.
Bevor Sie schreiben
Berechtigte Fragen. Ehrliche Antworten.
- 01
Kann ich einen KI-Assistenten an die REST-API anbinden?
Technisch ja, aber Zircon CRM hat dafür den MCP-Server. MCP läuft als Mitarbeiter mit dessen Rechten, protokolliert jeden Aufruf, und Claude oder Cursor verbinden sich in wenigen Schritten. Für API-Benutzer gelten die Sichtbarkeitsregeln der Mitarbeiter nicht.
- 02
Benachrichtigt Zircon CRM ein anderes System, wenn sich Daten ändern?
Nein. Die API beantwortet nur Anfragen und sendet keine Ereignisse. Muss eine Integration auf Änderungen reagieren, fragt sie den passenden Endpunkt in Abständen ab, und Sie setzen die Anfrage-Limits entsprechend.
- 03
Funktioniert die API von Zircon CRM mit n8n, Make oder Zapier?
Ja, mit jedem Werkzeug, das eine allgemeine HTTP-Anfrage senden kann. Fertige Konnektoren gibt es nicht: Die Automatisierung ruft die Endpunkte direkt mit dem Token auf.
- 04
Was tun, wenn ein API-Token geleakt wurde?
In Zircon CRM bearbeiten Sie den API-Benutzer, fordern ein neues Token an und speichern. Das alte Token funktioniert sofort nicht mehr, die Integration muss auf das neue umgestellt werden, und die Nutzungsstatistik geht auf das neue über.
Sprechen wir.
Das erste Gespräch ist unverbindlich
Ein Mensch antwortet — kein Bot
Bringen Sie eine Liste mit, welches Ihrer Systeme was im CRM lesen oder schreiben soll. In der Demo richten wir gemeinsam einen API-Benutzer mit genau diesen Rechten ein und sehen uns an, was seine Statistik zeigt.
- hello@zircon.hu
- Telefon
- +36 30 487 7979
- Erreichbar
- Werktags 9–17 Uhr
- Support
- support@zircon.hu (für Bestandskunden)