> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lekalao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Écrire en plusieurs langues

> Une campagne, une version par langue, chacun reçoit la sienne.

Lekalao sait à qui écrire dans quelle langue, et vous laisse écrire chaque e-mail en autant de langues que nécessaire. **Toutes les langues du monde** sont acceptées (codes ISO 639-1), avec une région si besoin : `fr`, `en`, `sw`, `pt-BR`.

## La langue de chaque abonné

| Niveau | Réglage                                       | Rôle                                                                      |
| ------ | --------------------------------------------- | ------------------------------------------------------------------------- |
| Liste  | **Langue de la liste** (réglages de la liste) | La langue par défaut de ses abonnés.                                      |
| Abonné | **Langue** (fiche de l'abonné)                | Remplace celle de la liste pour cette personne. Vide : celle de la liste. |

La langue d'un abonné arrive par :

* sa fiche, dans l'interface ;
* le formulaire d'inscription (champ `locale`) ;
* l'import (colonne *langue*, *language*, *lang* ou *locale*, en code ou en nom : `fr`, `Français`, `French`) ;
* l'API (`locale`) ;
* **sa page de préférences**, où il la choisit lui-même.

Les pages publiques (confirmation, désabonnement, préférences) et les e-mails système (confirmation, bienvenue) s'affichent dans cette langue quand l'interface la connaît, sinon dans la langue par défaut de l'installation.

## Écrire une version traduite

Au-dessus de l'éditeur d'une campagne, d'un e-mail d'automatisation ou d'un modèle transactionnel, les **onglets de langue** :

<Steps>
  <Step title="La version de base">
    Le premier onglet est la version de base, dans la langue de la liste.
    C'est elle que reçoit toute personne dont la langue n'a pas de version.
  </Step>

  <Step title="Ajouter une langue">
    **Ajouter une langue**, tapez quelques lettres (« espa », « swah »),
    choisissez. Un onglet apparaît.
  </Step>

  <Step title="Écrire la traduction">
    Dans l'onglet, l'**objet** et le **contenu** sont ceux de cette langue ;
    l'aperçu les montre avec l'attribut `lang` correspondant. Le modèle,
    l'éditeur et les réglages sont communs à toutes les versions.
  </Step>

  <Step title="Enregistrer">
    **Sauvegarder** enregistre toutes les versions d'un coup. Une version
    laissée entièrement vide n'est pas gardée ; la croix d'un onglet retire
    la langue.
  </Step>
</Steps>

## Qui reçoit quoi

Pour chaque abonné, Lekalao prend :

1. la version de **sa langue exacte** (`pt-BR`) ;
2. sinon la version de **la langue sans région** (`pt`) ;
3. sinon la **version de base**.

Un **objet traduit laissé vide** reprend l'objet de base, et un contenu traduit laissé vide reprend le contenu de base : vous pouvez ne traduire que l'objet.

L'e-mail envoyé porte la langue dans sa balise `<html lang="…">`, ce qui aide les lecteurs d'écran et certains filtres.

## Envoyer par langue

Pour écrire à une seule langue, créez un [segment](/fr/contacts/segments) **Langue est…**. « Portugais » inclut `pt` et `pt-BR` ; « Portugais (Brésil) » vise `pt-BR` seul.

<Note>
  Les versions d'un **test A/B** ne se traduisent pas : une campagne en test
  A/B n'a pas d'onglets de langue. Pour tester deux objets dans deux langues,
  faites deux campagnes, chacune sur un segment de langue.
</Note>

## E-mails transactionnels

Votre application choisit la langue à chaque envoi avec le paramètre `locale` :

```json theme={null}
{
    "template": "confirmation-commande",
    "to": ["ada@example.com"],
    "locale": "en"
}
```

Sans `locale`, la version de base part. Voir [E-mails transactionnels par l'API](/fr/developers/transactional#en-plusieurs-langues).
