Variablen in BEK-Agent
Lerne, wie du Variablen nutzt, um während eines Anrufs Informationen zu speichern und abzurufen.Was ist eine Variable?
Eine Variable ist ein Datenwert, den du während eines Anrufs speichern und wiederverwenden kannst. Mit Variablen kannst du z.B. den Namen des Anrufers, die Telefonnummer oder KI-generierte Werte festhalten.Variable referenzieren
Um eine Variable in deinem Telefon-Agenten zu verwenden, schreibe einfach{{variablenname}} in den Text eines Nodes. BEK-Agent ersetzt dies während des Anrufs automatisch durch den Wert der Variable.
- In Speak-Nodes wird der Wert der Variable dem Anrufer vorgelesen.
- In Integrations-Nodes wird der Wert an die Integration übergeben.
Typen von Variablen
Beim Erstellen deines Telefon-Agenten gibt es verschiedene Arten von Variablen:1. Metadaten
Metadaten-Variablen werden über Automatisierungen oder die API an deinen Agenten übergeben. Alle Daten, die du als Metadaten übergibst, stehen als Variable zur Verfügung und können mit{{variablenname}} abgerufen werden.
2. CSV-Attribute (Batch-Anrufe)
Bei Batch-Anrufen mit CSV-Dateien werden alle Spalten (außerphone) als Attribute gespeichert und können während des Anrufs verwendet werden.
So verwendest du CSV-Attribute:
- Format:
{{system.contact.attributes.SpalteName}} - Beispiel: Wenn deine CSV-Datei eine Spalte
CustomerContacthat, verwendest du:{{system.contact.attributes.CustomerContact}}
Praktisches Beispiel:
CSV-Datei:{{system.contact.name}}→ “Max Mustermann”{{system.contact.attributes.firma}}→ “Beispiel GmbH”{{system.contact.attributes.CustomerContact}}→ “VIP-Kunde”{{system.contact.attributes.vertragsnummer}}→ “V-2024-001”
Script-Beispiel:
Verfügbare System-Contact-Variablen:
{{system.contact}}- Alle Kontaktdaten{{system.contact.email}}- E-Mail-Adresse{{system.contact.name}}- Name des Kontakts{{system.contact.phone_number}}- Telefonnummer{{system.contact.attributes.spaltenname}}- Benutzerdefinierte Attribute aus CSV-Spalten
3. System-Variablen
System-Variablen sind von BEK-Agent vordefiniert und speichern Informationen zum Anruf, wie z.B. die Telefonnummer des Anrufers oder die aktuelle Uhrzeit. System-Variablen sind schreibgeschützt und können während des Anrufs nicht verändert werden.Teilnehmer (Participants)
| Variable | Beschreibung | Standard verfügbar |
|---|---|---|
{{system.participant.from.phone}} | Telefonnummer des Anrufstarters | ✅ |
{{system.participant.from.country}} | Land des Anrufstarters | ✅ |
{{system.participant.from.state}} | Bundesland des Anrufstarters | ❌ |
{{system.participant.from.city}} | Stadt des Anrufstarters | ❌ |
{{system.participant.from.zip}} | PLZ des Anrufstarters | ❌ |
{{system.participant.to.phone}} | Telefonnummer des Angerufenen | ✅ |
{{system.participant.to.country}} | Land des Angerufenen | ✅ |
{{system.participant.to.state}} | Bundesland des Angerufenen | ❌ |
{{system.participant.to.city}} | Stadt des Angerufenen | ❌ |
{{system.participant.to.zip}} | PLZ des Angerufenen | ❌ |
Anruf (Call)
| Variable | Beschreibung |
|---|---|
{{system.call.id}} | Eindeutige ID des Anrufs |
{{system.call.direction}} | Richtung des Anrufs (inbound/outbound) |
{{system.call.created_at}} | Zeitpunkt der Anruf-Erstellung (UTC) |
{{system.call.duration}} | Dauer des Anrufs zum Zeitpunkt des Zugriffs |
Weitere System-Variablen
| Variable | Beschreibung |
|---|---|
{{system.time}} | Aktuelle Uhrzeit (UTC) beim Zugriff |
Nutze Variablen, um deinen Telefon-Agenten noch flexibler und persönlicher zu gestalten!