# Terminarten anlegen und verwalten

{/* 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>
Terminarten sind das Herz von Termin-Booking: Jede Terminart ist ein buchbares Angebot mit eigenem Link, eigener Dauer, eigenem Ort und eigenen Regeln. Diese Seite erklärt jeden Typ, jede Einstellung und jede Aktion.
</Lead>

Zum Anlegen und Bearbeiten von Terminarten brauchst du das Konfigurationsrecht für das Tool. Ohne dieses Recht siehst du den Bereich nur lesend.

## Terminart anlegen

Der Anlegen-Knopf im Bereich **Terminarten** öffnet ein Menü mit allen Typen:

<DefinitionList>
  <DefItem term="Einzeltermin">"1 Host trifft 1 Gast". Der Standard für Besichtigung, Beratung und Telefontermin.</DefItem>
  <DefItem term="Gruppentermin">"Mehrere Teilnehmer pro Slot (Open House)". Ein Zeitfenster nimmt mehrere Buchungen an, bis dein Teilnehmer-Limit erreicht ist.</DefItem>
  <DefItem term="Round-Robin">"Rotierende Hosts, Termine fair im Team verteilt". Verfügbar ab 2 Mitgliedern im Workspace. Details unten unter [Team-Terminarten](#team-terminarten).</DefItem>
  <DefItem term="Gemeinsamer Termin">"Mehrere Hosts gleichzeitig, 1 Gast". Ebenfalls ab 2 Mitgliedern. Details unten unter [Team-Terminarten](#team-terminarten).</DefItem>
  <DefItem term="Einmal-Link">Ein Buchungslink für genau eine Buchung, siehe [Einmal-Links](#einmal-links).</DefItem>
  <DefItem term="Terminumfrage">Mehrere Zeitvorschläge, Abstimmung, ein fixierter Termin. Eigene Anleitung: [Terminumfragen](/tools/booking/terminumfragen).</DefItem>
</DefinitionList>

## Vorlagen und ihre Voreinstellungen

Der erste Schritt im Editor bietet Vorlagen an, die typische Makler-Termine fertig vorkonfigurieren. Alles ist danach anpassbar.

| Vorlage | Dauer | Besonderheiten |
|---|---|---|
| Besichtigung | 30 Min | Puffer 15 Min davor und danach, Mindestvorlauf 4 Std, Horizont 30 Tage, Telefon Pflicht |
| Open House | 60 Min | 10 Plätze pro Slot, Mindestvorlauf 12 Std |
| Beratungsgespräch | 45 Min | Mindestvorlauf 1 Tag, Horizont 60 Tage |
| Telefontermin | 15 Min | Mindestvorlauf 2 Std, Horizont 14 Tage |
| Round-Robin | 45 Min | Team-Terminart mit rotierenden Hosts |
| Gemeinsamer Termin | 60 Min | Team-Terminart mit mehreren Hosts gleichzeitig |
| Eigene Terminart | frei | Leere Vorlage ohne Voreinstellungen |

## Der Editor

Nach der Vorlagen-Wahl führt der Editor durch vier Sektionen. Rechts läuft eine **Live-Vorschau** der Buchungsseite mit, die auch die Buchbarkeits-Regel zusammenfasst ("Buchbar frühestens X ... bis Y Tage im Voraus.").

<Steps>
  <Step title="Worum geht es?">
    Name der Terminart, optional ein verknüpftes Objekt (dann gilt: "Treffpunkt wird automatisch die Objektadresse") und die Gastgeber:in. Bei Team-Terminarten wählst du hier das Team; mit weniger als zwei Mitgliedern warnt der Editor, dass mindestens 2 nötig sind.
  </Step>
  <Step title="Wie lange dauert der Termin?">
    Dauer 15, 30, 45, 60 oder 90 Minuten oder eine eigene Dauer. Bei Open House legst du zusätzlich die maximale Gästezahl pro Slot fest.
  </Step>
  <Step title="Wo findet er statt?">
    Objektadresse, Eigener Ort, Telefon oder Video. Bei Video ohne festen Link erzeugt das Tool automatisch einen Meet- oder Teams-Link, sofern das Kalenderkonto der Gastgeber:in verbunden ist.
  </Step>
  <Step title="Wann können Gäste buchen?">
    Wahl des Zeitplans, oder der Schalter **Eigene Zeiten nur für diese Terminart** mit eigenem Inline-Wochenraster. Dazu der Mindestvorlauf (1 Std, 4 Std, 1 Tag oder 2 Tage) und der Buchungshorizont (2 Wochen, 30, 60 oder 90 Tage).
  </Step>
</Steps>

## Mehr Optionen

Hinter **Mehr Optionen** liegt der Feinschliff:

<DefinitionList>
  <DefItem term="Puffer davor / danach">Freigehaltene Minuten vor und nach jedem Termin, zum Beispiel für die Anfahrt.</DefItem>
  <DefItem term="Zeiten-Raster">In welchem Takt Startzeiten angeboten werden.</DefItem>
  <DefItem term="Link-Name">Der Teil nach `/book/` in der Adresse. Ist er schon vergeben, meldet das Tool: "Dieser Link ist bereits vergeben. Wähle einen anderen Link-Namen."</DefItem>
  <DefItem term="Beschreibung">Freitext, den Gäste auf der Buchungsseite sehen.</DefItem>
  <DefItem term="Telefonnummer">Nicht abfragen, Optional oder Pflicht. Pflicht empfiehlt sich für Besichtigungen und ist Voraussetzung für WhatsApp-Workflows.</DefItem>
  <DefItem term="Sichtbarkeit">Gelistet (erscheint auf deiner öffentlichen Übersicht `/book`) oder nur per Direktlink erreichbar (ungelistet).</DefItem>
  <DefItem term="Zusatzfragen">Bis zu 10 eigene Fragen im Buchungsformular: Kurztext, Langtext oder Auswahl, jede mit Pflicht-Schalter.</DefItem>
  <DefItem term="Hinweis nach der Buchung">Text, der auf der Bestätigungsseite erscheint, zum Beispiel Parkhinweise oder mitzubringende Unterlagen.</DefItem>
  <DefItem term="Max. Termine pro Tag">Tageslimit nur für diese Terminart; 0 bedeutet unbegrenzt.</DefItem>
  <DefItem term="Weiterleitung">Eine Adresse (https), auf die Gäste nach der Buchung geleitet werden, zum Beispiel eine Danke-Seite deiner Website.</DefItem>
  <DefItem term="Frei/Belegt-Regeln">Pro verbundenem Kalender-Feed ein Schalter, ob dessen belegte Zeiten diese Terminart blocken.</DefItem>
  <DefItem term="Aktiv">Der Schalter, der die Terminart buchbar macht oder pausiert.</DefItem>
</DefinitionList>

## Karten und Aktionen

Jede Terminart erscheint als Karte mit Farb-Kachel, dem Link (`/book/link-name`, bei ungelisteten mit dem Zusatz "· ungelistet"), dem **Aktiv**-Schalter, Dauer, bei Open House "Open House · max. N", dem verknüpften Objektnamen, der Zahl anstehender Termine ("N anstehend") und der internen Notiz. Ein pausierter Eintrag zeigt "Terminart pausiert."

<Warning title="Warn-Punkt an der Karte">
Ein Warn-Punkt mit dem Text "Der Zeitplan dieser Terminart hat keine verfügbaren Zeiten." bedeutet: Der zugewiesene Zeitplan hat aktuell kein einziges buchbares Fenster. Woran das liegen kann, steht in der [Fehlerbehebung](/tools/booking/troubleshooting).
</Warning>

Die Reihenfolge der Karten änderst du per Ziehen; sie gilt auch auf deiner öffentlichen Übersicht ("Reihenfolge gespeichert. Gilt auch auf /book."). Das Menü jeder Karte bietet:

- **Buchungsseite ansehen**: öffnet die öffentliche Seite in einem neuen Tab.
- **Bearbeiten**: öffnet den Editor.
- **Zur Website hinzufügen**: das Einbetten-Fenster, siehe [Buchungsseite](/tools/booking/buchungsseite#einbetten-zur-website-hinzufügen).
- **Interne Notiz**: "Nur für dein Team sichtbar, nie auf der Buchungsseite."
- **Sprache der Buchungsseite**: Workspace-Standard, Deutsch oder English. Gilt für Seite, Bestätigung und Gast-Mails dieser Terminart.
- **Nicht listen / Listen**: nimmt die Terminart von der öffentlichen Übersicht oder setzt sie wieder darauf. Der Direktlink funktioniert weiter.
- **Einmal-Link erstellen**: siehe [Einmal-Links](#einmal-links).
- **Duplizieren**: legt eine Kopie an, sicherheitshalber pausiert ("Kopie angelegt (pausiert)").
- **Löschen**: siehe unten.

<Callout tone="warning" title="Löschen hat Regeln">
Der Löschen-Dialog warnt: Der Buchungslink und alle offenen Einmal-Links dieser Terminart erlöschen; vergangene Termine bleiben erhalten. Gibt es noch bestätigte zukünftige Termine, blockt das Tool mit der Meldung "Es gibt noch bestätigte zukünftige Termine. Sage diese zuerst ab." Erst absagen, dann löschen. So kann kein Gast einen bestätigten Termin verlieren, ohne informiert zu werden.
</Callout>

## Einmal-Links

Ein **Einmal-Link** ist ein Buchungslink, der nach genau einer Buchung erlischt. Ideal, wenn du einer konkreten Person einen Termin anbieten willst, ohne die Terminart öffentlich zu listen; Einmal-Links funktionieren auch für ungelistete Terminarten.

<Steps>
  <Step title="Erstellen">
    Über das Karten-Menü (**Einmal-Link erstellen**) oder den Tab **Einmal-Links** im Terminarten-Bereich. Du kannst eine interne Notiz (zum Beispiel den Namen des Interessenten) und ein optionales Ablaufdatum mitgeben.
  </Step>
  <Step title="Sofort kopieren">
    Der Klartext-Link wird genau einmal angezeigt: "Kopiere den Link jetzt. Aus Sicherheitsgründen wird er kein zweites Mal angezeigt."
  </Step>
  <Step title="Status verfolgen">
    Die Liste im Tab **Einmal-Links** zeigt pro Link den Status: **Offen**, **Verwendet am ...** oder **Abgelaufen**.
  </Step>
</Steps>

<Info title="Gleichzeitige Nutzung">
Öffnen zwei Personen denselben Einmal-Link, bucht nur die erste erfolgreich. Die zweite sieht: "Dieser Buchungslink wurde bereits verwendet oder ist abgelaufen."
</Info>

## Zeiten anbieten

Mit **Zeiten anbieten** (im **Teilen**-Menü einer Terminart) drehst du den Spieß um: Statt den Gast suchen zu lassen, schlägst du konkrete Zeiten vor.

1. Wähle bis zu **5 freie Zeiten** aus den echten freien Slots der Terminart. Angeboten wird nur, was wirklich buchbar ist.
2. Das Tool erzeugt einen fertigen E-Mail-Text: Jede Zeit ist direkt verlinkt, ein Klick wählt sie auf der Buchungsseite vor. Am Ende steht der normale Buchungslink für den Fall, dass keine der Zeiten passt.
3. **E-Mail-Text kopieren**, in deine Mail einfügen, abschicken.

Zeigt das Fenster "Aktuell gibt es keine freien Zeiten.", prüfe Zeitplan und Kalender-Verbindung, siehe [Fehlerbehebung](/tools/booking/troubleshooting).

## Team-Terminarten

Ab zwei Mitgliedern im Workspace stehen zwei Team-Typen bereit. Beide brauchen mindestens **2 einsatzfähige Mitglieder**; sonst zeigt die Buchungsseite bewusst keine Slots.

<Comparison>
  <CompareRow label="Prinzip" a="Round-Robin: rotierende Hosts, Termine werden fair im Team verteilt" b="Gemeinsamer Termin: mehrere Hosts sitzen gleichzeitig im selben Termin" />
  <CompareRow label="Wann ist eine Zeit frei?" a="Sobald mindestens ein Mitglied frei ist" b="Nur wenn alle gewählten Mitglieder frei sind" />
  <CompareRow label="Wen blockt der Termin?" a="Nur das Mitglied, das den Termin bekommt" b="Alle beteiligten Mitglieder" />
  <CompareRow label="Typischer Einsatz" a="Eingehende Beratungs- oder Bewertungsanfragen aufs Team verteilen" b="Übergabe-, Notar- oder Entscheider-Termine mit mehreren Kolleg:innen" />
</Comparison>

Der Gast bucht in beiden Fällen das Team, nicht eine Person; wer den Termin bekommt, steht in der Bestätigung. Manuelles Eintragen von Terminen ist für Team-Terminarten nicht möglich, siehe [Termine](/tools/booking/termine#termin-manuell-eintragen).

## Weiterführend

Zurück zur Übersicht: [Termin-Booking](/tools/booking). Nächste Seite: [Terminumfragen](/tools/booking/terminumfragen). Wie Gäste die Terminart erleben: [Buchungsseite](/tools/booking/buchungsseite).
