Variablen verwenden
Mit Variablen fügen Sie dynamische Informationen in Begrüßung und Prompt ein — zum Beispiel den Namen des Anrufers oder Ihrer Organisation. Eine Variable ist ein Platzhalter in doppelten geschweiften Klammern (z. B. {{contact.first_name}}), der zu Beginn jedes Gesprächs durch den echten Wert ersetzt wird.
Was Sie erreichen werden
Nach dieser Anleitung können Sie:
- Variablen in Begrüßung und Prompt einfügen
- Alle verfügbaren Variablen und ihre Bedeutung nachschlagen
- Eigene Variablen über Kontaktfelder anlegen
- Personalisierte Begrüßungen bauen, die auch bei unbekannten Anrufern funktionieren
Voraussetzungen
- Ein angelegter Agent (Einen Agenten erstellen)
- Für anruferbezogene Variablen: gepflegte Kontakte (Kontakte verwalten)
So funktionieren Variablen
Variablen werden beim Gesprächsstart ersetzt — bei eingehenden und ausgehenden Anrufen gleichermaßen:
- Eingehend: Die Plattform ordnet die Rufnummer des Anrufers Ihren Kontakten zu. Wird ein Kontakt gefunden, stehen dessen Daten in den
{{contact.*}}-Variablen zur Verfügung. - Ausgehend: Die Variablen werden mit den Daten des angerufenen Kontakts gefüllt — auch bei Anrufen aus Kampagnen.
Hinweis: Es handelt sich um eine einfache Ersetzung: Jede Variable wird durch ihren Wert ersetzt — mehr nicht. Wenn-dann-Logik wie
{{#if ...}}wird nicht unterstützt; solche Ausdrücke bleiben wörtlich im Text stehen und werden vom Agenten vorgelesen. Wie Sie Fallunterscheidungen trotzdem lösen, lesen Sie weiter unten.
Variablen einfügen
- Öffnen Sie Ihren Agenten unter Agenten und wechseln Sie zum Tab Allgemein
- Klicken Sie neben dem Feld Begrüßung oder Prompt auf den Button Variablen
- Wählen Sie eine Variable aus der Liste — sie wird an der Cursor-Position eingefügt
So vermeiden Sie Tippfehler im Variablennamen — falsch geschriebene Variablen werden nicht ersetzt.
Verfügbare Variablen
Kontakt (Daten des Anrufers bzw. Angerufenen)
| Variable | Bedeutung |
|---|---|
{{contact.salutation}} | Anrede („Herr” / „Frau”) |
{{contact.first_name}} | Vorname |
{{contact.last_name}} | Nachname |
{{contact.company}} | Firma des Kontakts |
{{contact.email}} | E-Mail-Adresse |
{{contact.customer_number}} | Kundennummer |
{{contact.street}} | Straße |
{{contact.house_number}} | Hausnummer |
{{contact.postal_code}} | Postleitzahl |
{{contact.city}} | Stadt |
{{contact.country}} | Land |
Organisation (Ihre eigenen Stammdaten)
| Variable | Bedeutung |
|---|---|
{{organization.name}} | Name Ihrer Organisation |
{{organization.street}} | Straße |
{{organization.city}} | Stadt |
{{organization.postal_code}} | Postleitzahl |
{{organization.country}} | Land |
{{organization.url}} | Website |
{{organization.email}} | E-Mail-Adresse |
Hinweis: Häufige Verwechslung: Für den Namen Ihres eigenen Unternehmens verwenden Sie
{{organization.name}}—{{contact.company}}ist dagegen die Firma des Anrufers. Eine Variable wie{{firma}}gibt es nicht.
Geschäftszeiten
| Variable | Bedeutung |
|---|---|
{{business_hours.next_open}} | Nächste Öffnung als fertiger Satzteil — z. B. morgen ab 8 Uhr, heute ab 14 Uhr, Montag ab 9 Uhr |
{{business_hours.today}} | Heutige Geschäftszeiten — z. B. 9 bis 17 Uhr oder 9 bis 12 Uhr und 14 bis 17 Uhr |
Beide Angaben berücksichtigen Feiertage und eingetragene Schließzeiten: Liegt vor der nächsten Öffnung ein Feiertag oder eine Betriebsschließung, nennt {{business_hours.next_open}} den ersten Tag danach — nicht einfach „morgen”.
Sind an einem Agenten keine Geschäftszeiten hinterlegt, oder ist heute geschlossen, bleiben die Variablen leer. Sie stehen dann nicht als geschweifte Klammern im Text und werden auch nicht vorgelesen. Formulieren Sie den Satz deshalb so, dass er ohne die Angabe noch stimmt:
Gut: Die Kollegen sind wieder erreichbar: {{business_hours.next_open}}
Schlecht: Wir sind {{business_hours.today}} für Sie da → wird bei Schließung zu „Wir sind für Sie da"
Hinweis: Ob gerade Geschäftszeit ist, weiß der Agent ohnehin — außerhalb der Zeiten bietet er von sich aus keine Weiterleitung mehr an. Die Variablen ergänzen nur die konkrete Uhrzeit für die Ansage.
Agent, Stimme und Anruf
| Variable | Bedeutung |
|---|---|
{{agent.name}} | Name des Agenten |
{{agent.description}} | Beschreibung des Agenten |
{{voice.name}} | Name der aktiven Stimme — nützlich bei zufälliger Stimmenauswahl |
{{call.recipient_number}} | Rufnummer der Gegenseite |
{{call.system_number}} | Ihre angerufene bzw. anrufende Nummer |
Eigene Variablen über Kontaktfelder
Zusätzlich zu den Standardfeldern können Sie an jedem Kontakt beliebige eigene Felder hinterlegen:
- Öffnen Sie unter Kontakte einen Kontakt zur Bearbeitung
- Tragen Sie im Abschnitt Dynamische Variablen ein Paar aus Schlüssel und Wert ein — zum Beispiel Schlüssel
vertragsart, WertPremium - Verwenden Sie den Schlüssel in Begrüßung oder Prompt als Variable:
{{vertragsart}}
Der Variablenname entspricht exakt dem Schlüssel, den Sie am Kontakt eingetragen haben. In den Texten von Gesprächsabläufen (Tab Flow) können Sie eigene Felder zusätzlich in der Form {{dynamic.vertragsart}} ansprechen.
Auch bei Kampagnen funktioniert das Prinzip: Zusätzliche Spalten aus Ihrer importierten Kontaktliste stehen im Gespräch als Variablen unter ihrem Spaltennamen zur Verfügung (Kampagne erstellen).
Personalisierte Begrüßung mit Fallback
Bei eingehenden Anrufen ist nicht jeder Anrufer als Kontakt bekannt — etwa bei unterdrückter Rufnummer oder Erstanrufern. Eine feste Begrüßung wie Guten Tag {{contact.salutation}} {{contact.last_name}} klingt dann unvollständig, weil die Werte fehlen.
Da Variablen keine Wenn-dann-Logik unterstützen, lösen Sie den Fallback über die Anweisung im Prompt statt über einen festen Begrüßungstext:
- Lassen Sie die kontaktbezogenen Variablen aus dem Feld Begrüßung heraus (oder lassen Sie es leer)
- Geben Sie dem Agenten die Fallunterscheidung als Anweisung im Prompt mit:
## Begrüßung des Anrufers
Name des Anrufers, falls bekannt: {{contact.salutation}} {{contact.last_name}}
- Wenn oben ein Name eingetragen ist, begrüße den Anrufer persönlich damit.
- Wenn kein Name eingetragen ist, begrüße neutral mit "Guten Tag".
So begrüßt der Agent bekannte Anrufer persönlich und alle anderen neutral — ohne dass Platzhalter hörbar werden.
Fehlerbehebung
Der Agent liest „geschweifte Klammer” oder den Variablennamen vor
Erklärung: Die Variable wurde nicht ersetzt — entweder ist der Name falsch geschrieben, die Variable existiert nicht (z. B. {{firma}}), oder es wurde nicht unterstützte Wenn-dann-Syntax wie {{#if ...}} verwendet.
Lösung:
- Fügen Sie Variablen über den Button Variablen im Agenten-Editor ein, statt sie von Hand zu tippen
- Entfernen Sie Konditional-Ausdrücke und bilden Sie die Fallunterscheidung stattdessen als Prompt-Anweisung ab (siehe oben)
Die Begrüßung bleibt unpersönlich, obwohl der Anrufer Kunde ist
Erklärung: Die Rufnummer des Anrufers konnte keinem Kontakt zugeordnet werden — der Kontakt fehlt, die hinterlegte Nummer weicht ab, oder der Anrufer unterdrückt seine Rufnummer.
Lösung:
- Prüfen Sie unter Kontakte, ob der Anrufer als Kontakt mit dieser Rufnummer angelegt ist
- Behalten Sie für gemischtes Publikum die neutrale Begrüßung mit Prompt-Fallback bei — sie deckt beide Fälle ab
Nächste Schritte
- Prompt schreiben - Verhaltensanweisungen rund um Ihre Variablen formulieren
- Kontakte verwalten - Kontaktdaten pflegen, aus denen die Variablen gefüllt werden
- Kampagne erstellen - Eigene Spalten aus Kontaktlisten in Gesprächen nutzen
- Agent testen - Prüfen, wie Begrüßung und Variablen im Gespräch klingen