Em checo, a forma de um nome muda quando nos dirigimos a alguém — o Petr é tratado por “Petře”, a Jana por “Jano”, o Sr. Novák por “pane Nováku”. Esta forma chama-se **vocativo**, o 5.º caso gramatical. Uma mensagem que diga “Dobrý den, Petr” soa, por isso, automática, enquanto “Dobrý den, Petře” soa como se tivesse sido escrita por uma pessoa.

A BulkGate consegue criar o vocativo a partir de um nome de forma automática. Basta ter registado o nome próprio ou o apelido do destinatário e incluir uma variável de vocativo no texto da mensagem.

## Variáveis de vocativo

| variável | o que insere na mensagem | exemplo |
|:--|:--|:--|
| `<first_name_vokativ>` | o nome próprio no vocativo | Petr → Petře |
| `<last_name_vokativ>` | o apelido no vocativo | Novák → Nováku |

No editor de mensagens, encontra-as como `first_name_vokativ` e `last_name_vokativ`. Para cada variável, o editor mostra também a percentagem de destinatários que têm um valor preenchido.

## Vocativo com um filtro

Também pode criar o vocativo a partir de qualquer outra variável — basta acrescentar o filtro `vocative` a seguir ao seu nome. É útil quando guarda o nome completo num único campo, ou quando envia o nome na API com um nome próprio de variável. Além disso, o filtro `gender` escolhe um texto para um homem ou para uma mulher com base no nome:

| notação | valor | o que o destinatário recebe |
|:--|:--|:--|
| `<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` |

O filtro também declina o valor predefinido: um destinatário sem nome recebe `Zákazníku` a partir de `<first_name:zákazník|vocative>`. A pré-visualização no editor de campanhas não avalia o filtro — a forma do vocativo só é visível numa mensagem de teste. Os parâmetros de ambos os filtros e a forma de os combinar com outros filtros são descritos em [Variáveis nas mensagens](https://www.bulkgate.com/pt/centro-de-ajuda/ferramentas/variaveis-nas-mensagens/).

## Onde utilizar o vocativo

### Numa campanha e ao enviar uma mensagem individual

O editor de texto oferece as variáveis tanto numa campanha como no formulário `Enviar mensagem`. O vocativo é criado automaticamente a partir do nome próprio e do apelido do destinatário — tanto para os contactos da [agenda de contactos](https://www.bulkgate.com/pt/centro-de-ajuda/agenda-de-contactos/adicionar-contactos/) como para os destinatários que carrega na campanha a partir de um ficheiro ou introduz manualmente. A forma de trabalhar com variáveis em geral é descrita em [Variáveis nas mensagens](https://www.bulkgate.com/pt/centro-de-ajuda/ferramentas/variaveis-nas-mensagens/).

### Na API

Ao enviar através da [Advanced API](https://www.bulkgate.com/pt/documentacao/advanced-api/advanced-transactional/2.0/), passe a chave `first_name` ou `last_name` no objeto `variables` do número. Nós próprios calculamos o vocativo a partir delas, e o utilizador usa-o no texto com `<first_name_vokativ>` ou `<last_name_vokativ>`:

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

O destinatário recebe a mensagem “Ahoj Lukáši, tvoje objednávka je na cestě.”

### No plugin para e-shops

Os modelos de [SMS para clientes](https://www.bulkgate.com/pt/centro-de-ajuda/integracoes/modulos-de-e-commerce/sms-para-clientes/) e de [Admin SMS](https://www.bulkgate.com/pt/centro-de-ajuda/integracoes/modulos-de-e-commerce/admin-sms/) têm variáveis próprias, que o plugin preenche a partir do nome do cliente na encomenda:

| variável | o que insere na mensagem |
|:--|:--|
| `<customer_firstname_vokativ>` | o nome próprio do cliente no vocativo |
| `<customer_lastname_vokativ>` | o apelido do cliente no vocativo |
| `<customer_invoice_firstname_vokativ>` | o nome próprio do endereço de faturação no vocativo |
| `<customer_invoice_lastname_vokativ>` | o apelido do endereço de faturação no vocativo |

## Como é criado o vocativo

- **Automaticamente a partir do nome.** A forma é derivada da terminação do nome. A terminação indica também se se trata de um nome masculino ou feminino — o campo de género do contacto não é utilizado.
- **Os apelidos femininos não mudam.** A Sra. Nováková continua a ser “Nováková”; os nomes próprios terminados em -a passam a terminar em -o (Jana → Jano).
- **É recalculado a cada alteração do nome.** Quando corrige o nome de um contacto, o vocativo é criado de novo. O vocativo em si não pode ser editado manualmente — não existe nenhum campo para ele no contacto nem na importação.

> [!IMPORTANT]
> O vocativo é criado **segundo as regras do checo para todos os nomes**, independentemente do país do contacto. Um destinatário eslovaco ou estrangeiro poderia assim receber “Dobrý den, Johne”. Por isso, utilize as variáveis e os filtros de vocativo apenas em mensagens para destinatários checos.

No caso de nomes invulgares ou estrangeiros, a forma pode sair errada — por isso, antes de um envio em grande escala, verifique a pré-visualização da mensagem para alguns contactos e, no caso do filtro `vocative`, uma mensagem de teste.

## Quando o nome está em falta

Um destinatário sem nome não pode ter vocativo. Por isso, acrescente um texto predefinido à variável, a seguir a dois pontos — é utilizado para todos aqueles cujo nome está em falta:

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

Um destinatário chamado Petr recebe “Dobrý den Petře, …”, um destinatário sem nome recebe “Dobrý den zákazníku, …”.