# MailerLite

[MailerLite](https://www.mailerlite.com/) est un service de campagnes e-mail. L'extension y
ajoute les contacts rattachés à vos clients, dans le groupe de votre choix, et tient à jour
leurs informations à chaque modification dans Altoviz.

**Elle n'envoie pas vos documents.** Pour expédier vos devis et factures par MailerLite,
utilisez l'extension [SMTP](/fr/reference/extensions/smtp) avec le fournisseur MailerLite ; ou
l'extension [MailerSend](/fr/reference/extensions/mailersend), le service d'envoi du même
éditeur.

## Y accéder

Menu **Extensions**, puis **MailerLite**, ou directement
[https://app.altoviz.com/go/addons/mailerlite](https://app.altoviz.com/go/addons/mailerlite).

![Écran de l'extension MailerLite, groupe et champs choisis](./mailerlite.jpg)

## Champs

**Clé d'API** _(obligatoire)_ : le jeton créé dans MailerLite, rubrique **Integrations ›
MailerLite API**, par **Generate new token**. Une fois enregistré, il ne se modifie plus :
pour en changer, déconnectez l'extension puis raccordez-la de nouveau.

**Groupe** : le groupe MailerLite auquel les contacts sont ajoutés. **Tant qu'aucun groupe
n'est choisi, rien n'est synchronisé.** Vous pouvez en créer un dédié, nommé par exemple
« Altoviz », pour distinguer ces contacts de vos autres abonnés.

**Champs mis à jour** : les champs MailerLite qu'Altoviz remplit. Seuls ceux qu'Altoviz sait
remplir sont proposés — voir le tableau ci-dessous. Un champ non coché n'est jamais modifié.

**Déconnecter** : arrête la synchronisation. Les abonnés déjà créés restent dans MailerLite.

## Correspondance des champs

La correspondance se fait sur la **clé** du champ MailerLite, visible dans MailerLite,
rubrique **Subscribers › Fields**. Les champs de la première partie existent dans tout compte
MailerLite ; pour les autres, créez un champ dont la clé figure dans la colonne de droite.

| Information Altoviz                     | Clé du champ MailerLite                               |
| --------------------------------------- | ----------------------------------------------------- |
| Prénom du contact                       | `name` (champ par défaut), `prenom`, `first_name`     |
| Nom du contact                          | `last_name` (champ par défaut), `nom`, `lastname`     |
| Entreprise du contact                   | `company` (champ par défaut), `societe`, `entreprise` |
| Téléphone du contact                    | `phone` (champ par défaut), `telephone`               |
| Ville de l'adresse de facturation       | `city` (champ par défaut), `ville`                    |
| Code postal de l'adresse de facturation | `z_i_p` (champ par défaut), `code_postal`, `zip`      |
| Pays de l'adresse de facturation        | `country` (champ par défaut), `pays`                  |
| Mobile du contact                       | `mobile`, `sms`                                       |
| Civilité du contact                     | `civilite`, `title`                                   |
| Fonction du contact                     | `fonction`, `job_title`, `poste`                      |
| Nom complet du contact                  | `nom_complet`, `full_name`                            |
| Adresse de facturation complète         | `adresse`, `address`, `adresse_facturation`           |
| Adresse de livraison complète           | `adresse_livraison`, `shipping_address`               |
| Pays de livraison                       | `pays_livraison`, `shipping_country`                  |
| Identifiant du contact dans Altoviz     | `id_interne`, `internal_id`                           |

Un contact sans prénom ni nom — une entreprise, un service — reçoit le **nom de l'entreprise**
dans `name`, le champ que les modèles MailerLite utilisent pour saluer.

## Ce qui se passe ensuite

À chaque création ou modification d'un contact rattaché à un client, Altoviz crée l'abonné
dans MailerLite, ou met à jour celui qui a la même adresse e-mail, et l'ajoute au groupe
choisi. L'identifiant de l'abonné est conservé sur le contact, dans ses métadonnées, sous
« Identifiant MailerLite ».

## Limites et cas particuliers

**Les contacts existants ne sont pas repris d'un coup.** Seuls les contacts créés ou modifiés
après le raccordement sont synchronisés. Pour reprendre les autres, importez-les dans
MailerLite depuis un export de vos clients.

**Un contact sans adresse e-mail est ignoré**, de même que les contacts des fournisseurs et
des collaborateurs.

**Une désinscription est respectée.** Un abonné qui s'est désinscrit de vos campagnes le reste,
même si son contact est modifié dans Altoviz.

**Une information vide n'efface rien.** Si le téléphone d'un contact est vide dans Altoviz, la
valeur saisie dans MailerLite est conservée.

**Changer de groupe** ne déplace pas les abonnés déjà synchronisés : ils restent dans l'ancien
groupe, et rejoignent le nouveau à leur prochaine modification.

**Groupe supprimé dans MailerLite** : la synchronisation échoue pour tous les contacts et
l'extension passe en erreur. Choisissez un autre groupe. Une clé révoquée produit une erreur
d'authentification : déconnectez l'extension et raccordez-la avec une nouvelle clé.

**Une adresse refusée par MailerLite** — mal formée, par exemple — ne bloque que ce contact ;
l'extension reste en état de marche.