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

# Calendly

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

<img src="https://mintcdn.com/telli/B1-jcrEXZ5AA-uwV/images/integrations/telli-calendly-light.svg?fit=max&auto=format&n=B1-jcrEXZ5AA-uwV&q=85&s=9ef8a6d8fe8431c90aa9bca5b1a2bc08" className="block dark:hidden" alt="telli + Calendly integration" width="1200" height="360" data-path="images/integrations/telli-calendly-light.svg" />

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

## Überblick

Calendly wird pro Agent konfiguriert, damit jeder Workflow den passenden Eventtyp, Buchungslink und die passende 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 Calendly-Konto und ein Eventtyp
* Ein Calendly-API-Key mit mindestens `users:read`, `organizations:read`, `event_types:read`, `availability:read` und `scheduled_events:write`

<Note>
  Buchungen über die Calendly-API erfordern einen kostenpflichtigen Calendly-Tarif. Im Free-Tarif sind Buchungen über die API auch mit den
  richtigen API-Key-Berechtigungen nicht möglich.
</Note>

## Calendly in telli einrichten

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

  <Step title="Calendly-Zugangsdaten eintragen">
    Erstelle in Calendly einen API-Key mit mindestens `users:read`, `organizations:read`, `event_types:read`, `availability:read` und
    `scheduled_events:write`, hinterlege ihn und wähle den Calendly-Eventtyp, der für Buchungen genutzt werden soll.
  </Step>

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

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

## Buchungsfelder

Wenn du Calendly verbindest, kannst du Buchungsfelder konfigurieren, um die benutzerdefinierten Fragen deines Calendly-Eventtyps bei der Buchung automatisch auszufüllen.

Jedes Buchungsfeld ordnet eine Calendly-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 es

* telli nutzt für diesen Agenten den konfigurierten Calendly-Eventtyp
* Buchungsfelder werden während der Buchung automatisch aufgelöst
* Kontakteigenschaften und Konstanten werden ohne zusätzliches Gespräch ausgefüllt
* LLM-Parameter veranlassen den Agenten, fehlende Informationen vom Anrufer zu erfragen

<Note>
  Jede erforderliche benutzerdefinierte Frage deines Calendly-Eventtyps muss ein entsprechendes Buchungsfeld haben, sonst schlägt die
  Buchung fehl. Optionale Fragen ohne Zuordnung werden übersprungen.
</Note>