# Daten zum Einfügen

In einen Platzhalter können Sie drei Arten von Daten einfügen: die Daten des Kontakts selbst, seine Variablen und die globalen Variablen des Bots.

## Daten des Kontakts

Sie werden ohne das Zeichen `$` geschrieben: `{{ first_name }}`, `{{ phone }}`.

| Schreibweise | Was eingefügt wird |
|---|---|
| `{{ name }}` | Vollständiger Name des Kontakts, wie im Messenger oder wie der Bot ihn gespeichert hat |
| `{{ first_name }}` | Erstes Wort des Namens |
| `{{ last_name }}` | Zweites Wort des Namens |
| `{{ phone }}` | Telefonnummer |
| `{{ email }}` | E-Mail |
| `{{ address }}` | Adresse |
| `{{ username }}` | Benutzername im Messenger (username) |
| `{{ id }}` | Nummer des Kontakts in Watbot |
| `{{ bot_id }}` | Nummer des Bots |
| `{{ created_at }}` | Wann der Kontakt dem Bot zum ersten Mal geschrieben hat, im Format `2026-10-02 14:30:00` (UTC) |
| `{{ start_message }}` | Erste Nachricht, die der Kontakt an den Bot gesendet hat |
| `{{ telegram_id }}` | ID des Nutzers in Telegram |
| `{{ max_id }}` | ID des Nutzers in MAX |
| `{{ amocrm_lead_id }}`, `{{ amocrm_contact_id }}` | ID des Deals und des Kontakts in amoCRM |
| `{{ bitrix_lead_id }}`, `{{ bitrix_deal_id }}`, `{{ bitrix_contact_id }}` | ID des Leads, des Deals und des Kontakts in Bitrix24 |

Fehlen diese Daten beim Kontakt — etwa weil keine Telefonnummer angegeben ist —, wird der Platzhalter durch eine leere Stelle ersetzt.

> [!NOTE]
> Einzelne Blöcke haben eigene Daten. Im Text der Benachrichtigung über einen neuen Empfohlenen stehen zum Beispiel `{{ name }}` (Name des Eingeladenen) und `{{ level }}` (Ebene) zur Verfügung, im Block „Verteilung nach Gruppen“ — `{{ name_list }}` und `{{ group_number }}`. Sie sind in den Einstellungen dieser Blöcke beschrieben.

## Kontaktvariablen

Variablen speichern die Antworten des Kontakts und alles, was der Bot im Lauf des Szenarios festgehalten hat. Sie werden mit dem Zeichen `$` vor dem Namen geschrieben:

```
Sie haben die Stadt {{ $stadt }} gewählt.
```

Hat der Kontakt keine solche Variable, wird der Platzhalter durch eine leere Stelle ersetzt.

### Wenn der Variablenname Leerzeichen enthält

Nach dem Zeichen `$` liest der Bot den Namen nur bis zum ersten Leerzeichen. Eine Variable mit einem Leerzeichen im Namen lässt sich daher nicht über `$` schreiben: Der Bot erkennt nicht, wo der Name endet.

Für solche Namen gibt es die Funktion `var`. Der Name steht in Anführungszeichen, genau so, wie die Variable im Bot heißt:

```
{{ var("Name des Kunden") }}, vielen Dank für Ihre Anfrage!
```

So schreiben Sie es:

1. Kopieren Sie den Variablennamen aus dem Bot — Groß- und Kleinschreibung, Leerzeichen und Zeichen müssen übereinstimmen.
2. Setzen Sie den Namen in Anführungszeichen: `"Name des Kunden"`.
3. Umschließen Sie ihn mit `var( )`: `{{ var("Name des Kunden") }}`.

| Variable im Bot | So fügen Sie sie ein |
|---|---|
| `stadt` | `{{ $stadt }}` |
| `Name des Kunden` | `{{ var("Name des Kunden") }}` |
| `Datum des Termins` | `{{ var("Datum des Termins") }}` |
| `Bestellsumme, EUR` | `{{ var("Bestellsumme, EUR") }}` |

`var` funktioniert auch in [Ausdrücken](https://support.watbot.org/de/chatbots/templates/expressions), wie jeder andere Wert:

```
{{ upper(var("Name des Kunden")) }}, zu zahlen: {{ var("Bestellsumme, EUR") * 0.9 }} €
```

> [!TIP]
> Am einfachsten benennen Sie Variablen ohne Leerzeichen: `kunden_name`, `termin_datum`. Dann genügt die kurze Schreibweise: `{{ $kunden_name }}`.

> [!NOTE]
> Wenn in Ihren Szenarien Namen mit Leerzeichen bereits über `$` ohne Ausdrücke eingefügt sind, funktionieren diese Platzhalter weiterhin. In neuen Texten verwenden Sie `var`.

## Globale Variablen

Globale Variablen werden in den Einstellungen des Bots festgelegt und sind für alle Kontakte gleich: Wechselkurs, Büroadresse, Zahlungslink. Sie werden ohne `$` geschrieben, genau wie in den Einstellungen benannt:

```
Unsere Adresse: {{ buero_adresse }}
```

### Wenn der Name einer globalen Variable Leerzeichen oder Klammern enthält

Verwenden Sie die Funktion `global` — den Namen in Anführungszeichen, genau wie in den Einstellungen des Bots:

```
Kurs heute: {{ global("Kurs (USD)") }} €
```

Innerhalb von Ausdrücken wird eine globale Variable immer über `global` gelesen, auch wenn der Name keine Leerzeichen enthält:

```
Gesamt in Dollar: {{ round($summe / global("Kurs (USD)"), 2) }}
```

Haben Daten des Kontakts und eine globale Variable denselben Namen, werden die Daten des Kontakts eingesetzt.

> [!WARNING]
> Der Wert einer globalen Variable wird unverändert ausgegeben, Platzhalter darin werden nicht aufgelöst. Steht im Wert `Guten Tag, {{ $name }}`, sieht der Kontakt genau diesen Text. Schreiben Sie solchen Text direkt in den Block.

## Werte sind Text

Alle Daten und Variablen werden als Text gespeichert. In Ausdrücken zählen Zahlen im Text als Zahlen: Steht in `$anzahl` der Wert `3`, ergibt der Ausdruck `{{ $anzahl * 2 }}` den Wert `6`. Text, der keiner Zahl ähnelt, lässt sich nicht berechnen — ein solcher Platzhalter wird durch eine leere Stelle ersetzt, der Grund erscheint in der Vorschau.