Zum Hauptinhalt springen
Variablen helfen dir dabei, die Begrüßung, den Prompt und Benachrichtigungen deines Agenten mit echten Daten zu personalisieren. Diese Seite erklärt, woher Variablen kommen, wann sie verfügbar werden und wo du sie einsetzen kannst. Wenn du den vollständigen Ablauf sehen möchtest, inklusive des Unterschieds zwischen Live-Tool-Inputs und Werten nach dem Anruf, lies Gesprächsdatenfluss.

Die vier Quellen

QuelleWann verfügbarBeispielvariablen
KontaktdatenBevor der Anruf startet (wenn der Anrufer einem Kontakt zugeordnet wird){{contact.first_name}}, {{contact.email}}, {{contact.phone_number}}
Pre-Call-KontextBevor der Anruf startet (über Dynamic Context aus deiner API geladen){{account_tier}}, {{open_tickets}}, {{last_order_status}}
Eingebaute SystemvariablenImmer verfügbar{{current_datetime}}, {{timezone}}, {{direction}}, {{agent_uuid}}
Post-Call-InsightsNachdem der Anruf endet (KI extrahiert aus dem Transkript){{dyn_appointment_date}}, {{dyn_issue_summary}}, {{dyn_caller_sentiment}}

Kontaktvariablen

Diese stehen automatisch zur Verfügung, wenn die Telefonnummer des Anrufers mit einem Kontakt in deinem System übereinstimmt.
Hi {{contact.first_name | default("there")}}, thanks for calling.
Nutze | default("fallback"), damit die Begrüßung auch dann funktioniert, wenn kein Kontakt gefunden wird. Verfügbare Felder: contact.first_name, contact.last_name, contact.full_name, contact.email, contact.phone_number

Pre-Call-Kontext (Dynamic Context)

Profi Die Plattform holt diese Daten vor dem Start des Gesprächs aus deiner API. Konfiguriere den Endpunkt unter Anrufablauf → Vor dem Anruf. Deine API erhält die Nummer des Anrufers und die Agent-ID und liefert JSON zurück. Jedes Feld in der Antwort wird zu einer Variable.
{% if account_tier == "enterprise" %}
This is a priority customer. Provide white-glove support.
{% else %}
Standard support flow.
{% endif %}
Dynamic Context einrichten →

Eingebaute Systemvariablen

Diese sind in jedem Gespräch verfügbar:
VariableInhalt
{{current_datetime}}Aktuelles Datum und Uhrzeit
{{timezone}}Die konfigurierte Zeitzone des Agenten
{{direction}}inbound oder outbound
{{medium}}Kanal des Gesprächs, etwa voice, web oder test
{{agent_uuid}}Die eindeutige ID des Agenten
{{agent_number}}Die Telefonnummer des Agenten
{{contact_number}}Die Telefonnummer des Anrufers

Variablen aus der Post-Call-Analytik

Nach dem Anruf in Benachrichtigungen nach dem Anruf verfügbar. Die KI extrahiert sie aus dem Transkript. Tippe {{dyn_ gefolgt von einem beschreibenden Namen:
{{dyn_appointment_date}}  → AI findet das genannte Datum
{{dyn_issue_summary}}     → AI fasst das Problem zusammen
{{dyn_next_steps}}        → AI erkennt vereinbarte nächste Schritte
Diese funktionieren nur in Benachrichtigungs-E-Mail-Vorlagen, nicht im Prompt des Agenten (der Anruf ist dann bereits vorbei).

Wo du Variablen verwenden kannst

OrtKontaktPre-CallSystemPost-Call
BegrüßungsnachrichtJaJaJaNein
PromptJaJaJaNein
Notification emailsNur KundenfelderNeinNur GesprächsfelderJa
Benachrichtigungs-E-Mails verwenden einen eigenen Post-Call-Kontext. Sie erhalten keine Live-Call-Variablen wie {{contact.first_name}}, Dynamic-Context-Felder, {{current_datetime}} oder {{timezone}} direkt. Nutze Benachrichtigungsvariablen wie {{customer_name}}, {{customer_email}}, {{customer_number}}, {{conversation_date}}, {{conversation_direction}}, {{conversation_summary}} und {{dyn_*}}.

Syntax

Variablen nutzen Jinja-Syntax: {{ variable_name }} Filter:
  • {{ contact.first_name | default("there") }} - Fallback-Wert
  • {{ current_datetime | datetime("%H:%M") }} - Datumsformatierung
Bedingungen:
{% if direction == "outbound" %}
You are making an outbound call to {{contact.first_name}}.
{% else %}
A customer is calling in.
{% endif %}

Variablen debuggen

Wenn eine Variable nicht funktioniert:
  1. Prüfe die Quelle - wurde der Kontakt gematcht? Liefert Dynamic Context Daten?
  2. Prüfe die Schreibweise - Variablennamen sind case-sensitiv
  3. Prüfe den Fallback - nutze | default("...") für möglicherweise leere Variablen
  4. Teste mit verschiedenen Szenarien - inbound vs outbound, bekannte vs unbekannte Anrufer

Nächste Schritte

Gesprächsdatenfluss

Sieh, wie Werte durch den Gesprächs-Lifecycle wandern

Template-Syntax

Die vollständige Jinja-Syntax und fortgeschrittene Muster nachschlagen

Dynamic Context

Pre-Call-Datenabruf einrichten

Notifications

Post-Call-Variablen in E-Mail-Vorlagen verwenden

Begrüßungen

Begrüßungen mit Variablen personalisieren