​
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ßer phone) 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 CustomerContact hat, verwendest du: {{system.contact.attributes.CustomerContact}}

​
Praktisches Beispiel:

CSV-Datei: 
phone,name,firma,CustomerContact,vertragsnummer
+49123456789,Max Mustermann,Beispiel GmbH,VIP-Kunde,V-2024-001
Verwendung im Script:
  • {{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:

Hallo {{system.contact.name}}, ich rufe dich bezüglich deines Unternehmens {{system.contact.attributes.firma}} an.
Als {{system.contact.attributes.CustomerContact}} hast du Anspruch auf unseren Premium-Service.

​
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)

VariableBeschreibungStandard 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)

VariableBeschreibung
{{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

VariableBeschreibung
{{system.time}}Aktuelle Uhrzeit (UTC) beim Zugriff
Nutze Variablen, um deinen Telefon-Agenten noch flexibler und persönlicher zu gestalten!

​
Schneller Support: BEK-Agent Reddit Community

Du hast Fragen oder brauchst schnelle Hilfe? Stelle deine Frage direkt in unserer Community auf Reddit – dort bekommst du meist innerhalb kürzester Zeit Unterstützung vom Team und anderen Nutzern!