CalDAV

Mit der CalDAV-Anbindung verbinden Sie einen externen Kalender mit TeleButler – entweder über ein CalDAV-Konto (z. B. Nextcloud, iCloud oder einen beliebigen CalDAV-Server) oder über einen ICS-Feed (Abo-URL). TeleButler liest daraus Ihre Termine und erstellt automatisch die passenden Telefonansagen – z. B. „Mariia Musterfrau ist ab 14:00 Uhr wieder erreichbar."

Die CalDAV-Anbindung ist die Alternative zum Outlook-Add-in für alle, die kein Outlook verwenden.

Voraussetzungen

• Ein bestehendes TeleButler-Konto.
• Die CalDAV-Funktion muss für Ihr Konto freigeschaltet sein. CalDAV ist kostenfrei. Ist der Bereich „CalDAV-Kalender" in den Einstellungen nicht sichtbar, wenden Sie sich an Ihren Administrator bzw. den TeleButler-Support.

1. CalDAV-Einstellungen öffnen

1. Öffnen Sie telebutler.app und melden Sie sich an.
2. Gehen Sie zu „Einstellungen" → „Verknüpfungen".
3. Öffnen Sie den Bereich „CalDAV-Kalender" und klicken Sie auf „Verbindung hinzufügen".

2. Verbindungstyp wählen

Wählen Sie, wie Ihr Kalender angebunden werden soll:

• CalDAV – Vollzugriff per CalDAV-Konto (empfohlen, falls Ihr Anbieter CalDAV unterstützt).
• ICS-Feed – Abonnement einer öffentlichen bzw. geschützten Kalender-URL (.ics / webcal).

CalDAV-Konto

Feld	Beschreibung
Bezeichnung	Frei wählbarer Name für diese Verbindung.
Server-URL	Die CalDAV-Adresse Ihres Anbieters (z. B. bei Nextcloud https://<ihr-server>/remote.php/dav/).
Benutzername	Ihr Benutzername beim CalDAV-Anbieter.
Passwort	Ihr Passwort bzw. das app-spezifische Passwort.

tip

Die meisten Anbieter verlangen ein app-spezifisches Passwort – Ihr normales Konto-Passwort funktioniert dort nicht. Wie Sie es erhalten, zeigt der nächste Abschnitt.

ICS-Feed

Feld	Beschreibung
Bezeichnung	Frei wählbarer Name für diese Verbindung.
ICS-/webcal-URL	Die Abo-URL Ihres Kalenders.
Benutzername (optional)	Nur falls der Feed durch Basic Auth geschützt ist.
Passwort (optional)	Nur falls der Feed durch Basic Auth geschützt ist.

3. Zugangsdaten beim Anbieter besorgen

Klicken Sie in der folgenden Übersicht auf den Reiter Ihres Kalender-Anbieters. Der Kasten darunter zeigt dann nur für diesen Anbieter die passende Adresse und den Weg zum app-spezifischen Passwort.

Apple iCloud

Apple iCloudVerbindungstyp: CalDAV

Feld	Wert
Server-URL	https://p24-caldav.icloud.com
Benutzername	Die E-Mail-Adresse Ihres Apple Accounts
Passwort	Ein app-spezifisches Passwort (siehe unten)

So erstellen Sie ein app-spezifisches Passwort

1. Melden Sie sich auf account.apple.com bei Ihrem Apple Account an.
2. Wählen Sie im Abschnitt „Anmelden und Sicherheit" den Punkt „App-spezifische Passwörter" aus.
3. Wählen Sie „App-spezifisches Passwort erstellen" aus und befolgen Sie die Schritte auf dem Bildschirm (als Name bietet sich „TeleButler" an).
4. Kopieren Sie das erzeugte Passwort und fügen Sie es in TeleButler in das Feld „Passwort" ein.

note

App-spezifische Passwörter setzen die Zwei-Faktor-Authentifizierung für Ihren Apple Account voraus. Das Passwort wird nur einmal angezeigt – notieren Sie es oder erstellen Sie bei Bedarf einfach ein neues.

tip

Ist bei einem Apple-Termin eine Wegzeit hinterlegt, berücksichtigt TeleButler diese zusätzlich zur eingestellten Vor- und Nachlaufzeit.

Nextcloud

NextcloudVerbindungstyp: CalDAV

Feld	Wert
Server-URL	https://<ihr-server>/remote.php/dav/
Benutzername	Ihr Nextcloud-Benutzername
Passwort	Ein App-Passwort (siehe unten)

So erstellen Sie ein App-Passwort

1. Melden Sie sich in Ihrer Nextcloud an und öffnen Sie oben rechts über Ihr Profilbild die „Einstellungen".
2. Wechseln Sie im persönlichen Bereich zu „Sicherheit".
3. Geben Sie unter „Geräte & Sitzungen" einen Namen ein (z. B. „TeleButler") und klicken Sie auf „Neues App-Passwort erstellen".
4. Kopieren Sie das erzeugte Passwort und fügen Sie es in TeleButler in das Feld „Passwort" ein.

note

Ist für Ihr Konto die Zwei-Faktor-Authentifizierung aktiv, ist ein App-Passwort zwingend erforderlich. Auch hier wird das Passwort nur einmal angezeigt.

Google Kalender

Google KalenderVerbindungstyp: ICS-Feed

Kein CalDAV bei Google

Google lässt an seiner CalDAV-Schnittstelle keine App-Passwörter zu, sondern nur die Anmeldung per OAuth 2.0. Ein CalDAV-Konto mit Google-Zugangsdaten wird deshalb mit „Anmeldedaten wurden abgelehnt." abgewiesen. Binden Sie Google-Kalender stattdessen über die geheime iCal-Adresse als ICS-Feed ein.

So finden Sie die geheime iCal-Adresse

1. Öffnen Sie calendar.google.com am Computer.
2. Klicken Sie oben rechts auf das Zahnrad und wählen Sie „Einstellungen".
3. Wählen Sie links unter „Einstellungen für meine Kalender" den gewünschten Kalender aus.
4. Kopieren Sie im Abschnitt „Kalender integrieren" die „Geheime Adresse im iCal-Format".
5. Wählen Sie in TeleButler den Verbindungstyp „ICS-Feed" und fügen Sie die Adresse in das Feld „ICS-/webcal-URL" ein. Benutzername und Passwort bleiben leer.

note

• Wer die geheime Adresse kennt, kann Ihren Kalender lesen. Geben Sie sie nicht weiter; bei Verdacht setzen Sie sie in denselben Einstellungen zurück.
• In Google Workspace kann Ihre Administration die Freigabe per iCal-Adresse gesperrt haben. Fehlt der Abschnitt, wenden Sie sich an Ihre IT.
• Google aktualisiert ICS-Feeds mit etwas Verzögerung – Änderungen erscheinen daher nicht immer sofort in TeleButler.

Microsoft 365 / Outlook

Microsoft 365 / OutlookVerbindungstyp: ICS-Feed

Kein CalDAV bei Microsoft

Microsoft 365 und Outlook.com bieten keine CalDAV-Schnittstelle an. Für diese Konten empfehlen wir das Outlook-Add-in – es ist die vollständigere Anbindung. Alternativ veröffentlichen Sie Ihren Kalender als ICS-Feed.

So veröffentlichen Sie Ihren Kalender als ICS-Feed

1. Öffnen Sie Outlook im Web (outlook.office.com) und wechseln Sie zum Kalender.
2. Öffnen Sie oben rechts die „Einstellungen" und gehen Sie zu „Kalender" → „Freigegebene Kalender".
3. Wählen Sie unter „Kalender veröffentlichen" den gewünschten Kalender sowie die Berechtigung „Alle Details anzeigen" aus und klicken Sie auf „Veröffentlichen".
4. Kopieren Sie den angezeigten ICS-Link (nicht den HTML-Link).
5. Wählen Sie in TeleButler den Verbindungstyp „ICS-Feed" und fügen Sie den Link in das Feld „ICS-/webcal-URL" ein. Benutzername und Passwort bleiben leer.

note

• Ihre Administration kann das Veröffentlichen von Kalendern gesperrt haben. Fehlt der Bereich, wenden Sie sich an Ihre IT.
• Der veröffentlichte Link ist ohne Anmeldung abrufbar – geben Sie ihn nicht weiter.
• Auch Microsoft aktualisiert veröffentlichte Kalender verzögert.

Anderer Anbieter

Anderer AnbieterVerbindungstyp: CalDAV, sonst ICS-Feed

1. Suchen Sie in der Dokumentation Ihres Anbieters nach der CalDAV-Adresse. Häufig ist das die Serveradresse mit einem DAV-Pfad (etwa /dav/ oder /caldav/) oder https://<ihr-server>/.well-known/caldav.
2. Prüfen Sie in den Sicherheitseinstellungen Ihres Kontos, ob der Anbieter App-Passwörter anbietet (auch „app-spezifisches Passwort" oder „Gerätepasswort" genannt). Bei aktiver Zwei-Faktor-Authentifizierung ist ein solches Passwort in der Regel zwingend.
3. Tragen Sie Server-URL, Benutzername und (App-)Passwort in TeleButler ein und klicken Sie auf „Verbindung testen".

tip

TeleButler ermittelt Ihre Kalender selbstständig. Es genügt daher meist die Basis-Adresse des CalDAV-Servers – der vollständige Pfad zu einem einzelnen Kalender funktioniert aber ebenfalls.

Unterstützt Ihr Anbieter kein CalDAV, veröffentlichen bzw. exportieren Sie den Kalender als ICS-Feed und binden Sie diese Adresse ein.

4. Verbindung testen und speichern

1. Klicken Sie auf „Verbindung testen". Bei Erfolg erscheint „Verbindung erfolgreich.".
   • „Anmeldedaten wurden abgelehnt." → Benutzername/Passwort prüfen (ggf. app-spezifisches Passwort verwenden).
   • „Server nicht erreichbar." / „Adresse nicht gefunden." → Server-URL bzw. ICS-URL prüfen.
2. Klicken Sie auf „Speichern".

5. Kalender auswählen

Nach dem Speichern sucht TeleButler die verfügbaren Kalender der Verbindung.

• Unter „Kalender" wählen Sie aus, welche Kalender dieser Verbindung synchronisiert werden sollen.
• Mit „Aktualisieren" können Sie die Kalenderliste neu einlesen, falls sie noch geladen wird.

6. Synchronisation

• TeleButler synchronisiert die ausgewählten Kalender anschließend regelmäßig und automatisch.
• Mit „Jetzt synchronisieren" stoßen Sie eine Synchronisierung sofort an.
• Der Status zeigt „Aktiv"/„Inaktiv" sowie „Zuletzt erfolgreich synchronisiert" an. Schlägt eine Synchronisierung fehl, wird der Grund angezeigt.

Aus den synchronisierten Terminen erstellt TeleButler selbstständig die passenden Telefonansagen.

Gut zu wissen

• Termine, die über CalDAV/ICS angelegt wurden, sind in TeleButler als „Mit CalDAV erstellt" gekennzeichnet und werden über diese Verbindung verwaltet (nicht direkt in TeleButler bearbeitet).
• Änderungen im Quellkalender können bis zur nächsten Synchronisierung etwas Zeit in Anspruch nehmen; mit „Jetzt synchronisieren" geht es sofort.
• „Verbindung löschen" entfernt die Verbindung und alle darüber synchronisierten Termine.
• Bei Problemen wenden Sie sich an den TeleButler-Support.