# MailerSend

[MailerSend](https://www.mailersend.com/) est un service d'envoi d'e-mails transactionnels. Comme
Resend et SendGrid, il expédie vos documents depuis **votre domaine**, sans passer par une boîte.

MailerSend ne gère pas de listes de contacts : pour alimenter vos campagnes, voyez l'extension
[MailerLite](/fr/reference/extensions/mailerlite), qui est un produit distinct du même éditeur.

## Y accéder

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

![Écran de l'extension MailerSend](./mailersend.jpg)

## Disponibilité

Envoyer depuis un autre compte qu'Altoviz demande l'édition **Starter**. En dessous, l'extension
peut être raccordée, mais vos e-mails continuent de partir d'Altoviz.

## Champs

**Jeton d'API** _(obligatoire)_ : le jeton créé dans MailerSend, rubrique **Integrations › API
tokens**, avec l'accès **Email**. Il commence par « mlsn. » : Altoviz refuse tout autre texte,
ce qui évite de coller par erreur le nom du jeton. Il vaut identification : ne le diffusez pas.
Une fois enregistré, il s'affiche masqué ; laissez-le tel quel pour le conserver, ou collez-en
un nouveau.

**Adresse d'expéditeur** _(obligatoire)_ : l'adresse d'où partiront les messages. Son domaine
doit être **vérifié chez MailerSend**, rubrique **Domains**. Sur les offres payantes, une
adresse déclarée comme identité d'expéditeur dans MailerSend convient aussi. Une adresse Gmail
ou Outlook ne peut donc pas être utilisée.

**Nom d'expéditeur** : le nom affiché au destinataire, par exemple le nom de votre entreprise.

## Actions

**Enregistrer** : raccorde le compte, ou met à jour le jeton et l'expéditeur.

**Utiliser par défaut pour mes e-mails** : désigne ce compte comme expéditeur, sans passer par
[Paramètres → E-mails](/fr/reference/parametres/e-mails).

**Envoyer un e-mail de test** : envoie un vrai message, seule preuve que le jeton, le domaine
et l'adresse fonctionnent ensemble.

**Déconnecter** : retire la configuration ; les envois repartent depuis l'adresse d'Altoviz.

## Ce qui se passe ensuite

Le raccordement seul ne change pas l'adresse d'envoi : choisissez ce compte comme expéditeur
dans [Paramètres → E-mails](/fr/reference/parametres/e-mails), ou par **Utiliser par défaut
pour mes e-mails**.

Chaque envoi est ensuite retrouvable dans le tableau de bord MailerSend, rubrique
**Activity**, et depuis l'historique du document dans Altoviz.

## Erreurs et messages

L'extension passe **en erreur** — signalée dans les extensions, et par un e-mail aux
propriétaires du dossier — quand le problème vient du compte et bloque tous les envois :

- **Jeton refusé** ou **jeton sans l'accès Email** : créez un nouveau jeton avec l'accès
  **Email** et collez-le dans l'extension ;
- **domaine d'expédition non vérifié** : terminez la vérification DNS dans MailerSend, rubrique
  **Domains** ;
- **compte en période d'essai** : il n'envoie qu'aux adresses de vos propres domaines vérifiés,
  jamais à vos clients. Faites approuver votre compte dans MailerSend ;
- **compte suspendu** ou accès à l'API désactivé par MailerSend ;
- **envoi suspendu sur le domaine** : MailerSend accepte les messages mais les garde en attente
  jusqu'à ce que vous relanciez l'envoi dans MailerSend.

Tant que l'extension est en erreur, vos e-mails repartent depuis Altoviz. Enregistrer un
nouveau jeton ou une nouvelle adresse lève l'erreur ; le prochain envoi la rétablit si le
problème demeure.

D'autres refus ne concernent qu'un message, et laissent l'extension en état de marche :
adresse de destinataire invalide, type de pièce jointe refusé, trop de destinataires pour votre
compte. Le message d'erreur reprend alors l'explication de MailerSend.

## Limites et cas particuliers

**La vérification du domaine se fait chez MailerSend**, par des enregistrements DNS. Un domaine
non vérifié produit un échec d'envoi qu'Altoviz ne peut pas corriger.

**Liste de suppression.** MailerSend n'écrit plus à une adresse qui a rejeté un message, s'est
désinscrite ou a signalé un indésirable. Si **tous** les destinataires d'un envoi y figurent,
Altoviz vous l'indique et le document n'est pas considéré comme envoyé ; si seuls certains y
figurent, les autres reçoivent le message. La liste se consulte et se corrige dans MailerSend,
rubrique **Suppressions**.

**Quota d'envoi.** Quand le volume inclus dans votre offre MailerSend est épuisé, les envois
sont refusés jusqu'au renouvellement du quota ou à une montée en gamme. L'extension ne passe
pas en erreur pour autant.

**Doublons.** Une même adresse présente en destinataire, en copie et en copie cachée ne reçoit
le message qu'une fois.

**Une seule adresse d'expédition** par dossier, contrairement aux extensions Google et
Microsoft.