Čeština při oslovení mění tvar jména — Petr se oslovuje „Petře“, Jana „Jano“, pan Novák „pane Nováku“. Tomuto tvaru se říká **vokativ**, 5. pád. Zpráva „Dobrý den, Petr“ proto působí strojově, zatímco „Dobrý den, Petře“ zní, jako by ji psal člověk.

BulkGate umí vokativ ze jména vytvořit sám. Stačí mít u příjemce uložené jméno nebo příjmení a do textu zprávy vložit proměnnou s oslovením. Proč se oslovení vyplatí, rozebírá i náš [blog o vokativu](https://www.bulkgate.com/cs/blog/vyhody-pouziti-vokativu/).

## Proměnné s oslovením

| proměnná | co do zprávy vloží | příklad |
|:--|:--|:--|
| `<first_name_vokativ>` | křestní jméno v 5. pádě | Petr → Petře |
| `<last_name_vokativ>` | příjmení v 5. pádě | Novák → Nováku |

V editoru zprávy je najdete pod názvy `Jméno - 5. pád` a `Příjmení - 5.pád`. U proměnné editor ukáže i to, u kolika procent příjemců je hodnota vyplněná.

## Kde oslovení použijete

### V kampani a při odeslání jednotlivé zprávy

Proměnné nabízí editor textu v kampani i ve formuláři `Odeslat zprávu`. Vokativ vzniká automaticky ze jména a příjmení příjemce — u kontaktů z [adresáře](https://www.bulkgate.com/cs/centrum-napovedy/adresar/pridavani-kontaktu-do-adresare/) i u příjemců, které do kampaně nahrajete souborem nebo zadáte ručně. Jak s proměnnými pracovat obecně, popisuje [Proměnné ve zprávách](https://www.bulkgate.com/cs/centrum-napovedy/nastroje/promenne-ve-zpravach/).

### V API

Při odesílání přes [Advanced API](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-transactional/2.0/) pošlete u čísla v objektu `variables` klíč `first_name` nebo `last_name`. Oslovení k nim dopočítáme sami a v textu ho použijete přes `<first_name_vokativ>` nebo `<last_name_vokativ>`:

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

Příjemce dostane zprávu „Ahoj Lukáši, tvoje objednávka je na cestě.“

### V e-shopovém pluginu

Šablony [zákaznických](https://www.bulkgate.com/cs/centrum-napovedy/integrace/sms-moduly/zakaznicke-sms/) i [administrátorských SMS](https://www.bulkgate.com/cs/centrum-napovedy/integrace/sms-moduly/admin-sms/) mají vlastní proměnné, které plugin plní ze jména zákazníka v objednávce:

| proměnná | co do zprávy vloží |
|:--|:--|
| `<customer_firstname_vokativ>` | křestní jméno zákazníka v 5. pádě |
| `<customer_lastname_vokativ>` | příjmení zákazníka v 5. pádě |
| `<customer_invoice_firstname_vokativ>` | křestní jméno z fakturační adresy v 5. pádě |
| `<customer_invoice_lastname_vokativ>` | příjmení z fakturační adresy v 5. pádě |

## Jak oslovení vzniká

- **Automaticky ze jména.** Tvar se odvodí z koncovky jména. Podle ní se pozná i to, jestli jde o mužské, nebo ženské jméno — pole s pohlavím u kontaktu se nepoužívá.
- **Ženská příjmení se nemění.** Paní Nováková zůstane „Nováková“, křestní jména na -a dostanou -o (Jana → Jano).
- **Přepočítá se s každou změnou jména.** Když u kontaktu opravíte jméno, oslovení se vytvoří znovu. Samotný vokativ ručně upravit nejde — v kontaktu ani v importu pro něj pole není.

> [!IMPORTANT]
> Oslovení se tvoří **podle pravidel češtiny u každého jména**, bez ohledu na zemi kontaktu. Slovenskému nebo zahraničnímu příjemci by tak mohlo přijít „Dobrý den, Johne“. Proměnné s vokativem proto používejte jen ve zprávách pro české příjemce.

U neobvyklých nebo cizích jmen může tvar vyjít špatně — před velkou rozesílkou si proto projděte náhled zprávy u několika kontaktů.

## Když jméno chybí

Příjemce bez jména oslovení mít nemůže. Do proměnné proto doplňte výchozí text za dvojtečku — použije se u každého, u koho jméno chybí:

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

Příjemce se jménem Petr dostane „Dobrý den Petře, …“, příjemce bez jména „Dobrý den zákazníku, …“.