Kalender-Feeds (ICS)

Warum das zählt

Mit einem Kalender-Feed liest Kit belegte Zeiten aus Ihrem Kalender und zeigt sie auf der Feed-Seite an. Dafür fügen Sie eine ICS-URL ein; eine OAuth-Freigabe ist nicht nötig. Die Feed-Daten werden derzeit nicht von den buchbaren Interviewzeiten abgezogen.

Das funktioniert mit:

• Google Calendar (privat oder Workspace)
• Microsoft Outlook / Office 365
• Apple Calendar (iCloud)
• Jeder Kalender-App, die eine ICS/iCal-Export-URL anbietet

Kit ruft Ihren Kalender-Feed alle 15 Minuten ab und speichert die gefundenen Beschäftigt-Zeitfenster zwischen.

Die Konflikterkennung nutzt derzeit nur Google Calendar. Ein Kalender-Feed ist am gesamten Konto hinterlegt, nicht an einer Person, daher kann Kit nicht erkennen, wessen Verfügbarkeit er blockieren soll. Bis Feeds einen Eigentümer haben, werden ihre Beschäftigt-Zeitfenster zwischengespeichert und auf der Feed-Seite angezeigt, entfernen aber keine Zeitfenster von den Buchungsseiten für Interviews. Um Ihre belegten Zeiten vor Kandidaten zu verbergen, verbinden Sie Google Calendar und aktivieren Sie Auf Terminüberschneidungen prüfen.

Voraussetzungen

• Ein Kit-Konto mit aktivierter Terminplanung
• Eine Kalender-App, die eine geheime ICS/iCal-URL anbietet (die meisten tun das)

Kalender-Feed hinzufügen

1. Navigieren Sie zu Integrationen > Kalender-Feeds
2. Klicken Sie auf Kalender-Feed hinzufügen
3. Fügen Sie die ICS-URL Ihres Kalenders ein (muss mit https:// beginnen)
4. Optional: Vergeben Sie einen Anzeigenamen (Kit erkennt ihn automatisch aus dem Feed)
5. Klicken Sie auf Kalender-Feed hinzufügen

Kit prüft die URL, ruft den Feed ab und speichert die gefundenen belegten Zeiten zwischen.

ICS-URL finden

Google Calendar

1. Öffnen Sie Google Calendar und klicken Sie auf das Zahnrad-Symbol (Einstellungen)
2. Klicken Sie in der linken Seitenleiste auf den Kalendernamen
3. Scrollen Sie zu Geheime Adresse im iCal-Format
4. Kopieren Sie die URL

Wichtig: Verwenden Sie die geheime Adresse, nicht die öffentliche, es sei denn, Ihr Kalender ist absichtlich öffentlich. Die geheime URL enthält ein Token, das Lesezugriff gewährt.

Microsoft Outlook / Office 365

1. Öffnen Sie Outlook im Browser und gehen Sie zu Einstellungen > Kalender
2. Klicken Sie auf Freigegebene Kalender
3. Wählen Sie unter „Kalender veröffentlichen“ den gewünschten Kalender aus
4. Wählen Sie Alle Details anzeigen und klicken Sie auf Veröffentlichen
5. Kopieren Sie den ICS-Link (nicht den HTML-Link)

Apple Calendar (iCloud)

1. Öffnen Sie die Kalender-App auf Ihrem Mac
2. Klicken Sie mit der rechten Maustaste auf den gewünschten Kalender
3. Wählen Sie Kalender teilen …
4. Aktivieren Sie Öffentlicher Kalender
5. Kopieren Sie die angezeigte URL

So funktioniert es

Aspekt	Details
Abfragefrequenz	Alle 15 Minuten
Abgerufene Daten	Die ICS-Datei unter der angegebenen URL; ihr Inhalt hängt von den Freigabeeinstellungen des Kalenders ab
Gespeicherte Daten	Nur Beschäftigt-Zeitfenster (keine Termindetails)
Zeitraum	Nächste 30 Tage
Wiederkehrende Termine	Automatisch aufgelöst (täglich, wöchentlich, monatlich)
Ganztägige Termine	Werden als ganztägige Beschäftigt-Zeitfenster gespeichert, wenn sie als beschäftigt markiert sind

Die gespeicherten Beschäftigt-Zeitfenster erscheinen auf der Feed-Seite. Von den Interviewzeitfenstern, die Kandidaten buchen können, werden sie derzeit nicht abgezogen.

Google Calendar-Integration vs. Kalender-Feeds

Funktion	Google Calendar (OAuth)	Kalender-Feeds (ICS)
Konflikterkennung	Ja, live abgefragt, wenn ein Kandidat eine Buchungsseite öffnet	Noch nicht; Beschäftigt-Zeitfenster werden zwischengespeichert, wirken sich aber nicht auf Buchungsseiten aus
Interview-Einladungen	Per E-Mail als .ics, zusätzlich ein direkter Kalendereintrag für den Lead-Interviewer, wenn dieser Erstellung von Ereignissen in diesem Kalender erlauben aktiviert hat	Nur per E-Mail als .ics; in einen ICS-Feed kann Kit niemals schreiben
Einrichtung	OAuth-Autorisierung	URL einfügen
Kompatibilität	Nur Google Calendar	Jeder Kalenderanbieter
Datenschutz	Erfordert Kalenderberechtigungen	URL-basiert, kein Kontozugriff
Ganztägige Termine	Unterstützt	Unterstützt
Wiederkehrende Termine	Über Google API verarbeitet	Aus dem Feed aufgelöst

Verwenden Sie Google Calendar, wenn Sie Echtzeit-Konflikterkennung wünschen oder wenn gebuchte Interviews im Kalender des Lead-Interviewers landen sollen, ohne dass jemand einen Anhang annehmen muss (siehe Kalenderanbindung). Ein Kalender-Feed ist schreibgeschützt: Kit liest daraus die Beschäftigt-Zeiten und kann niemals hineinschreiben. In beiden Fällen werden Interview-Einladungen zusätzlich immer per E-Mail als .ics-Anhang versendet.

Verwenden Sie Kalender-Feeds, wenn Sie keinen OAuth-Zugriff gewähren möchten, einen Nicht-Google-Kalender nutzen oder einen zusätzlichen Kalender eines anderen Anbieters hinzufügen möchten.

Sie können beide Quellentypen verbinden. Die Kandidatenbuchung prüft derzeit nur die Google-Kalender des Interviewers, für die die Konflikterkennung aktiviert ist.

Kalender-Feeds verwalten

Feed bearbeiten

Navigieren Sie zu Integrationen > Kalender-Feeds, suchen Sie Ihren Feed im Abschnitt Kalender-Feeds und klicken Sie auf das Stift-Symbol. Sie können den Anzeigenamen ändern und die Konfliktprüfung ein- oder ausschalten.

Feed aktualisieren

Klicken Sie auf das Drei-Punkte-Menü (⋮) neben einem Feed und wählen Sie Jetzt aktualisieren. Kit ruft sofort die neueste Version ab, anstatt auf die nächste 15-Minuten-Abfrage zu warten.

Feed entfernen

Klicken Sie auf das Drei-Punkte-Menü (⋮) und wählen Sie Feed entfernen. Kit ruft diesen Kalender nicht mehr ab und löscht die zwischengespeicherten belegten Zeiten. Ihr Kalender selbst bleibt unverändert.

Datenschutz und Sicherheit

Kalender-Feeds sind auf Datenschutz ausgelegt:

• Keine Termindetails gespeichert: Kit lädt die ICS-Datei herunter und extrahiert Start-/Endzeiten und den Frei/Beschäftigt-Status. Titel, Beschreibungen, Teilnehmer und Orte werden in den Feed-Daten nicht aufbewahrt.
• Verschlüsselte Speicherung: Ihre Kalender-URL wird verschlüsselt gespeichert. Sie wird weder protokolliert noch in API-Antworten angezeigt.
• Nur HTTPS: Kit akzeptiert ausschließlich Kalender-URLs über HTTPS.
• Sie behalten die Kontrolle: Um den Zugriff von Kit zu widerrufen, generieren Sie in Ihrer Kalender-App (Google, Outlook usw.) eine neue geheime URL. Die alte URL funktioniert sofort nicht mehr.

Zugriff widerrufen

Anders als bei OAuth (wo Sie den Zugriff in Kit oder Ihrem Google-Konto widerrufen) wird der Zugriff auf Kalender-Feeds über die URL selbst gesteuert:

1. Gehen Sie zu den Einstellungen Ihrer Kalender-App
2. Suchen Sie den veröffentlichten/freigegebenen Kalender
3. Klicken Sie auf „Zurücksetzen“ oder „Veröffentlichung aufheben“, um die alte URL ungültig zu machen
4. Entfernen Sie in Kit den alten Feed und fügen Sie bei Bedarf die neue URL hinzu

Fehlerbehebung

Feed wird nicht aktualisiert

Mögliche Ursachen:

1. Die Kalender-URL wurde widerrufen oder neu generiert
2. Ihr Kalenderanbieter ist vorübergehend nicht erreichbar
3. Der Feed wurde nach wiederholten Fehlern pausiert

Lösung:

• Prüfen Sie den Feed-Status unter Integrationen > Kalender-Feeds
• Klicken Sie auf Jetzt aktualisieren, um eine sofortige Aktualisierung zu erzwingen
• Falls die URL neu generiert wurde, entfernen Sie den alten Feed und fügen Sie die neue URL hinzu

Termine fehlen in der Feed-Vorschau

Mögliche Ursachen:

1. Der Termin ist in Ihrem Kalender als „frei“ (transparent) markiert
2. Der Termin verwendet ein ungewöhnliches Wiederholungsmuster, das Kit nicht auflösen kann
3. Der Termin liegt mehr als 30 Tage in der Zukunft

Lösung:

• Bearbeiten Sie den Termin in Ihrem Kalender und setzen Sie den Status auf „beschäftigt“
• Prüfen Sie bei wiederkehrenden Terminen, ob diese in Ihrer Kalender-App korrekt angezeigt werden

Feed zeigt „Fehler“ oder „Pausiert“

Kit pausiert Feeds nach wiederholten Abruffehlern, um unnötige Anfragen zu vermeiden.

• Fehler (3+ Fehlversuche): Kit versucht es weiterhin. Prüfen Sie, ob Ihre URL gültig ist.
• Pausiert (anhaltende Fehler): Kit hat die Abfrage eingestellt. Entfernen Sie den Feed und fügen Sie ihn mit einer neuen URL erneut hinzu.

Auf einen Blick

• Navigieren Sie zu Integrationen > Kalender-Feeds
• Klicken Sie auf Kalender-Feed hinzufügen
• Fügen Sie die geheime ICS-URL Ihres Kalenders ein
• Überprüfen Sie, ob der Feed nach einigen Minuten als „Aktiv“ angezeigt wird
• Öffnen Sie den Feed und prüfen Sie, ob die belegten Zeiten abgerufen wurden
• Fügen Sie optional Feeds für weitere Kalender hinzu (privat, Team usw.)