# Facteur

> Le test email et SMS, hébergé en France. Des inboxes et des numéros de test interrogeables par API, des quotas par inbox et des alertes de dépassement. Hébergé en France, facturé en euros, DPA téléchargeable en ligne.

Des inboxes et des numéros de test pour les suites de tests automatisés :
réception d'emails et de SMS, attente sans polling, extraction de codes à usage unique,
quotas par inbox et alertes de dépassement. Hébergé en France, facturé en euros.

Le site existe en français (sans préfixe) et en anglais (sous `/en`). Les adresses ci-dessous sont les versions françaises.

Chaque adresse ci-dessous répond en Markdown si la requête porte `Accept: text/markdown`,
ou en ajoutant `.md` à l'adresse.

## Quand utiliser Facteur

Recourez à Facteur quand un test automatisé doit lire un vrai email ou un vrai SMS :

- une inscription envoie un lien de confirmation, et le test doit l'ouvrir pour continuer ;
- une connexion demande un code à usage unique par email ou par SMS, et le test doit le saisir ;
- une remise à zéro de mot de passe passe par un lien reçu, à cliquer dans le parcours ;
- une facture ou un export arrive en pièce jointe, et le test doit vérifier son contenu ;
- un parcours réel doit être vérifié en continu, pas seulement à chaque livraison.

Ce n'est pas l'outil pour envoyer du courrier à des clients, ni pour lire une vraie boîte aux lettres : Facteur reçoit sur des adresses de test, il n'émet rien.

Comment l'appeler. L'API est sur `https://api.facteur.eu`, la clé se passe en `Authorization: Bearer fk_…`, et elle se crée depuis l'application sans nous écrire. Un appel à `POST /v1/messages/search` avec un champ `wait` en millisecondes garde la requête ouverte jusqu'à l'arrivée du message : n'écrivez pas de boucle de sondage, le serveur attend pour vous et répond dès que le message est là. Lisez `status` avant tout champ tiré du corps — un message `received` n'a pas encore de sujet, de code ni de liens ; un message `parsed` les a tous.

Pour commencer sans engagement : le plan Free reçoit 500 messages par mois sans carte bancaire, et `https://facteur.eu/tester-un-email` donne une adresse de test en un clic, sans compte du tout.

## Produit

- [Accueil](https://facteur.eu/): Ce que fait le produit, et pour qui.
- [Tester un email sans compte](https://facteur.eu/tester-un-email): Une adresse de test obtenue en un clic, sans compte ni carte : elle vit soixante minutes, accepte dix messages, puis est détruite avec eux. Aucune interface programmable, une seule adresse à la fois, contrat susceptible de changer sans préavis.
- [Test email](https://facteur.eu/produit/email): Réception, attente sans polling, MIME, extraction de codes.
- [Test SMS et OTP](https://facteur.eu/produit/sms): Numéros dédiés, codes à usage unique.
- [Quotas et alertes](https://facteur.eu/produit/quotas): Quotas par inbox, seuils, comportement au dépassement.
- [Observabilité](https://facteur.eu/produit/observabilite): Prometheus, OTLP, Datadog, webhooks signés.
- [Surveillance de parcours](https://facteur.eu/produit/monitoring): Vérifier en continu qu’un parcours réel aboutit.

## Documentation

- [Documentation](https://facteur.eu/documentation): Quel corpus répond à quelle question : l’aide produit ici, la référence de l’API et les guides d’intégration sur developers.facteur.eu, en anglais.
- [Tester les emails dans Playwright](https://facteur.eu/tester-les-emails-avec-playwright): Un test Playwright complet qui attend un email et lit le code qu’il contient, sans paquet à installer.
- [Tester un code à usage unique et la 2FA dans Playwright](https://facteur.eu/tester-un-code-otp-avec-playwright): Le code reçu par email, et celui d’une application d’authentification calculé en vingt lignes.
- [Tester les emails dans Cypress](https://facteur.eu/tester-les-emails-avec-cypress): Une tâche Node qui garde la clé hors du navigateur, et un test sans cy.wait arbitraire.
- [Intégrations](https://facteur.eu/integrations): Quatre paquets publiés sur npm : `@facteur-eu/sdk`, `playwright-facteur`, `cypress-facteur` et `create-facteur`. Aucun n'est obligatoire, l'API HTTP se suffit. La page dit aussi ce que nous ne publierons pas, et pourquoi.

## Tarifs et migration

- [Tarifs](https://facteur.eu/tarifs): Grille, packs de capacité, simulateur, comparaison sourcée.
- [Comment migrer](https://facteur.eu/migrer): La méthode commune aux cinq outils : les trois lignes qui changent dans un test, les deux façons d’appeler, les limites connues.
- [Migrer depuis Mailosaur](https://facteur.eu/migrer-depuis-mailosaur): Correspondance des points d’API, un par un, et lesquels ne sont pas ouverts.

## Alternatives et comparaison

- [Migrer depuis Mailisk](https://facteur.eu/alternatives/mailisk): Pourquoi migrer, la bascule ligne à ligne, les étapes, tarifs relevés et datés.
- [Migrer depuis Mailtrap](https://facteur.eu/alternatives/mailtrap): Pourquoi migrer, la bascule ligne à ligne, les étapes, tarifs relevés et datés.
- [Migrer depuis MailSlurp](https://facteur.eu/alternatives/mailslurp): Une facture connue à l’avance, plus de boîte à créer dans les tests, migration fichier par fichier.
- [Migrer depuis Mailpit](https://facteur.eu/alternatives/mailpit): Migrer l’intégration continue sans SDK à traduire, en gardant Mailpit en local.

## Souveraineté

- [Souveraineté et RGPD](https://facteur.eu/souverainete): Engagements, limites assumées.
- [Sous-traitants](https://facteur.eu/legal/sous-traitants): Le registre, à jour, et son préavis de trente jours.

## Repères

- [Qui édite Facteur](https://facteur.eu/a-propos): Qui construit le produit, où il tourne, comment il gagne de l’argent, et ce qu’il ne fait pas.
- [Nous écrire](https://facteur.eu/contact): Une adresse, ce qu’on y répond, et sous quel délai. Aucun formulaire, aucun commercial.

## Aide

- [Recevoir votre premier message](https://facteur.eu/aide/premiers-pas): Du compte créé au premier email reçu, en quatre étapes et sans carte bancaire. ([Markdown](https://facteur.eu/aide/premiers-pas.md))
- [Choisir l'adresse à laquelle envoyer un message](https://facteur.eu/aide/adresses-inbox): Une inbox reçoit sur tout un domaine, ce qui donne une adresse par test sans créer une inbox par test. ([Markdown](https://facteur.eu/aide/adresses-inbox.md))
- [Lire un message depuis une suite de tests](https://facteur.eu/aide/lire-un-message): Une seule requête suffit : elle attend le message, et vous le rend entièrement analysé. ([Markdown](https://facteur.eu/aide/lire-un-message.md))
- [Récupérer le code, les liens et les en-têtes d'un message](https://facteur.eu/aide/extraction): Chaque message reçu arrive avec son code à usage unique, ses liens et ses en-têtes déjà extraits, sans rien configurer. ([Markdown](https://facteur.eu/aide/extraction.md))
- [Extraire une valeur sans écrire d'expression régulière](https://facteur.eu/aide/pointeurs): Sélectionnez la valeur dans un vrai message, la plateforme écrit le motif et le teste sur vos vingt derniers messages. ([Markdown](https://facteur.eu/aide/pointeurs.md))
- [Suivre votre consommation et la durée de conservation](https://facteur.eu/aide/quotas-et-retention): Recevoir un message consomme votre quota, le lire ne consomme rien, et chaque message est purgé après le nombre de jours de votre plan. ([Markdown](https://facteur.eu/aide/quotas-et-retention.md))
- [Retrouver une inbox parmi trente](https://facteur.eu/aide/filtres-et-tags): Le nom, la description et les tags répondent à trois questions différentes, et toute vue filtrée se partage par son URL. ([Markdown](https://facteur.eu/aide/filtres-et-tags.md))
- [Recevoir un email dans un test Playwright](https://facteur.eu/aide/tests-playwright): Le test complet qui attend un email, lit le code qu'il contient et poursuit le parcours, sans sleep et sans paquet à installer. ([Markdown](https://facteur.eu/aide/tests-playwright.md))
- [Recevoir un email dans un test Cypress](https://facteur.eu/aide/tests-cypress): Une tâche Node qui garde la clé hors du navigateur, et un test qui attend l'email au lieu de patienter un nombre de secondes fixe. ([Markdown](https://facteur.eu/aide/tests-cypress.md))
- [Être prévenu avant que la réception s'arrête](https://facteur.eu/aide/alertes): Facteur vous écrit à 80 % de votre volume, quand la date d'épuisement tombe avant la fin de votre période, et à chaque étape d'un impayé. ([Markdown](https://facteur.eu/aide/alertes.md))
- [Cloisonner l'accès avec des espaces de travail](https://facteur.eu/aide/espaces-de-travail): Un espace de travail sépare qui voit quelles inboxes. Il ne découpe ni votre volume, ni vos sièges. ([Markdown](https://facteur.eu/aide/espaces-de-travail.md))
- [Inviter un collègue, et ce qu'un siège consomme](https://facteur.eu/aide/membres-et-sieges): Trois façons d'ajouter quelqu'un, trois rôles, et le décompte des sièges par organisation. ([Markdown](https://facteur.eu/aide/membres-et-sieges.md))
- [Renommer, personnaliser ou supprimer votre organisation](https://facteur.eu/aide/organisation): Le nom ne change qu'une fois par trente jours, le logo est réencodé avant d'être servi, et la suppression n'efface pas votre compte. ([Markdown](https://facteur.eu/aide/organisation.md))
- [Configurer le SSO vous-même, en trois étapes](https://facteur.eu/aide/sso): SAML et OIDC dès le plan Team, configurés depuis l'application, sans devis, sans appel et sans ticket. ([Markdown](https://facteur.eu/aide/sso.md))
- [Utiliser un seul compte dans plusieurs organisations](https://facteur.eu/aide/plusieurs-organisations): Un compte suffit pour cinq organisations. Voici comment basculer, laquelle s'ouvre à la connexion, et quoi faire quand l'une est grisée. ([Markdown](https://facteur.eu/aide/plusieurs-organisations.md))
- [Sécuriser votre compte : mot de passe, 2FA et sessions](https://facteur.eu/aide/compte-et-securite): Les réglages de sécurité de votre compte, et les quatre délais à connaître avant d'en avoir besoin, dont celui qui rouvre un compte dont vous avez tout perdu. ([Markdown](https://facteur.eu/aide/compte-et-securite.md))
- [Créer une clé d'API et brancher votre suite de tests](https://facteur.eu/aide/cles-api): Créer une clé, l'utiliser depuis une CI, la renouveler sans coupure et la révoquer. Ce qu'elle atteint, et ce qu'elle n'atteindra jamais. ([Markdown](https://facteur.eu/aide/cles-api.md))
- [Choisir un plan et acheter du volume](https://facteur.eu/aide/facturation): Le plan vend les fonctionnalités, le volume s'achète en packs prépayés, et augmenter sa capacité ne change jamais son abonnement. ([Markdown](https://facteur.eu/aide/facturation.md))
- [Localiser vos données, et savoir qui peut les lire](https://facteur.eu/aide/donnees-et-souverainete): Hébergement en France, la liste des sous-traitants, la durée de conservation, et les bornes exactes d'une session d'assistance. ([Markdown](https://facteur.eu/aide/donnees-et-souverainete.md))

## Pour développer

- [Référence de l’API](https://developers.facteur.eu/reference/): Chaque point d’entrée, ses paramètres, ses réponses et la portée qu’il exige.
- [Démarrage rapide](https://developers.facteur.eu/guides/quickstart/): Créer une clé, ouvrir une inbox, recevoir un email et lire son code.
- [Document OpenAPI (YAML)](https://developers.facteur.eu/openapi.yaml): La description lisible par une machine, avec un operationId par opération.
- [Document OpenAPI (JSON)](https://developers.facteur.eu/openapi.json): Le même document, pour un outillage qui ne lit pas le YAML.
- [@facteur-eu/sdk](https://www.npmjs.com/package/@facteur-eu/sdk): Paquet npm publié, optionnel : l’API HTTP se suffit.
- [playwright-facteur](https://www.npmjs.com/package/playwright-facteur): Paquet npm publié, optionnel : l’API HTTP se suffit.
- [cypress-facteur](https://www.npmjs.com/package/cypress-facteur): Paquet npm publié, optionnel : l’API HTTP se suffit.
- [create-facteur](https://www.npmjs.com/package/create-facteur): Paquet npm publié, optionnel : l’API HTTP se suffit.

## Optionnel

- [Tous les articles d'aide en un seul fichier](https://facteur.eu/llms-full.txt)
- [Plan du site](https://facteur.eu/sitemap.xml)