# Fehlerbehebung

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/booking/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
Wenn etwas nicht wie erwartet funktioniert, findest du hier die häufigsten Ursachen und ihre Lösung, sortiert nach Symptom.
</Lead>

## Buchbarkeit

<Faq>
  <FaqItem q="Eine Terminart zeigt keine buchbaren Zeiten (Warn-Punkt an der Karte)">
    Der Warn-Punkt "Der Zeitplan dieser Terminart hat keine verfügbaren Zeiten." hat meist eine dieser Ursachen. Prüfe sie in dieser Reihenfolge:
    1. **Zeitplan leer?** Der zugewiesene Zeitplan hat keine Zeitfenster, oder eine Datums-Ausnahme blockt den Zeitraum. Prüfe das Wochenraster unter [Verfügbarkeit](/tools/booking/verfuegbarkeit).
    2. **Vorlauf und Horizont?** Ein langer Mindestvorlauf plus kurzer Buchungshorizont kann alle Slots ausschließen (Beispiel: Vorlauf 2 Tage, Horizont 2 Wochen, aber nur ein Fenster pro Woche).
    3. **Limits erreicht?** Tageslimit der Terminart, oder Termin-Limits pro Tag und Woche unter Verfügbarkeit > Erweitert.
    4. **Feiertag?** Aktivierte Feiertags-Blockierung nimmt betroffene Tage raus.
    5. **Kalender blockt?** Ein verbundener Kalender mit vielen belegten Zeiten (auch ganztägige Einträge) blockt die Slots. Prüfe die Frei/Belegt-Regeln der Terminart unter Mehr Optionen.
  </FaqItem>
  <FaqItem q='"Diese Zeit ist bereits vergeben."'>
    Die gewählte Zeit wurde inzwischen gebucht, auch beim manuellen Eintragen bleibt sie ausgeschlossen. Wähle eine andere Zeit. Doppelbuchungen sind technisch ausgeschlossen; Gäste sehen in dem Fall: "Diese Zeit wurde gerade von jemand anderem gebucht. Bitte wählen Sie eine andere Zeit."
  </FaqItem>
  <FaqItem q='"Dieser Link ist bereits vergeben. Wähle einen anderen Link-Namen."'>
    Jeder Link-Name existiert pro Workspace nur einmal, auch pausierte und ungelistete Terminarten belegen ihren Namen. Wähle einen anderen Link-Namen im Terminart-Editor unter Mehr Optionen.
  </FaqItem>
  <FaqItem q="Ein Einmal-Link funktioniert nicht mehr">
    Einmal-Links erlöschen nach genau einer Buchung oder mit Erreichen ihres Ablaufdatums. Der Gast sieht dann: "Dieser Buchungslink wurde bereits verwendet oder ist abgelaufen." Erstelle einfach einen neuen Einmal-Link, siehe [Terminarten](/tools/booking/terminarten#einmal-links).
  </FaqItem>
  <FaqItem q="Eine Team-Terminart zeigt keine Slots">
    Round-Robin und Gemeinsamer Termin brauchen mindestens **2 einsatzfähige Mitglieder**. Mit weniger zeigt die Buchungsseite bewusst keine Zeiten an. Prüfe die Team-Auswahl im Terminart-Editor und ob die Mitglieder Zeitpläne mit buchbaren Fenstern haben.
  </FaqItem>
</Faq>

## Löschen und Aufräumen

<Faq>
  <FaqItem q='Ein Zeitplan lässt sich nicht löschen ("Dieser Zeitplan wird noch von Terminarten verwendet.")'>
    Weise den betroffenen Terminarten im Editor zuerst einen anderen Zeitplan zu; danach klappt das Löschen. Welche das sind, verrät das Badge "Aktiv auf N Terminarten" am Zeitplan.
  </FaqItem>
  <FaqItem q="Eine Terminart lässt sich nicht löschen (bestätigte zukünftige Termine)">
    Das ist Absicht: "Es gibt noch bestätigte zukünftige Termine. Sage diese zuerst ab." Kein Gast soll einen bestätigten Termin verlieren, ohne informiert zu werden. Sage die Termine im [Termine-Bereich](/tools/booking/termine) ab (die Gäste bekommen automatisch Bescheid) und lösche die Terminart danach.
  </FaqItem>
</Faq>

## Kalender-Synchronisierung

<Faq>
  <FaqItem q='Banner: "Die Kalender-Synchronisierung ist gestört. Belegte Zeiten werden gerade nicht geblockt."'>
    Öffne **Verfügbarkeit > Kalender** und prüfe den Feed-Status (**Aktiv**, **Fehler**, **Wartet**, **Getrennt**). Bei **Fehler** hilft oft **Jetzt synchronisieren**; bleibt der Fehler, ist die iCal-Adresse abgelaufen oder im Kalender-Dienst zurückgezogen. Kopiere dann eine frische private iCal-Adresse und verbinde neu. Solange das Banner steht, können Zeiten doppelt vergeben werden, die in deinem externen Kalender belegt sind.
  </FaqItem>
  <FaqItem q="Die Ein-Klick-Anmeldung mit Google oder Microsoft schlägt fehl">
    Die Fehlermeldungen im Überblick: "Anmeldung abgebrochen. Dein Kalender wurde nicht verbunden." (du hast den Dialog geschlossen, einfach erneut versuchen), "Die Anmeldung ist abgelaufen. Bitte erneut verbinden." (zu viel Zeit im Anmelde-Dialog) und "Verbindung fehlgeschlagen. Bitte erneut versuchen." Nach Erfolg meldet das Tool: "Kalenderkonto verbunden. Belegte Zeiten blocken ab jetzt."
  </FaqItem>
  <FaqItem q='"Die Ein-Klick-Anmeldung ist nicht konfiguriert."'>
    Die Anmeldung per Google- oder Microsoft-Konto steht in deiner Umgebung noch nicht bereit; sie kommt, sobald unsere App von Google beziehungsweise Microsoft verifiziert ist. Nutze bis dahin den iCal-Weg: Er verbindet jeden Kalender (auch iCloud) über die private Kalender-Adresse und blockt belegte Zeiten genauso zuverlässig. Anleitung: [Verfügbarkeit und Kalender](/tools/booking/verfuegbarkeit#kalender).
  </FaqItem>
</Faq>

## Nachrichten und Workflows

<Faq>
  <FaqItem q="Ein WhatsApp-Workflow wurde übersprungen">
    Das Protokoll nennt den Grund im Klartext. Die häufigsten: Der Gast hat **keine Telefonnummer** hinterlassen (stelle die Telefon-Abfrage der Terminart auf Pflicht), oder es gab **kein aktives 24-Stunden-Gesprächsfenster** (der Gast hat euch zuletzt vor mehr als 24 Stunden auf WhatsApp geschrieben). Übersprungene Läufe kosten keine Credits.
  </FaqItem>
  <FaqItem q='Ein WhatsApp-Workflow ist fehlgeschlagen ("Credit-Guthaben reicht nicht für den WhatsApp-Versand")'>
    Das Credit-Guthaben deines Workspace war beim Sendezeitpunkt leer. Lade Guthaben auf und nutze **Erneut senden** am fehlgeschlagenen Lauf im Protokoll.
  </FaqItem>
  <FaqItem q="Termin-Mails kommen nicht an">
    Zwei Stellschrauben prüfen: Erstens den Schalter **E-Mail an Gastgeber:in bei Buchung und Absage** in den [Einstellungen](/tools/booking/einstellungen) (betrifft nur die interne Host-Mail). Zweitens unter [Workflows](/tools/booking/workflows), ob der zuständige Workflow **pausiert** ist; pausierte Workflows überspringen offene Läufe. Die Bestätigungs- und Absage-Mail an Gäste ist ein fester System-Workflow und immer aktiv; bitte den Gast in dem Fall, den Spam-Ordner zu prüfen.
  </FaqItem>
</Faq>

## Zugriff und Limits

<Faq>
  <FaqItem q="Ein Gast sieht eine Fehlermeldung beim Buchen">
    "Zu viele Anfragen. Bitte versuchen Sie es in ein paar Minuten erneut." ist das Anfrage-Limit gegen automatisierte Zugriffe; nach kurzer Wartezeit geht es weiter. "Diese Buchungsseite ist nicht mehr verfügbar." bedeutet: Die Terminart ist pausiert oder gelöscht; prüfe den Aktiv-Schalter.
  </FaqItem>
  <FaqItem q='"Dieses Tool ist im Test-Zeitraum nicht enthalten."'>
    Termin-Booking ist im Trial bewusst gesperrt, weil deine öffentlichen Buchungslinks nach dem Test ins Leere führen würden. Mit dem Wechsel auf den Compact-Plan (oder höher) steht das Tool sofort bereit.
  </FaqItem>
  <FaqItem q='"Dir fehlt die Berechtigung dafür."'>
    Die Aktion braucht ein Recht, das dein Konto nicht hat: Terminarten, Zeitpläne, Workflows und Routing verlangen das Konfigurationsrecht, Kontakt-Anlage und CSV-Import das Recht, Kontakte anzulegen. Ein Admin deines Workspace kann die Rechte anpassen.
  </FaqItem>
</Faq>

## Weiterführend

Zurück zur Übersicht: [Termin-Booking](/tools/booking). Grundlagen von vorn: [Erste Schritte](/tools/booking/erste-schritte).