> ## 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 |

> [!NOTE]
>
> 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

**1. Ressource öffnen**

Öffne die gewünschte Ressource und wechsle zum Reiter **Integrationen**.

**2. ICS-Link hinterlegen**

Klicke im Abschnitt **ICS-Kalenderimporte** auf **Kalender importieren**, füge den ICS-Link in das Feld **iCal URL** ein und speichere.

Sobald der Link hinterlegt ist, beginnt anny mit der gestaffelten Synchronisation der Termine.

> [!TIP]
>
> 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. |
| Kalendereinträge anonymisieren | Ereignisse aus dem externen Kalender können anonymisiert dargestellt werden (nur als "Belegt" statt mit Titel). |
| ICS-Kalenderexporte | 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

> [!WARNING]
>
> 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** → **ICS-Kalenderimporte**.

## FAQ

> **Ab welchem Plan kann ich ICS-Kalender nutzen?**
>
> Die ICS-Kalenderintegration ist ab dem Essential-Plan verfügbar.

> **Werden anny Buchungen auch in meinen externen Kalender übertragen?**
>
> 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.

> **Wie schnell werden Änderungen übernommen?**
>
> 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.

> **Kann ich mehrere ICS-Kalender auf einer Ressource hinterlegen?**
>
> Ja. Du kannst mehrere ICS-Links für eine Ressource hinterlegen. Alle werden als Blocker-Quelle genutzt.

## Troubleshooting

> **Termine aus dem externen Kalender erscheinen nicht als Blocker**
>
> 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.

> **Blocker verschwinden nach einiger Zeit**
>
> Der ICS-Link ist möglicherweise abgelaufen oder wurde vom Anbieter geändert. Generiere einen neuen Link und hinterlege ihn erneut.

> **Nur manche Termine werden synchronisiert**
>
> 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** → **ICS-Kalenderimporte** → Button „Kalender importieren" → Feld „iCal URL"
> * 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.