Kalenderexport

Owner und Admins erzeugen den Feed auf der Dashboard-Seite Kalenderexport unter /integrations/export. Der Docs-Button unten rechts öffnet diese Anleitung. Format, Header und Fehlercodes stehen unter Webhooks und Kalender. Diese Seite ersetzt den Vertrag nicht.

Ziel

Ein aktiver Kalenderfeed liefert die veröffentlichten, geplanten Kurstermine des Workspace an Google Calendar, Apple Calendar oder Outlook.

Voraussetzungen

Benötigte Rolle: Owner oder Admin. Trainer:in sieht Integrationen nicht. Ohne Recht erscheint Keine Berechtigung für Integrationen.
Ein Plan mit Entwicklerfunktionen: Studio oder Business. Free und Solo enthalten API, ICS und Webhooks nicht.
Mindestens ein veröffentlichter Kurs mit geplantem Termin, sonst bleibt der Feed leer, ist aber gültig.

Schritte

1. Kalenderexport öffnen

Öffne in der Gruppe Integrationen den Eintrag Kalenderexport. Die feste Route ist https://app.orbinaut.ccl-dev.com/integrations/export.
Überschrift Kalenderexport. Untertitel: Veröffentlichte Kurstermine als geheimer Kalenderfeed.
Ohne Einträge: Noch kein Kalenderfeed.

2. Feed erstellen

Wähle Feed erstellen.
Hinweis: Nur veröffentlichte Termine. Keine Buchungs- oder Teilnehmerdaten.
Trage den Namen ein, zum Beispiel intern Teamkalender.
Bestätige mit Feed erstellen. Erfolg: Kalenderfeed wurde erstellt.
Der Dialog zeigt den Einmaligen Wert: die geheime URL. Kopieren, dann Sicher gespeichert.

Die URL hat die Form:

https://api.orbinaut.ccl-dev.com/api/calendar/v1/YOUR_CALENDAR_TOKEN.ics

Den Token nicht in Git, Tickets oder öffentliche Seiten legen. Listen zeigen später nur Präfix und Version.

3. Wer kopiert, wohin der Feed geht

Nur Owner und Admin erzeugen, kopieren, rotieren oder widerrufen den Feed. Trainer:in hat die Seite nicht.

Die kopierte URL abonnierst du in einem Kalenderprogramm, das ICS-Feeds unterstützt. Der Dialog nennt Google Calendar, Apple Calendar und Outlook. Das Programm ruft den Feed selbst ab. Orbinaut schiebt nichts in ein Google-Konto.

Im Feed enthalten sind Kurs-Titel, Beschreibung, Ort sowie Beginn und Ende. Nicht enthalten sind Buchungen, Teilnehmernamen, E-Mails und interne Online-Zugangsdaten. Zeiten stehen in UTC. Pro Abruf erscheinen die frühesten 1.000 Termine im Zeitraum von 30 Tagen vor bis 365 Tagen nach dem Abruf. Der genaue Vertrag: Webhooks und Kalender.

4. Rotieren oder widerrufen

Die Tabelle listet Name, Status, Zuletzt abgerufen und Aktionen.

Rotieren fragt Kalenderfeed rotieren? Alte Abos verlieren sofort den Zugriff. Die neue URL erscheint genau einmal. Abonniere den Kalender mit der neuen Adresse.
Widerrufen fragt Kalenderfeed widerrufen? Der Feed lässt sich danach nicht mehr abonnieren. Status Widerrufen. Unbekannte oder widerrufene Tokens liefern 404 / calendar_not_found.

Planlimits

Plan	API, ICS und Webhooks
Free	nein
Solo	nein
Studio	ja
Business	ja

Ein neuer Token ändert ein fehlendes Plankontingent nicht. Nötig ist ein Planwechsel.

Ergebnis

Der Feed steht in der Tabelle Kalenderexport mit Status Aktiv.
Das Kalenderprogramm zeigt veröffentlichte Kurstermine ohne Teilnehmerdaten.
Nach Rotation oder Widerruf laden alte Abos den Feed nicht mehr.

Wenn etwas schiefgeht

Beobachtung	Ursache	Nächster Schritt
Keine Berechtigung für Integrationen	Rolle Trainer:in	Owner oder Admin bitten
Nicht in diesem Plan enthalten.	Free oder Solo	Studio oder Business wählen
Kalender bleibt leer	Kein veröffentlichter geplanter Termin	Kurs veröffentlichen
Abo bricht nach Rotation ab	Alte URL ungültig	Neue URL abonnieren
Feed nicht erreichbar	Token widerrufen oder Plan ohne ICS	Feed erstellen oder Plan prüfen
Abruf antwortet mit `429`	Polling-Limit für Feed oder Client erreicht	So viele Sekunden wie in `Retry-After` warten