> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bookingtime

> Verbinde bookingtime mit telli, damit Agenten während Anrufen Verfügbarkeiten prüfen und Termine direkt in deinen bookingtime Kalender buchen können.

## Überblick

telli wird als App in deine bookingtime Organisation installiert. Danach meldest du dich einmal aus telli heraus bei
bookingtime an, damit telli bestätigen kann, welche Organisationen dir gehören. Anschließend kann ein Agent deine
aktuellen Verfügbarkeiten lesen und Termine direkt in deinen bookingtime Kalender buchen, während er noch mit dem
Anrufer telefoniert.

bookingtime wird einmal pro telli-Konto verbunden. Jeder Agent wählt danach, in welche deiner verbundenen
Organisationen er bucht und welche Terminart er bucht, sodass verschiedene Agenten Verschiedenes buchen können.

## Bevor du beginnst

* Ein telli-Agent, der Termine buchen soll
* Eine bookingtime Organisation mit Administratorzugriff auf den **Store**
* Mindestens eine aktive Terminvorlage in bookingtime unter **Einstellungen → Terminvorlagen**
* Den telli-Installationsschlüssel, den du beim Einrichten der Integration von telli bekommst

## Die telli-App in bookingtime installieren

<Steps>
  <Step title="Store öffnen">
    Gehe in bookingtime zu **Store → Apps** und wähle oben rechts **Mit Schlüssel installieren**.

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/01-store-apps.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=1cc5f23932434272c0b1c101953cfd0a" alt="Der Bereich Apps im bookingtime Store mit der Schaltfläche Mit Schlüssel installieren oben rechts" width="2880" height="1440" data-path="images/integrations/bookingtime/01-store-apps.png" />
  </Step>

  <Step title="Installationsschlüssel eingeben">
    Füge den 64-stelligen Installationsschlüssel ein, den du von telli erhalten hast, und wähle **Weiter**.

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/02-install-with-key.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=08b7191d58119d009fef3eed71bf2949" alt="Der Dialog Mit Schlüssel installieren in bookingtime mit eingegebenem Installationsschlüssel" width="2880" height="1440" data-path="images/integrations/bookingtime/02-install-with-key.png" />
  </Step>

  <Step title="Berechtigungen prüfen">
    bookingtime zeigt dir vor der Installation, was die App darf. Klappe **Berechtigungen** auf, um die vollständige
    Liste zu sehen. telli fordert genau den Zugriff an, der zum Lesen von Verfügbarkeiten und zum Buchen nötig ist,
    und sonst nichts.

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/03-confirm-permissions.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=e6551d7f675f5cb0d0e719bb42457f45" alt="Die Details der telli-App in bookingtime mit den angeforderten Berechtigungen und der Schaltfläche Installieren" width="2880" height="1440" data-path="images/integrations/bookingtime/03-confirm-permissions.png" />

    | Berechtigung                    | Wofür telli sie braucht                                           |
    | ------------------------------- | ----------------------------------------------------------------- |
    | Organisation ansehen            | Bestätigen, welche Organisation du verbindest                     |
    | Gebuchte Terminvorlage ansehen  | Die Terminarten auflisten, aus denen du wählen kannst             |
    | Datum und Uhrzeit ansehen       | Buchbare Zeitfenster lesen                                        |
    | Termine ansehen                 | Einen Termin nach dem Buchen lesen                                |
    | Termine buchen                  | Den Termin während des Anrufs anlegen                             |
    | Termine stornieren              | Einen von einem Agenten gebuchten Termin stornieren               |
    | Termine verschieben             | Einen von einem Agenten gebuchten Termin verlegen                 |
    | Termine bearbeiten              | Die Details eines von einem Agenten gebuchten Termins korrigieren |
    | Stornierungen rückgängig machen | Einen versehentlich stornierten Termin wiederherstellen           |
    | Kunden ansehen                  | Den Anrufer einem bereits vorhandenen Kunden zuordnen             |
    | Kunden anlegen                  | Einen Kundendatensatz anlegen, wenn der Anrufer neu für dich ist  |
  </Step>

  <Step title="Installieren">
    Wähle **Installieren**. Die App erscheint sofort in deiner App-Liste.

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/04-installed.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=f4846e1fbbf8b8858eff092a0837d0ab" alt="Die installierte telli-App in bookingtime mit ihrer Beschreibung und einer Schaltfläche zum Deinstallieren" width="2880" height="1440" data-path="images/integrations/bookingtime/04-installed.png" />
  </Step>
</Steps>

<Note>
  Installiere die App in jeder bookingtime Organisation, in die telli buchen soll. Ein Agent kann nur in
  Organisationen buchen, in denen die App installiert ist und die du im nächsten Schritt verbunden hast.
</Note>

## bookingtime in telli verbinden

<Steps>
  <Step title="Verbindung starten">
    Gehe in telli zu **Einstellungen → Integrationen**, öffne **bookingtime** und wähle **Verbinden**.
  </Step>

  <Step title="Bei bookingtime anmelden">
    bookingtime bittet dich, dich mit deinem bookingtime Login anzumelden. So bestätigt telli, welche Organisationen
    dir gehören: telli sieht ausschließlich die Organisationen, in denen das Konto, mit dem du dich anmeldest,
    Mitglied ist.
  </Step>

  <Step title="Organisationen prüfen">
    telli listet die Organisationen auf, die die Verbindung bestätigt hat, und bringt dich zurück zur
    Integrationsseite. Wenn du mehreren Organisationen angehörst, werden alle verbunden und du wählst pro Agent
    zwischen ihnen.
  </Step>
</Steps>

<Note>
  Wenn bookingtime meldet, dass dein Benutzer keinen Zugriff hat, prüfe, ob die telli-App in dieser Organisation
  installiert ist und ob dein bookingtime Login Mitglied dieser Organisation ist.
</Note>

## Einen Agenten einrichten

<Steps>
  <Step title="Agenten öffnen">
    Öffne den Agenten, den du konfigurieren möchtest, und wähle unter **Kalender-Integration** die Option
    **bookingtime**.
  </Step>

  <Step title="Organisation wählen">
    Wähle die bookingtime Organisation, in die dieser Agent buchen soll, aus den von dir verbundenen Organisationen.
  </Step>

  <Step title="Terminart wählen">
    telli lädt die in dieser Organisation verfügbaren Terminarten. Wähle die Terminart, die dieser Agent buchen
    soll. Wenn deine Organisation nur eine hat, wählt telli sie für dich aus.

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/05-telli-configuration-light.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=cfe83e32772b7d5bd2942ab1ce56da48" className="block dark:hidden" alt="Die bookingtime Kalender-Integration in telli mit ausgewählter Organisation und Terminart" width="2880" height="1440" data-path="images/integrations/bookingtime/05-telli-configuration-light.png" />

    <img src="https://mintcdn.com/telli/FmwMfjEFaNmU_Yhb/images/integrations/bookingtime/05-telli-configuration-dark.png?fit=max&auto=format&n=FmwMfjEFaNmU_Yhb&q=85&s=6c4cffeb5426cc98031f1cc3aca2bc78" className="hidden dark:block" alt="Die bookingtime Kalender-Integration in telli mit ausgewählter Organisation und Terminart" width="2880" height="1440" data-path="images/integrations/bookingtime/05-telli-configuration-dark.png" />
  </Step>

  <Step title="Agenten speichern">
    Speichere den Agenten, damit telli bookingtime während Anrufen verwendet.
  </Step>
</Steps>

## So funktioniert das Buchen

* Der Agent liest buchbare Zeitfenster für die ausgewählte Terminart für die nächsten 14 Tage
* Wenn der Anrufer eine Zeit wählt, bucht telli sie noch während des Anrufs in deinen bookingtime Kalender
* Der Termin erscheint sofort in bookingtime, und bookingtime versendet seine übliche Bestätigung

### Kundendatensätze

Jeder bookingtime Termin gehört zu einem Kunden. Beim Buchen verwendet telli den Kunden wieder, den es für diesen
Kontakt zuvor angelegt hat, oder ordnet ihn über die E-Mail-Adresse einem Kunden zu, den du bereits hast. Nur wenn
beides nicht zutrifft, legt telli einen neuen Kundendatensatz an.

### E-Mail-Adressen

bookingtime benötigt eine E-Mail-Adresse, um dem Kunden den Termin zu bestätigen. Wenn telli noch keine für den
Kontakt hat, fragt der Agent den Anrufer vor dem Buchen danach.