> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.
# ICS-Kalender mit anny verbinden
> Importiere externe Kalender per ICS-Link als Blocker auf deine Ressource, unabhängig vom Kalender-Anbieter.
Ein ICS-Kalender (iCal) ist ein standardisiertes Kalenderformat, das von nahezu allen Kalender-Anwendungen unterstützt wird. Mit der Integration kann anny externe Kalendertermine über einen ICS-Link importieren und als Blocker auf einer Ressource nutzen.
Mit der ICS-Kalenderintegration kannst du in anny:
* Externe Kalendertermine als Blocker auf einer Ressource anzeigen
* Buchungen an bereits belegten Terminen automatisch verhindern
* Jeden beliebigen Kalender-Anbieter anbinden (Google, Outlook, Apple, andere)
Besonders praktisch ist die Integration, wenn du einen Kalender-Anbieter nutzt, für den anny keine native 2-Wege-Integration anbietet, oder wenn du nur eine Einweg-Synchronisation (extern → anny) benötigst.
## Typische Anwendungsfälle
| Anwendungsfall | Beschreibung |
| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Externe Belegung als Blocker nutzen | **Verhindere Doppelbuchungen durch externe Termine.** Termine aus einem beliebigen Kalender erscheinen als Blocker auf der Ressource. Buchungen in belegten Zeitslots werden automatisch verhindert. |
| Apple Kalender anbinden | **Verbinde einen iCloud-Kalender mit anny.** Da keine native Apple-Integration existiert, nutzt du den ICS-Link als Brücke. |
| Drittanbieter-Kalender synchronisieren | **Importiere Termine aus Booking-Plattformen oder anderen Tools.** Jeder Dienst, der einen ICS-Feed bereitstellt, kann als Blocker-Quelle genutzt werden. |
## Wie die ICS-Kalender-Verbindung funktioniert
Die Integration arbeitet als **Einweg-Import** (extern → anny): anny liest den ICS-Link in regelmäßigen Abständen aus und überträgt neue oder geänderte Termine als Blocker auf die Ressource.
| Daten | Richtung | Häufigkeit |
| --------------------- | ------------------------ | ------------------------ |
| Termine (als Blocker) | Externer Kalender → anny | Gestaffelt (siehe unten) |
**Sync-Intervalle:**
| Zeitraum | Aktualisierung |
| ---------------- | -------------------- |
| Aktueller Tag | Alle 5 Minuten |
| Nächste 7 Tage | Alle 15 Minuten |
| Nächste 30 Tage | Jede Stunde |
| Nächste 365 Tage | Täglich um 02:00 Uhr |
Die Synchronisation läuft nur in eine Richtung (extern → anny). anny Buchungen werden nicht in den externen Kalender zurückgeschrieben. Für eine 2-Wege-Synchronisation nutze die native Google- oder Outlook-Integration.
## ICS-Kalender verbinden
### Voraussetzungen
Bevor du einen ICS-Kalender verbindest, stelle sicher, dass du Folgendes hast:
* Einen ICS-/iCal-Link aus deinem externen Kalender (als URL verfügbar)
* Admin-Zugriff in deinem anny Account
* Die Ressource, die synchronisiert werden soll, ist bereits angelegt
### Verbindung einrichten
Öffne die gewünschte Ressource und wechsle zum Reiter **Integrationen**.
Unter **Externe Kalender** fügst du den ICS-Link in das Feld **ICAL URL** ein und speicherst.
Sobald der Link hinterlegt ist, beginnt anny mit der gestaffelten Synchronisation der Termine.
Falls dein ICS-Link ein @-Zeichen enthält, ersetze es durch `%40`. Sonst kann anny den Link nicht korrekt verarbeiten.
### ICS-Link generieren (nach Anbieter)
| Anbieter | So findest du den ICS-Link |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Google Kalender | [calendar.google.com](https://calendar.google.com) → Einstellungen → Kalender auswählen → Kalendereinstellungen → "Link zum Freigeben abrufen" |
| Outlook | [outlook.office.com](https://outlook.office.com) → Einstellungen → Alle Outlook-Einstellungen → Kalender → Geteilte Kalender → Kalender auswählen → "Veröffentlichen" → ICS-Link kopieren |
| Apple (iCloud) | [icloud.com/calendar](https://www.icloud.com/calendar/) → Seitenleiste → Kalender-Symbol → "Öffentlicher Kalender" → Link kopieren → `webcal://` durch `https://` ersetzen |
| Andere | ICS-/iCal-Link aus dem externen Kalender kopieren. Falls nötig: `@` durch `%40` ersetzen. |
### Einstellungen & Optionen
| Einstellung | Beschreibung |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| ICAL URL | Der ICS-Link des externen Kalenders. Pflichtfeld. |
| Anonymisierung | Ereignisse aus dem externen Kalender können anonymisiert dargestellt werden (nur als "Belegt" statt mit Titel). |
| Freigegebener Kalender (Export) | Um anny Buchungen in einem externen Kalender zu sehen, kannst du den freigegebenen anny-Kalender-Link in deinem externen Kalender hinterlegen. |
## Einschränkungen
Die ICS-Kalenderintegration unterstützt nicht:
* 2-Wege-Synchronisation (nur externer Kalender → anny, nicht umgekehrt)
* Echtzeit-Synchronisation (gestaffelte Intervalle, siehe oben)
* Änderungen an externen Terminen direkt in anny vornehmen (Blocker können nur in anny gelöscht werden)
## Verbindung trennen
Beim Löschen des ICS-Links werden die importierten Blocker entfernt. Neue Termine aus dem externen Kalender werden nicht mehr synchronisiert.
Entferne den ICS-Link unter **Ressource** → **Integrationen** → **Externe Kalender**.
## FAQ
Die ICS-Kalenderintegration ist ab dem Essential-Plan verfügbar.
Nicht über den ICS-Import. Für den Export kannst du den freigegebenen anny-Kalender-Link in deinem externen Kalender hinterlegen. Für eine vollständige 2-Wege-Synchronisation nutze die native Google- oder Outlook-Integration.
Abhängig vom Zeitraum: Termine am selben Tag werden alle 5 Minuten aktualisiert, Termine in der nächsten Woche alle 15 Minuten. Details in der Sync-Intervall-Tabelle oben.
Ja. Du kannst mehrere ICS-Links für eine Ressource hinterlegen. Alle werden als Blocker-Quelle genutzt.
## Troubleshooting
Prüfe, ob der ICS-Link korrekt hinterlegt ist (kein @-Zeichen, sondern %40). Teste den Link im Browser: Er sollte eine .ics-Datei herunterladen. Beachte, dass die erste Synchronisation je nach Zeitraum bis zu einer Stunde dauern kann.
Der ICS-Link ist möglicherweise abgelaufen oder wurde vom Anbieter geändert. Generiere einen neuen Link und hinterlege ihn erneut.
Die Synchronisation deckt maximal 365 Tage ab. Termine außerhalb dieses Zeitraums werden ignoriert. Außerdem werden nur Termine mit dem Status "beschäftigt" als Blocker übernommen.
> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressource** → **Integrationen** → **Externe Kalender** → ICAL URL Feld
> * Plan: ab Essential
> * Nur Einweg-Import (extern → anny). Keine Rückschreibung. Für 2-Wege: native Google- oder Outlook-Integration empfehlen.
> * Sync-Intervalle: 5 min (heute), 15 min (7 Tage), 1h (30 Tage), täglich 02:00 (365 Tage)
> * @-Zeichen im Link muss durch %40 ersetzt werden
> * Mehrere ICS-Links pro Ressource möglich
> * Apple iCloud: webcal:// durch https\:// ersetzen
> * Abgrenzung: ICS = Einweg-Import für beliebige Anbieter. Google/Outlook = native 2-Wege-Sync mit OAuth.
> * Verwandte Artikel: Kalenderintegrationen (Übersicht), Google Kalender, Outlook Kalender