Mit API-Tokens rufen dein eigener Code oder Tools wie Zapier und Make die Zeeg-API in deinem Namen auf. Du startest einen Token von dem Zweck aus, für den du ihn brauchst, und er bekommt nur die Berechtigungen, die diese Aufgabe braucht. Zeeg zeigt den Token nur einmal, direkt nach dem Erstellen.
Du kannst bis zu 5 aktive Tokens gleichzeitig haben. Einige Berechtigungen brauchen einen kostenpflichtigen Plan: Freie Zeiten, Termine buchen und die Schreibstufe von Benutzer sind in der Testphase gesperrt. Wenn dein Abo nur KI-Minuten enthält, darf ein Token nur die KI-Berechtigungen haben.
So erstellst du einen API-Token
Öffne Einstellungen, dann Verbindungen und dann API-Tokens. Wenn du noch keinen Token hast, siehst du die Ausgangspunkte direkt auf dieser Seite.
Klicke auf API-Token erstellen (oder auf der leeren Seite auf einen Ausgangspunkt).
Wähle unter Wofür ist dieser Token? einen Ausgangspunkt und klicke auf Weiter. Das Feld rechts zeigt ein Beispiel dafür, was der Token kann und welche Berechtigungen er bekommt.
Gib einen Token-Namen ein. Zeeg schlägt anhand des Ausgangspunkts einen vor, den du ändern kannst.
Klicke auf die Ablauf-Schaltfläche neben dem Namen und wähle 30 Tage, 90 Tage, 1 Jahr oder Benutzerdefiniert. Bei Benutzerdefiniert wählst du einen Tag im Kalender. Der Token läuft am Ende dieses Tages in der Zeitzone deines Kontos ab.
Prüfe die Berechtigungen unter Für diesen Zweck festgelegt. Ändere bei Bedarf die Stufe mit Keine, Lesen oder Schreiben, oder öffne Berechtigungen anpassen, um weitere hinzuzufügen.
Klicke auf API-Token erstellen.
Klicke unter Kopiere deinen Token auf Token kopieren und bewahre den Token sicher auf, zum Beispiel in einem Passwort-Manager. Klicke auf Fertig, wenn du ihn hast.
Zeeg zeigt den Token nur dieses eine Mal. Wenn du den Dialog schließt, bevor du ihn kopiert hast, fragt Zeeg Schließen, ohne zu kopieren?. Klicke nur dann auf Trotzdem schließen, wenn es für dich in Ordnung ist, einen neuen Token zu erstellen.
Welchen Ausgangspunkt solltest du wählen?
Verfügbarkeit prüfen: Frag von deinem eigenen Server aus ab, ob eine Terminseite noch eine freie Zeit hat. Berechtigungen: Terminseiten (Lesen) und Freie Zeiten.
Auf deiner Website buchen: Zeig freie Zeiten in deinem eigenen Formular und buche sie direkt dort. Berechtigungen: Terminseiten (Lesen), Freie Zeiten und Termine buchen.
Termine synchronisieren: Hol neue und geänderte Termine in dein CRM oder Data Warehouse. Berechtigungen: Termine (Lesen) und Webhooks (Schreiben).
Kontakte synchronisieren: Halte Personen und Unternehmen in deinem CRM mit Zeeg abgeglichen. Berechtigung: CRM-Datensätze (Schreiben).
KI-Telefonassistenten: Lass dein System einen KI-Telefonassistenten einen Lead anrufen und lies die Ergebnisse. Berechtigungen: Ausgehende Anrufe (Schreiben) und KI-Telefonassistenten (Lesen).
Benutzerdefiniert: Wähle jede Berechtigung selbst.
Jede Berechtigungszeile zeigt ihren API-Scope-Namen, zum Beispiel timetable oder event_types:read, so wie ihn die API-Dokumentation schreibt. Unter Berechtigungen anpassen findet das Suchfeld eine Berechtigung über ihre Bezeichnung oder ihren Scope-Namen.
Du kannst auch Stattdessen Vollzugriff einschalten (Scope admin:full). Dieser Token kann alles lesen, ändern und löschen, was du kannst. Nutze das also nur, wenn kein Ausgangspunkt passt.
Berechtigungen mit kostenpflichtigem Plan
Einen Ausgangspunkt oder eine Berechtigung, die dein Plan nicht enthält, erkennst du am Schloss und an Braucht einen kostenpflichtigen Plan, mit dem nötigen Plan daneben. Du kannst sie dir ansehen, aber der Dialog endet in Upgrade statt in Weiter oder API-Token erstellen. Wenn du das Abo nicht verwalten kannst, sagt dir der Dialog, wer den Plan upgraden kann.
Was mit deinen Tokens passiert, wenn sich dein Plan ändert, erfährst du im Artikel Was bei einem Downgrade mit deinen Terminseiten, Kalendern und API-Tokens passiert.
Tokens verwalten
Die Token-Liste zeigt für jeden Token den Namen, die Berechtigungen als Chips und das Ablaufdatum. Oben auf der Seite, neben API-Token erstellen, zeigt ein Zähler wie 2/5 Tokens, wie viele deiner fünf Tokens in Gebrauch sind.
Ein Token mit Vollzugriff trägt das Abzeichen Vollzugriff.
Ein Token, der innerhalb von 14 Tagen abläuft, zeigt die verbleibenden Tage, zum Beispiel in 3 Tagen.
Ein Token, dessen Ablaufdatum vorbei ist, trägt das Abzeichen Abgelaufen. Er zählt weiter zum Limit von 5, bis du ihn widerrufst.
Fahre mit der Maus über das Ablaufdatum, um die genaue Uhrzeit im 12- oder 24-Stunden-Format deines Kontos zu sehen.
Token erneuern
Klicke in der Zeile des Tokens auf Weitere Aktionen und wähle Token erneuern. Der Dialog öffnet sich mit demselben Namen und denselben Berechtigungen, du wählst nur ein neues Ablaufdatum. Beim Erneuern entsteht ein zweiter Token neben dem ersten, deshalb brauchst du einen freien Platz unter dem Limit von 5.
Token widerrufen
Klicke in der Zeile des Tokens auf Weitere Aktionen, wähle Token widerrufen und bestätige. Der Dialog nennt den Token, den du widerrufst. Alles, was ihn nutzt, funktioniert sofort nicht mehr, und das lässt sich nicht rückgängig machen.
Häufig gestellte Fragen
Ich habe meinen Token verloren. Kann ich ihn noch einmal sehen?
Nein. Zeeg zeigt einen Token nur einmal, wenn du ihn erstellst. Erstelle einen neuen Token (oder nutze Token erneuern, um die Berechtigungen des alten zu übernehmen) und widerrufe dann den verlorenen.
Warum ist die Schaltfläche „API-Token erstellen“ deaktiviert?
Entweder hast du schon 5 aktive Tokens, oder dein Plan enthält keinen API-Zugriff. Widerrufe einen Token, den du nicht mehr brauchst, oder upgrade deinen Plan. Tokens, die wegen einer Planänderung pausiert sind, zählen nicht zu den 5.
Warum kann ich für eine Berechtigung nicht „Schreiben“ wählen?
Diese Stufe braucht einen kostenpflichtigen Plan und ist deshalb gesperrt. Klicke auf Upgrade, um die Pläne zu sehen, die sie enthalten.
Mein Abo enthält nur KI-Minuten. Was kann mein Token?
Er darf nur die KI-Berechtigungen haben: Ausgehende Anrufe (Schreiben) und KI-Telefonassistenten (Lesen oder Schreiben). Die anderen Berechtigungen sind gesperrt, und der Schalter Stattdessen Vollzugriff ist ausgeblendet.
Wo finde ich die API-Dokumentation?
Die Zeeg-Entwicklerdokumentation listet jeden Endpunkt und den Scope, den er braucht.