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

# Zeeg

> Verbinde Zeeg mit telli, damit Agenten Verfügbarkeiten prüfen, Meetings buchen und Zeeg-Buchungsfragen während Anrufen ausfüllen können.

<img src="https://mintcdn.com/telli/iDG677uRz9oNXPxK/images/integrations/telli-zeeg-light.svg?fit=max&auto=format&n=iDG677uRz9oNXPxK&q=85&s=077008a4ba1ca0694dbd4a4d26e62f1f" className="block dark:hidden" alt="telli + Zeeg integration" width="1200" height="360" data-path="images/integrations/telli-zeeg-light.svg" />

<img src="https://mintcdn.com/telli/iDG677uRz9oNXPxK/images/integrations/telli-zeeg-dark.svg?fit=max&auto=format&n=iDG677uRz9oNXPxK&q=85&s=fbd48eb390b763b9dd09f273ad68c0d9" className="hidden dark:block" alt="telli + Zeeg integration" width="1200" height="360" data-path="images/integrations/telli-zeeg-dark.svg" />

## Überblick

Zeeg wird pro Agent konfiguriert, damit jeder Workflow die passende Scheduling Page, Buchungs-URL, Dauer und Buchungsfeld-Zuordnung nutzen kann.

Das ist hilfreich, wenn unterschiedliche Agenten unterschiedliche Meetingtypen buchen oder an verschiedene Teams routen sollen.

## Bevor du beginnst

* Ein telli-Agent, der Termine buchen soll
* Ein Zeeg-Konto mit einer aktiven Scheduling Page
* Ein Zeeg-API-Token aus [Account Settings > API](https://app.zeeg.me/account/settings/api-access)
* Ein Zeeg-Tarif, der Verfügbarkeitsabfragen und programmatische Buchungen über die API erlaubt

Nutze ein Zeeg-API-Token mit möglichst wenigen Berechtigungen. Für telli braucht der Token Zugriff auf:

| Scope         | Warum telli ihn braucht                                                             |
| ------------- | ----------------------------------------------------------------------------------- |
| `events:read` | Scheduling Pages und benutzerdefinierte Fragen lesen                                |
| `timetable`   | Verfügbare Zeitfenster für die ausgewählte Scheduling Page lesen                    |
| `booking`     | Buchungen schreiben, indem das gebuchte Zeeg-Event während des Anrufs erstellt wird |

<Note>
  Die Zeeg-API-Endpunkte für Verfügbarkeit und Buchung erfordern einen aktiven kostenpflichtigen Tarif.
</Note>

## Zeeg in telli einrichten

<Steps>
  <Step title="Agent öffnen">Öffne den Agenten, den du in telli konfigurieren willst.</Step>
  <Step title="Zeeg auswählen">Wähle in **Kalender-Integration** die Option **Zeeg**.</Step>

  <Step title="Zeeg-Zugangsdaten eintragen">
    Erstelle in Zeeg einen API-Token mit `events:read`, `timetable` zum Lesen von Verfügbarkeit und `booking` zum Schreiben von Buchungen.
    Hinterlege ihn dann in telli. telli lädt die Scheduling Pages, auf die dieser Token zugreifen darf.
  </Step>

  <Step title="Scheduling Page auswählen">
    Wähle die Zeeg Scheduling Page, die der Agent für Verfügbarkeitsabfrage und Buchung verwenden soll.
  </Step>

  <Step title="Buchungsfelder konfigurieren">
    Öffne die Einstellungen der ausgewählten Scheduling Page und ordne die Buchungsfragen zu, die telli automatisch ausfüllen soll.
  </Step>

  <Step title="Agent speichern">Speichere den Agenten, damit telli dieses Zeeg-Setup bei Anrufen nutzen kann.</Step>
</Steps>

## Buchungsfelder

Wenn du Zeeg verbindest, kannst du Buchungsfelder konfigurieren, um die benutzerdefinierten Fragen deiner Zeeg Scheduling Page bei der Buchung automatisch auszufüllen.

Jedes Buchungsfeld ordnet eine Zeeg-Frage einer Wertquelle zu.

| Typ                    | Beschreibung                                                                                   | Beispiel                        |
| ---------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------- |
| **Konstante**          | Ein fester Wert, immer gleich                                                                  | Markenname, Firmenname          |
| **Kontakteigenschaft** | Wird aus den Kontaktdaten aufgelöst. Falls nicht verfügbar, fragt der Agent den Anrufer danach | Telefonnummer, E-Mail, Vorname  |
| **Systemvariable**     | Wird aus internen Systemdaten über einen Pfadausdruck aufgelöst                                | Kontakt-ID, Zeitzone            |
| **LLM-Parameter**      | Wird vom Agenten während des Gesprächs erfragt                                                 | Termingrund, bevorzugte Sprache |

## So funktioniert die Buchung

* telli lässt dich pro Agent eine Zeeg Scheduling Page auswählen
* Während Anrufen prüft der Agent verfügbare Zeitfenster für die ausgewählte Seite
* Wenn der Anrufer ein Zeitfenster auswählt, bucht telli das Zeeg-Event mit den erfassten Anruferdaten
* Buchungsfelder werden während der Buchung automatisch ausgefüllt
* Kontakteigenschaften und Konstanten werden ohne zusätzliches Gespräch verwendet
* LLM-Parameter veranlassen den Agenten, fehlende Informationen vom Anrufer zu erfragen

<Note>
  Jede erforderliche benutzerdefinierte Frage deiner Zeeg Scheduling Page muss ein entsprechendes Buchungsfeld haben, sonst schlägt die
  Buchung fehl. Optionale Fragen ohne Zuordnung werden übersprungen.
</Note>