# Tutoriel Publipostage personnalisé avec Mail Merge dans Thunderbird
## Pré-requis
1. **Courrielleur de l'état** installé et configuré.
2. **Extension Mail Merge** installée. [=> guide d'installation.](#Installer-l%E2%80%99extention-Mail-Merge)
3. **Un fichier de données (CSV)** ([voir la création d'un fichier CSV](#Pr%C3%A9paration-d%E2%80%99un-fichier-de-donn%C3%A9es-CSV)) ou le **carnet d'adresse de la messagerie** contenant les informations des destinataires,
---
## Étape 1 : Création d’un modèle d’e-mail
Cela reprend le principe du publipostage sur Microsoft Word ou LibreOffice Writer.
1. **Rédigez un nouvel e-mail** :
- Ouvrez le courrielleur, cliquez sur **`Fichier > Nouveau Message`.**
- Pour information :
:::info
Les champs entre **`{{ }}`** doivent correspondre aux en-têtes de votre fichier CSV ou de votre carnet d'adresse ([pour voir la liste des champs disponible de votre carnet d'adresse cliquer ici](#Correspondances-Carnet-d%E2%80%99adresse)).
:::
- Insérez le texte de votre message. Par exemple :
```
Bonjour {{Prénom}} {{Nom}},
Nous vous remercions de votre intérêt pour notre service.
Cordialement,
[Votre nom]
```
- **Ne pas oublier d'insérer le destinataire**
- Si vous utilisez le **fichier CSV de l'exemple** :

- Si vous utilisez **votre carnet d'adresse** :

2. **Enregistrez le modèle** :
- Dans la fenêtre de rédaction, cliquez sur **`Fichier > Enregistrer comme > Modèle`.**
---
## Étape 2 : Utiliser Mail Merge
1. **Ouvrez votre mail modèle** :
- Retournez dans votre boîte email puis dans le dossier "**Modèle**".
- Sélectionnez votre modèle enregistré, puis cliquez sur "**Nouveau message depuis un modèle**"
2. **Paramétrez la fenêtre de Mail Merge** :
- Cliquer sur "**Fichier > Mail Merge**"

- **Source des données** : Sélectionnez votre fichier CSV.
- **Mode de livraison** : Choisissez `Enregistrer comme brouillon` (recommandé pour tester) ou `Envoyer plus tard` (recommandé pour vérifier avant l'envoie).
- **Encodage des données** : UTF-8.
- **Séparateur** :
- `;` pour Excel
- `;` pour LibreOffice Calc
- Cliquez sur `Aperçu` pour vérifier les données.
3. **Génération des messages** :
- Une fois satisfait du résultat, cliquez sur `OK`. Les messages personnalisés seront enregistrés dans le dossier `Brouillons`.
---
## Étape 3 : Envoi des e-mails
1. **Vérifiez les messages générés** :
- Allez dans le dossier `Brouillons`.
- Ouvrez un message pour vérifier la personnalisation.
2. **Envoyez les messages** :
- Une fois vérifiés, sélectionnez les messages dans le dossier `Brouillons`.
- Cliquez sur `Envoyer`.
---
## Étape 4 : Résolution des problèmes courants
1. **Adresses incorrectes** :
- Vérifiez que les adresses email sont valides (ex. : `nom@domaine.fr`).
2. **Erreurs d’encodage** :
- Assurez-vous que le fichier CSV est encodé en UTF-8.
3. **Limites du serveur d’envoi** :
- Si vous avez beaucoup de destinataires, divisez les envois en lots.
---
## Conseils avancés pour les utilisateurs expérimentés
1. **Ajout de pièces jointes personnalisées** :
- Ajoutez une colonne au fichier CSV avec le chemin des fichiers (ex. : `/documents/facture1.pdf`).
- Dans Mail Merge, activez l’option `Pièces jointes` et sélectionnez la colonne appropriée.
2. **Utilisation de formules conditionnelles** :
- Exemples de personnalisation avancée dans le corps du texte :
- `Cher {{Prénom}}` (si `Genre` = homme).
- `Chère {{Prénom}}` (si `Genre` = femme).
---
# Annexes
## Installer l'extention Mail Merge
1. **Extension Mail Merge** installée. [Téléchargez ici](https://addons.thunderbird.net/fr/thunderbird/addon/mail-merge/).
1.1. Télécharger la version compatible avec le courrielleur (cliquer sur "**autre version**"), ici la bonne version de mailmerge à télécharger est la 5.6.0

**1.2. Installer l'extention Mailmerge**
1. aller dans **"outils"** puis **"Modules complémentaires"**
2. Cliquer sur la roue crentée puis sur **"Installer un module depuis un fichier"**
3. Sélectionner le fichier téléchargé précédement,
4. installer le module,
5. Un redémarrage cu courrielleur est nécessaire pour finaliser l'installation.

---
## Préparation d'un fichier de données (CSV)
1. **Créer le fichier source** :
- Ouvrez un tableur (LibreOffice Calc ou Excel).
- Saisissez les informations des destinataires dans des colonnes, avec des en-têtes clairs, par exemple :
- `Email` (adresse email)
- `Prénom`
- `Nom`
- `EPLEFPA`
Exemple de tableau :
| Email | Nom |Prénom | Filière | Centre_Examen | Date_Examen | Heure_Examen | Fichier |
| ------------------- | ------ | ------ |--------|----|----|----------------- | --- |
| jean.dupont@test.fr | Jean | Dupont | STAV |Toulouse-Auzeville|08/06/2025|15h00| C:\Users\romain.silvasi\Documents\Formation MailMerge\Test 01.pdf |
| marie.curie@test.fr | Marie | Curie | SAPAT |Narbonne |07/06/2025|10h30| C:\Users\romain.silvasi\Documents\Formation MailMerge\Test 02.pdf |
:::warning
**Joindre un document en pièce jointe :**
si vous souhaitez joindre un document à votre email, il faut indiquer précisément le chemin du document. Pour cela voilà comment faire :
Aller dans le dossier contenant les documents,
- 01 clic droit sur le document,
- 02 propriétés,
- 03 sélectionner l'onglet sécurité,
- 04 sélectionner le chemin du document et copier le,
- 05 coller le chemin dans votre fichier CSV dans la colonne "Fichier",

:::
2. **Enregistrez le fichier** au format CSV :
- Cliquez sur `Fichier > Enregistrer sous`.
- Sélectionnez le format `CSV (.csv)` et choisissez l’encodage UTF-8 (obligatoire pour éviter les erreurs).
- Sélectionner le séparateur de champ : le point virgule "**;**"
---
## Correspondances Carnet d'adresse Mel
| **Variable (anglais)** | **Description (français)** |
|------------------------------|------------------------------------------------------------|
| `{{DisplayName}}` | **Nom complet affiché** |
| `{{FirstName}}` | **Prénom** |
| `{{LastName}}` | **Nom de famille** |
| `{{NickName}}` | Surnom |
| `{{NamePrefix}}` | Préfixe du nom (ex. : M., Mme.) |
| `{{NameSuffix}}` | Suffixe du nom (ex. : Jr., III) |
| `{{AdditionalNames}}` | Noms supplémentaires (autres prénoms) |
| `{{PrimaryEmail}}` | **Adresse e-mail principale** |
| `{{SecondEmail}}` | Deuxième adresse e-mail |
| `{{HomePhone}}` | Téléphone domicile |
| `{{WorkPhone}}` | Téléphone professionnel |
| `{{CellularNumber}}` | Téléphone mobile |
| `{{FaxNumber}}` | Numéro de fax |
| `{{PagerNumber}}` | Numéro de bippeur |
| `{{HomeAddress}}` | Adresse domicile |
| `{{HomeCity}}` | Ville domicile |
| `{{HomeState}}` | Région ou département domicile |
| `{{HomeZipCode}}` | Code postal domicile |
| `{{HomeCountry}}` | Pays domicile |
| `{{WebPage2}}` | Deuxième page Web (personnelle ou autre) |
| `{{WorkAddress}}` | Adresse professionnelle |
| `{{WorkCity}}` | Ville professionnelle |
| `{{WorkState}}` | Région ou département professionnel |
| `{{WorkZipCode}}` | Code postal professionnel |
| `{{WorkCountry}}` | Pays professionnel |
| `{{WebPage1}}` | Première page Web professionnelle |
| `{{JobTitle}}` | **Poste ou fonction** |
| `{{Department}}` | **Département ou service** |
| `{{Company}}` | **Entreprise ou organisation** |
| `{{Custom1}}` | Champ personnalisé 1 |
| `{{Custom2}}` | Champ personnalisé 2 |
| `{{Custom3}}` | Champ personnalisé 3 |
| `{{Custom4}}` | Champ personnalisé 4 |
| `{{Notes}}` | Notes associées au contact |
| `{{BirthYear}}` | Année de naissance |
| `{{BirthMonth}}` | Mois de naissance |
| `{{BirthDay}}` | Jour de naissance |
| `{{AnniversaryYear}}` | Année de l'anniversaire |
| `{{AnniversaryMonth}}` | Mois de l'anniversaire |
| `{{AnniversaryDay}}` | Jour de l'anniversaire
---
## Pour aller plus loin : Les formules conditionnelles
Cette fonction permet de personnaliser le courriel selon des conditions, des filtres. Par exemple :
**dans le champ expéditeur :**
{{Premium|X|{{Email}}}} envoie seulement un email aux adresse dont le champ Premium contient un "X"