En tchèque, la forme d'un prénom change lorsqu'on s'adresse à quelqu'un — on s'adresse à Petr par « Petře », à Jana par « Jano », à M. Novák par « pane Nováku ». Cette forme s'appelle le **vocatif**, le 5e cas grammatical. Un message disant « Dobrý den, Petr » sonne donc automatique, alors que « Dobrý den, Petře » donne l'impression d'avoir été écrit par une personne.

BulkGate sait créer lui-même le vocatif à partir d'un nom. Il suffit que le prénom ou le nom du destinataire soit enregistré et que le texte du message contienne une variable de vocatif.

## Variables de vocatif

| variable | ce qu'elle insère dans le message | exemple |
|:--|:--|:--|
| `<first_name_vokativ>` | le prénom au vocatif | Petr → Petře |
| `<last_name_vokativ>` | le nom au vocatif | Novák → Nováku |

Dans l'éditeur de message, vous les trouverez sous les noms `first_name_vokativ` et `last_name_vokativ`. Pour chaque variable, l'éditeur affiche aussi le pourcentage de destinataires pour lesquels une valeur est renseignée.

## Vocatif avec un filtre

Vous pouvez aussi créer le vocatif à partir de n'importe quelle autre variable — il suffit d'ajouter le filtre `vocative` après son nom. C'est utile lorsque vous enregistrez le nom complet dans un seul champ, ou lorsque vous envoyez le nom dans l'API sous un nom de variable qui vous est propre. En outre, le filtre `gender` choisit un texte pour un homme ou pour une femme en fonction du prénom :

| notation | valeur | ce que reçoit le destinataire |
|:--|:--|:--|
| `<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` |

Le filtre décline aussi la valeur par défaut : un destinataire sans nom reçoit `Zákazníku` à partir de `<first_name:zákazník|vocative>`. L'aperçu dans l'éditeur de campagne n'évalue pas le filtre — vous ne voyez la forme au vocatif que dans un message de test. Les paramètres des deux filtres et la manière de les combiner avec d'autres filtres sont décrits dans [Variables dans les messages](https://www.bulkgate.com/fr/centre-d-aide/outils/variables-dans-les-messages/).

## Où utiliser le vocatif

### Dans une campagne et lors de l'envoi d'un message unique

L'éditeur de texte propose les variables aussi bien dans une campagne que dans le formulaire `Envoyer message`. Le vocatif est créé automatiquement à partir du prénom et du nom du destinataire — pour les contacts du [carnet d'adresses](https://www.bulkgate.com/fr/centre-d-aide/carnet-d-adresses/ajouter-des-contacts/) comme pour les destinataires que vous importez dans la campagne depuis un fichier ou que vous saisissez manuellement. L'utilisation des variables en général est décrite dans [Variables dans les messages](https://www.bulkgate.com/fr/centre-d-aide/outils/variables-dans-les-messages/).

### Dans l'API

Lors d'un envoi via l'[Advanced API](https://www.bulkgate.com/fr/documentation/advanced-api/advanced-transactional/2.0/), transmettez la clé `first_name` ou `last_name` dans l'objet `variables` du numéro. Nous en déduisons nous-mêmes le vocatif, que vous utilisez dans le texte avec `<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ě."
}
```

Le destinataire reçoit le message « Ahoj Lukáši, tvoje objednávka je na cestě. »

### Dans le plugin e-shop

Les modèles [SMS client](https://www.bulkgate.com/fr/centre-d-aide/integrations/modules-sms/sms-clients/) et [SMS administrateur](https://www.bulkgate.com/fr/centre-d-aide/integrations/modules-sms/admin-sms/) disposent de leurs propres variables, que le plugin remplit à partir du nom du client figurant dans la commande :

| variable | ce qu'elle insère dans le message |
|:--|:--|
| `<customer_firstname_vokativ>` | le prénom du client au vocatif |
| `<customer_lastname_vokativ>` | le nom du client au vocatif |
| `<customer_invoice_firstname_vokativ>` | le prénom de l'adresse de facturation au vocatif |
| `<customer_invoice_lastname_vokativ>` | le nom de l'adresse de facturation au vocatif |

## Comment le vocatif est créé

- **Automatiquement à partir du nom.** La forme est déduite de la terminaison du nom. La terminaison indique aussi s'il s'agit d'un nom masculin ou féminin — le champ sexe du contact n'est pas utilisé.
- **Les noms de famille féminins ne changent pas.** Mme Nováková reste « Nováková » ; les prénoms en -a prennent -o (Jana → Jano).
- **Il est recalculé à chaque modification du nom.** Lorsque vous corrigez le nom d'un contact, le vocatif est créé de nouveau. Le vocatif lui-même ne peut pas être modifié manuellement — il n'existe aucun champ pour lui ni dans le contact ni dans l'import.

> [!IMPORTANT]
> Le vocatif est créé **selon les règles du tchèque pour chaque nom**, quel que soit le pays du contact. Un destinataire slovaque ou étranger pourrait ainsi recevoir « Dobrý den, Johne ». N'utilisez donc les variables et filtres de vocatif que dans des messages destinés à des destinataires tchèques.

Pour les noms inhabituels ou étrangers, la forme peut être erronée — avant un envoi important, vérifiez donc l'aperçu du message pour quelques contacts, et un message de test pour le filtre `vocative`.

## Lorsque le nom manque

Un destinataire sans nom ne peut pas avoir de vocatif. Ajoutez donc à la variable un texte par défaut après deux-points — il est utilisé pour tous ceux dont le nom manque :

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

Un destinataire prénommé Petr reçoit « Dobrý den Petře, … », un destinataire sans nom « Dobrý den zákazníku, … ».