> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bek-agent.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Variablen

> Lerne, wie du Variablen in BEK-Agent nutzt, um Informationen während eines Anrufs zu speichern und abzurufen.

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

```csv theme={null}
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)

| 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!

## Schneller Support: BEK-Agent Reddit Community

Du hast Fragen oder brauchst schnelle Hilfe? Stelle deine Frage direkt in unserer Community auf [Reddit](https://www.reddit.com/r/bekagent/) – dort bekommst du meist innerhalb kürzester Zeit Unterstützung vom Team und anderen Nutzern!