# Comment migrer vers Facteur

> Ce qui change dans un test quand vous changez d’outil de test email, ligne par ligne, et ce qui ne change pas.
> https://facteur.eu/migrer

## Vos tests gardent leur forme

Le coût d’un changement d’outil de test email, ce n’est pas l’abonnement : c’est la journée passée à réécrire des assertions qui marchaient. Ici, ce sont les trois lignes qui parlent au fournisseur qui changent. Votre test attend toujours un message, et affirme toujours quelque chose sur son contenu.

- Trois lignes par fichier : l’import, le client, l’appel qui attend le message
- Rien à exporter : des messages de test se régénèrent au prochain passage de la suite
- Les deux outils en parallèle le temps de comparer, sans rien résilier

## Le même test, chez l’un puis chez l’autre

L’exemple part de Mailosaur, l’outil d’où viennent le plus de migrations. Depuis Mailtrap, MailSlurp, Mailisk ou Mailpit, la forme est la même : la page de chaque outil donne la correspondance champ par champ.

## Avec notre bibliothèque, ou en appelant l’API

La bibliothèque fait gagner du confort, pas des capacités : tout ce qu’elle fait, un appel HTTP le fait aussi.

- **La bibliothèque, si vous acceptez une dépendance** : Une commande, aucune dépendance de son côté. Le client lit la clé dans FACTEUR_API_KEY, et son appel waitFor tient la connexion ouverte jusqu’à ce qu’un message corresponde : pas de boucle d’attente à écrire, pas de sleep à calibrer.
- **L’appel direct, si vous n’en voulez pas** : Une requête POST sur /v1/messages/search avec un champ wait en millisecondes, et la réponse arrive quand le message arrive. C’est exactement ce que fait la bibliothèque, sans rien installer.

## Cinq étapes, aucune irréversible

Le premier test bascule en dix minutes, et il vous dit si toute la suite basculera.

- **Créez un compte et une inbox** : Une inbox est une boîte qui reçoit, que vos tests interrogent par son identifiant. Le plan gratuit suffit pour valider la migration, et ne demande pas de carte bancaire.
- **Posez la clé d’API dans votre environnement** : Sous le nom FACTEUR_API_KEY, à côté de celle de votre outil actuel. Les deux cohabitent : rien ne vous demande de retirer l’ancienne avant d’être convaincu.
- **Basculez un seul test** : Celui qui vous coûte le plus quand il est instable. Trois lignes à changer, puis vous le lancez : s’il passe, votre suite passera. C’est le moment de vérité et il ne dure pas la journée.
- **Faites tourner les deux suites en parallèle** : Une semaine, le temps de comparer les taux de réussite sur vos propres tests plutôt que sur une page de vente. C’est aussi ce qui rend le retour en arrière gratuit.
- **Posez vos plafonds et vos alertes** : Un plafond de messages par inbox, et un seuil qui avertit avant de l’atteindre : un test parti en boucle s’arrête sur sa propre limite au lieu de consommer la capacité de toute l’équipe.

## Ce qui est propre à l’outil que vous quittez

Chaque page reprend la correspondance des champs, ce qui n’a pas d’équivalent chez nous, et les tarifs relevés à une date écrite en clair.

- **Mailosaur** : La table de conversion des points d’API, un par un, et lesquels ne sont pas encore ouverts.
- **Mailtrap** : Le passage d’un bac à sable qui intercepte à une inbox qui reçoit pour de vrai.
- **MailSlurp** : Ce que devient une inbox créée puis supprimée à chaque test, et la facturation à l’opération.
- **Mailisk** : Le moins cher du marché en face du nôtre, sur le même volume mensuel.
- **Mailpit** : Quitter une interception locale : ce que vous gagnez, et ce que vous perdez à ne plus tout héberger.

## Limites connues

Ce que votre outil actuel fait et que nous ne faisons pas encore. Écrit ici plutôt que découvert au milieu d’une migration.

- Le téléchargement du message brut au format .eml n’est pas ouvert.
- L’analyse de délivrabilité (SPF, DKIM, DMARC, score anti-spam) n’est pas ouverte.
- Les aperçus de rendu dans plusieurs clients de messagerie et l’éditeur visuel de modèles n’ont pas d’équivalent, et n’en auront pas : ce n’est pas le même produit.

Si votre suite dépend de l’un de ces points, écrivez-nous à

## Questions fréquentes