Čeština pri oslovení mení tvar mena — Petr sa oslovuje „Petře“, Jana „Jano“, pán Novák „pane Nováku“. Tomuto tvaru sa hovorí **vokatív**, 5. pád. Správa „Dobrý den, Petr“ preto pôsobí strojovo, zatiaľ čo „Dobrý den, Petře“ znie, akoby ju písal človek. Táto funkcia teda vytvára **české oslovenie** a je určená pre správy českým príjemcom.

BulkGate vie vokatív z mena vytvoriť sám. Stačí mať pri príjemcovi uložené meno alebo priezvisko a do textu správy vložiť premennú s oslovením. Prečo sa oslovenie oplatí, rozoberá aj náš [blog o vokatíve](https://www.bulkgate.com/cs/blog/vyhody-pouziti-vokativu/).

## Premenné s oslovením

| premenná | čo do správy vloží | príklad |
|:--|:--|:--|
| `<first_name_vokativ>` | krstné meno v 5. páde | Petr → Petře |
| `<last_name_vokativ>` | priezvisko v 5. páde | Novák → Nováku |

V editore správy ich nájdete pod názvami `Meno - vokatív` a `Priezvisko - vokatív`. Pri premennej editor ukáže aj to, pri koľkých percentách príjemcov je hodnota vyplnená.

## Oslovenie filtrom

Oslovenie vytvoríte aj z ktorejkoľvek inej premennej — stačí za jej názov pripísať filter `vocative`. Hodí sa, keď máte celé meno v jednom poli, alebo keď v API posielate meno pod vlastným názvom. Filter `gender` k tomu podľa mena vyberie text pre muža, alebo pre ženu:

| zápis | hodnota | čo dostane príjemca |
|:--|:--|:--|
| `<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` |

Predvolenú hodnotu filter skloňuje tiež: príjemca bez mena dostane z `<first_name:zákazník|vocative>` text `Zákazníku`. Náhľad v editore kampane filter nevyhodnocuje — tvar oslovenia uvidíte až v testovacej správe. Parametre oboch filtrov a ich spojenie s ďalšími filtrami popisuje [Premenné v správach](https://www.bulkgate.com/sk/centrum-pomoci/nastroje/premenne-v-spravach/).

## Kde oslovenie použijete

### V kampani a pri odoslaní jednotlivej správy

Premenné ponúka editor textu v kampani aj vo formulári `Odoslať správu`. Vokatív vzniká automaticky z mena a priezviska príjemcu — pri kontaktoch z [adresára](https://www.bulkgate.com/sk/centrum-pomoci/adresar/pridavanie-kontaktov-do-adresara/) aj pri príjemcoch, ktorých do kampane nahráte súborom alebo zadáte ručne. Ako s premennými pracovať všeobecne, popisuje [Premenné v správach](https://www.bulkgate.com/sk/centrum-pomoci/nastroje/premenne-v-spravach/).

### V API

Pri odosielaní cez [Advanced API](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-transactional/2.0/) pošlite pri čísle v objekte `variables` kľúč `first_name` alebo `last_name`. Oslovenie k nim dopočítame sami a v texte ho použijete cez `<first_name_vokativ>` alebo `<last_name_vokativ>`:

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

Príjemca dostane správu „Ahoj Lukáši, tvoje objednávka je na cestě.“

### V e-shopovom plugine

Šablóny [zákazníckych](https://www.bulkgate.com/sk/centrum-pomoci/integracie/sms-moduly/zakaznicke-sms/) aj [administrátorských SMS](https://www.bulkgate.com/sk/centrum-pomoci/integracie/sms-moduly/admin-sms/) majú vlastné premenné, ktoré plugin plní z mena zákazníka v objednávke:

| premenná | čo do správy vloží |
|:--|:--|
| `<customer_firstname_vokativ>` | krstné meno zákazníka v 5. páde |
| `<customer_lastname_vokativ>` | priezvisko zákazníka v 5. páde |
| `<customer_invoice_firstname_vokativ>` | krstné meno z fakturačnej adresy v 5. páde |
| `<customer_invoice_lastname_vokativ>` | priezvisko z fakturačnej adresy v 5. páde |

## Ako oslovenie vzniká

- **Automaticky z mena.** Tvar sa odvodí z koncovky mena. Podľa nej sa rozpozná aj to, či ide o mužské, alebo ženské meno — pole s pohlavím pri kontakte sa nepoužíva.
- **Ženské priezviská sa nemenia.** Pani Nováková zostane „Nováková“, krstné mená na -a dostanú -o (Jana → Jano).
- **Prepočíta sa s každou zmenou mena.** Keď pri kontakte opravíte meno, oslovenie sa vytvorí znova. Samotný vokatív ručne upraviť nejde — v kontakte ani v importe preň pole nie je.

> [!IMPORTANT]
> Oslovenie sa tvorí **podľa pravidiel češtiny pri každom mene**, bez ohľadu na krajinu kontaktu. Slovenskému alebo zahraničnému príjemcovi by tak mohlo prísť „Dobrý den, Johne“. Premenné aj filtre s oslovením preto používajte iba v správach pre českých príjemcov.

Pri neobvyklých alebo cudzích menách môže tvar vyjsť nesprávne — pred veľkým rozoslaním si preto prejdite náhľad správy pri niekoľkých kontaktoch, pri filtri `vocative` testovaciu správu.

## Keď meno chýba

Príjemca bez mena oslovenie mať nemôže. Do premennej preto doplňte predvolený text za dvojbodku — použije sa pri každom, komu meno chýba:

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

Príjemca s menom Petr dostane „Dobrý den Petře, …“, príjemca bez mena „Dobrý den zákazníku, …“.