> ## 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.

# Modèles transactionnels

> Écrire l'e-mail une fois, laisser vos applications l'appeler par son nom.

**Transactionnel → Modèles transactionnels → Nouveau modèle**.

## Le nom

Le nom est ce que votre application envoie : **lettres minuscules, chiffres et tirets**, unique dans l'équipe. Gardez-le court et stable (`confirmation-commande`, `reinitialisation-mot-de-passe`).

<Warning>
  Renommer ou supprimer un modèle fait échouer les applications qui demandent
  l'ancien nom (erreur 422).
</Warning>

## La page d'édition

| Section                        | Contenu                                                                                                                                                                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Objet**                      | Accepte les variables : `Commande {{ order.number }} confirmée`.                                                                                                                                                                                                               |
| **Modèle**, **Éditeur**        | Une mise en page facultative ; éditeur HTML, Markdown ou MJML (pas de blocs).                                                                                                                                                                                                  |
| **Contenu**                    | Le corps, avec variables, conditions et boucles. Voir [Personnalisation](/fr/content/personalization).                                                                                                                                                                         |
| **Variables d'exemple (JSON)** | Un exemple de ce que votre application enverra ; il alimente l'aperçu et les tests.                                                                                                                                                                                            |
| **Aperçu**                     | Le rendu avec les variables d'exemple.                                                                                                                                                                                                                                         |
| **Langues**                    | Une version par langue ; l'application choisit avec `locale`. Voir [Langues](/fr/content/languages).                                                                                                                                                                           |
| **Expéditeur**                 | Adresse, nom, réponse. Vide : ceux de **Paramètres → Général**.                                                                                                                                                                                                                |
| **Destinataires par défaut**   | À, Cc, Cci : utilisés quand l'appel ne porte aucun destinataire. Pratique pour une alerte interne (« nouvelle commande ») envoyée toujours aux mêmes personnes.                                                                                                                |
| **Suivi**                      | Ouvertures et clics.                                                                                                                                                                                                                                                           |
| **Conserver le contenu**       | Le journal garde l'e-mail tel qu'il a été envoyé. Décochez pour les e-mails sensibles (liens de connexion, codes) : seule l'enveloppe reste (destinataires, objet, statut, chiffres). Les variables ne sont pas gardées non plus, et ces e-mails ne peuvent pas être renvoyés. |

**L'envoyer depuis votre code** affiche un appel `curl` prêt à copier, avec le nom du modèle et les variables d'exemple.

### Exemple

Contenu :

```html theme={null}
<p>Bonjour {{ customer.name }},</p>
<p>Votre commande <strong>{{ order.number }}</strong> est confirmée.</p>
<ul>
    {% for line in order.lines %}
    <li>{{ line }}</li>
    {% endfor %}
</ul>
{% if order.pickup %}
<p>À retirer en boutique à partir de {{ order.pickup }}.</p>
{% endif %}
```

Variables d'exemple :

```json theme={null}
{
    "customer": { "name": "Ada" },
    "order": {
        "number": "A-1024",
        "lines": ["Pain au levain", "Brioche"],
        "pickup": "samedi 10 h"
    }
}
```

## Envoyer un test

**Envoyer un test** : des adresses e-mail. Le test part avec les variables d'exemple, par le fournisseur transactionnel, et apparaît dans le journal.

## Les chiffres du modèle

En haut de la page : **Envoyée**, **Échoué**, **Ouvertures**, **Clics** pour ce modèle. Un modèle sans contenu est marqué **Inachevé** dans la liste.