Im Tschechischen ändert sich die Form eines Namens, wenn man jemanden anspricht – Petr wird mit „Petře“ angesprochen, Jana mit „Jano“, Herr Novák mit „pane Nováku“. Diese Form heißt **Vokativ** und ist der 5. grammatische Fall. Eine Nachricht mit „Dobrý den, Petr“ klingt deshalb automatisiert, während „Dobrý den, Petře“ klingt, als hätte sie ein Mensch geschrieben.

BulkGate kann den Vokativ selbst aus dem Namen bilden. Sie benötigen lediglich den Vor- oder Nachnamen des Empfängers und eine Vokativ-Variable im Nachrichtentext.

## Vokativ-Variablen

| Variable | Was sie in die Nachricht einfügt | Beispiel |
|:--|:--|:--|
| `<first_name_vokativ>` | den Vornamen im Vokativ | Petr → Petře |
| `<last_name_vokativ>` | den Nachnamen im Vokativ | Novák → Nováku |

Im Nachrichteneditor finden Sie sie als `erster_name_vokativ` (*First name vocative*) und `last_name_vokativ` (*Last name vocative*). Zu jeder Variable zeigt der Editor außerdem an, bei wie viel Prozent der Empfänger ein Wert ausgefüllt ist.

## Vokativ mit einem Filter

Den Vokativ können Sie auch aus jeder anderen Variable bilden – fügen Sie einfach den Filter `vocative` hinter ihrem Namen ein. Das ist praktisch, wenn Sie den vollständigen Namen in einem Feld führen oder den Namen in der API unter einem eigenen Namen übergeben. Zusätzlich wählt der Filter `gender` anhand des Namens einen Text für einen Mann oder für eine Frau:

| Schreibweise | Wert | Was der Empfänger erhält |
|:--|:--|:--|
| `<first_name\|vocative>` | `Petr` | `Petře` |
| `<custom_field_0\|vocative>` | `Jana Nováková` | `Jano Nováková` |
| `<first_name\|gender:Milý,Milá> <first_name\|vocative>` | `Jana` | `Milá Jano` |

Der Filter dekliniert auch den Standardwert: Ein Empfänger ohne Namen erhält aus `<first_name:zákazník|vocative>` den Text `Zákazníku`. Die Vorschau im Kampagneneditor wertet den Filter nicht aus – die Vokativform sehen Sie erst in einer Testnachricht. Die Parameter beider Filter und ihre Kombination mit weiteren Filtern beschreibt [Variablen in Nachrichten](https://www.bulkgate.com/de/hilfe-center/tools/variablen-in-nachrichten/).

## Wo Sie den Vokativ verwenden

### In einer Kampagne und beim Senden einer einzelnen Nachricht

Der Texteditor bietet die Variablen sowohl in einer Kampagne als auch im Formular `Nachricht senden` an. Der Vokativ wird automatisch aus dem Vor- und Nachnamen des Empfängers gebildet – bei Kontakten aus dem [Adressbuch](https://www.bulkgate.com/de/hilfe-center/adressbuch/kontakte-hinzufuegen/) ebenso wie bei Empfängern, die Sie aus einer Datei in die Kampagne hochladen oder manuell eingeben. Wie Sie allgemein mit Variablen arbeiten, beschreibt [Variablen in Nachrichten](https://www.bulkgate.com/de/hilfe-center/tools/variablen-in-nachrichten/).

### In der API

Beim Senden über die [Advanced API](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-transactional/2.0/) übergeben Sie im Objekt `variables` der Nummer den Schlüssel `first_name` oder `last_name`. Den Vokativ bilden wir daraus selbst, und im Text verwenden Sie ihn mit `<first_name_vokativ>` oder `<last_name_vokativ>`:

```json
{
  "number": [{"number": "420777777777", "variables": {"first_name": "Lukáš"}}],
  "text": "Ahoj <first_name_vokativ>, tvoje objednávka je na cestě."
}
```

Der Empfänger erhält die Nachricht „Ahoj Lukáši, tvoje objednávka je na cestě.“

### Im E-Shop-Plugin

Die Vorlagen für [Kunden-SMS](https://www.bulkgate.com/de/hilfe-center/integrationen/sms-module/kunden-sms/) und [Admin SMS](https://www.bulkgate.com/de/hilfe-center/integrationen/sms-module/admin-sms/) haben eigene Variablen, die das Plugin aus dem Namen des Kunden in der Bestellung befüllt:

| Variable | Was sie in die Nachricht einfügt |
|:--|:--|
| `<customer_firstname_vokativ>` | den Vornamen des Kunden im Vokativ |
| `<customer_lastname_vokativ>` | den Nachnamen des Kunden im Vokativ |
| `<customer_invoice_firstname_vokativ>` | den Vornamen aus der Rechnungsadresse im Vokativ |
| `<customer_invoice_lastname_vokativ>` | den Nachnamen aus der Rechnungsadresse im Vokativ |

## Wie der Vokativ gebildet wird

- **Automatisch aus dem Namen.** Die Form wird aus der Endung des Namens abgeleitet. Die Endung bestimmt auch, ob es sich um einen männlichen oder weiblichen Namen handelt – das Geschlechtsfeld des Kontakts wird nicht verwendet.
- **Weibliche Nachnamen ändern sich nicht.** Frau Nováková bleibt „Nováková“; Vornamen auf -a erhalten -o (Jana → Jano).
- **Er wird bei jeder Namensänderung neu berechnet.** Wenn Sie den Namen eines Kontakts korrigieren, wird der Vokativ neu gebildet. Den Vokativ selbst können Sie nicht manuell bearbeiten – weder im Kontakt noch beim Import gibt es dafür ein Feld.

> [!IMPORTANT]
> Der Vokativ wird **bei jedem Namen nach den Regeln des Tschechischen** gebildet, unabhängig vom Land des Kontakts. Ein slowakischer oder ausländischer Empfänger könnte so „Dobrý den, Johne“ erhalten. Verwenden Sie die Vokativ-Variablen und -Filter daher nur in Nachrichten für tschechische Empfänger.

Bei ungewöhnlichen oder ausländischen Namen kann die Form falsch ausfallen – prüfen Sie daher vor einem großen Versand die Nachrichtenvorschau bei einigen Kontakten und beim Filter `vocative` eine Testnachricht.

## Wenn der Name fehlt

Ein Empfänger ohne Namen kann keinen Vokativ haben. Ergänzen Sie die Variable daher nach einem Doppelpunkt um einen Standardtext – er wird für alle verwendet, deren Name fehlt:

```text
Dobrý den <first_name_vokativ:zákazníku>, máme pro vás novinku.
```

Ein Empfänger namens Petr erhält „Dobrý den Petře, …“, ein Empfänger ohne Namen „Dobrý den zákazníku, …“.