L’API de Migma est désormais officiellement disponible. Générez des e-mails conformes à votre image de marque, testez-les sur plus de 40 véritables appareils et automatisez vos flux de travail à partir d’un point de terminaison unique.
L’API de Migma génère des e-mails prêts pour la production et fidèles à votre marque en 30 secondes environ, à partir d’une simple consigne textuelle. Elle s’appuie sur une mémoire de marque enregistrée et renvoie du code React Email. Elle valide également le rendu sur plus de 40 appareils réels, prend en charge le multilingue en un seul appel et propose une intégration sans code avec n8n pour des scénarios comme la relance de paniers abandonnés.
Les développeurs passent des décennies à se battre contre « le problème de l’e-mail ». Mises en page en tableaux. Support CSS qui varie selon plus de 40 clients de messagerie. Outlook pour ordinateur qui continue de restituer le HTML via le moteur de Microsoft Word, une anomalie persistante depuis 2007.
Le coût n’est pas seulement technique. Chaque e-mail mobilise un designer, un rédacteur, un développeur et passe par une phase de recette avant d’être expédié. D’après le rapport State of Email Workflows de Litmus, 62 % des équipes marketing ont besoin de deux semaines ou plus pour concevoir un seul e-mail.
Nous levons aujourd’hui le voile. L’API de Migma est désormais accessible à tous.
Cet article détaille les fonctionnalités de l’API, ses principaux points de terminaison et la méthode pour envoyer votre premier e-mail de production en moins de 5 minutes.
Pourquoi opter pour l’e-mail programmatique ?
Le flux de travail traditionnel ressemble à une chaîne de transmissions : Figma pour le design, ChatGPT pour la rédaction, codage HTML manuel, tests dans Litmus, puis importation dans un ESP. Chaque maillon ajoute du délai, et chaque transmission crée un écart par rapport à l’original.
| Flux de travail traditionnel | Avec l’API de Migma |
|---|---|
| 5 outils, 4 transmissions | 1 point de terminaison |
| De quelques heures à plusieurs jours par e-mail | ~30 secondes pour la génération |
| Tests manuels sur les clients mail | Aperçus automatisés sur de vrais appareils |
| Dérives de marque entre chaque e-mail | Mémoire de marque centralisée par projet |
Grâce à l’API, vous pouvez :
- Générer des contenus alignés sur votre marque en exploitant une mémoire de marque spécifique à votre projet.
- Automatiser l’importation de votre identité visuelle depuis n’importe quelle URL pour garder vos styles synchronisés.
- Valider le rendu automatiquement sur plus de 40 véritables appareils.
Pour être tout à fait précis : ces 30 secondes couvrent la création de la campagne, pas le cycle d’envoi complet. L’acheminement reste l’affaire de votre ESP. Mais lorsque le temps de production moyen se mesure en semaines, réduire l’étape de création à quelques secondes redéfinit ce que l’e-mail peut apporter à votre produit.
Les points de terminaison clés pour votre stack
L’API a été pensée pour être aussi intuitive que la plateforme elle-même. Voici les piliers de l’expérience développeur Migma.
1. Génération assistée par IA
Point de terminaison : POST /v1/projects/emails/generate
C’est ici que la magie opère. La « mémoire de marque » signifie que l’API récupère le contexte de marque stocké et associé à votre projectId : couleurs, ton, logo et campagnes passées. Vos consignes restent concises puisque le contexte est déjà intégré. Une consigne telle que « Créer une annonce de soldes d’été » suffit, car le système sait déjà à quoi doivent ressembler vos soldes.
Le résultat fourni est du code React Email prêt pour la production. React Email s’avère incontournable car il repose sur des composants et compile un HTML s’affichant de manière fiable sur l’ensemble des clients de messagerie, y compris les plus récalcitrants.
| \ |
|---|
| Paramètre | Rôle |
|---|---|
| projectId | Limite la génération à votre mémoire de marque |
| prompt | Descriptif de la campagne en langage naturel |
| webMode | Génère une version hébergée sur le web en plus de l’e-mail |
| languages | Renvoie des variantes localisées en un seul appel |
Le tableau des langues mérite qu’on s’y attarde. L’étude Can’t Read, Won’t Buy de CSA Research révèle que 76 % des acheteurs en ligne privilégient les produits présentés dans leur langue maternelle. La localisation a toujours été un atout précieux, mais son coût restait élevé. Transmettre ["en", "es", "de"] dans une seule requête transforme cette option complexe en un standard par défaut.
La réponse renvoie le code React Email généré ainsi que le code HTML compilé, prêts à être transmis à votre plateforme d’envoi.
2. Aperçus sur de vrais appareils
Point de terminaison : POST /v1/emails/previews
Les émulateurs ne font qu’approcher la réalité. Le matériel réel ne ment pas. Ce point de terminaison déclenche des captures d’écran automatisées de votre e-mail sur de véritables appareils et clients mail, y compris les versions héritées d’Outlook, pour éliminer toute incertitude quant à la dégradation de votre code sur le terrain.
| const preview = await fetch('https://api.migma.ai/v1/emails/previews', { |
|---|
Les résultats prennent la forme d’URL pointant vers les captures d’écran rendues, ce qui vous permet de les injecter directement dans un circuit de validation ou un canal Slack avant qu’un message ne touche un abonné. C’est la phase de recette qui exigeait autrefois un outil payant et une interminable check-list, désormais condensée en un seul appel.
Automatisation sans code : intégration n8n
Tout le monde ne code pas, et c’est bien normal. L’intégration n8n de Migma intègre ce même moteur au cœur d’une interface visuelle. Les nœuds Migma s’insèrent dans vos flux n8n aux côtés des déclencheurs de vos outils habituels.
Deux cas d’usage à adopter :
- Lancement de produit : Un produit est ajouté sur Shopify → un e-mail d’annonce aux couleurs de la marque est généré → le tout est routé vers un collaborateur pour validation.
- Relance de panier : Un panier est abandonné → un e-mail de récupération est rédigé dans la langue du client → le message est transmis à votre ESP.
Ce second scénario pèse plus lourd qu’il n’y paraît. La méta-analyse de 50 études réalisée par le Baymard Institute établit le taux d’abandon de panier moyen à 70,22 %. Environ 7 paniers sur 10 ne se convertissent jamais. Un e-mail de relance rapide, fidèle à l’image de marque et rédigé dans la bonne langue représente l’un des leviers d’automatisation les plus rentables en e-commerce, et sa mise en place ne requiert désormais plus la moindre ligne de code.
Ce que vous pouvez créer
Raisonnez en termes de schémas d’utilisation, pas seulement de fonctionnalités.
| Cas d’usage | Déclencheur | Prise en charge par l’API |
|---|---|---|
| Campagnes comportementales | Événement utilisateur dans votre application | Génération + localisation |
| Lancements e-commerce | Webhook Shopify / WooCommerce | E-mails dynamiques aux couleurs de la marque |
| Envois déclenchés par le CRM | Action dans un tableau de bord interne | E-mail haute fidélité via un appel API unique |
Exemple concret pour la première ligne : une application SaaS émet un événement lorsqu’un utilisateur termine son parcours d’intégration (onboarding). Votre backend appelle le point de terminaison de génération avec une consigne du type « Félicitez l’utilisateur pour la fin de sa configuration et suggérez-lui la prochaine fonctionnalité ». L’e-mail qui parvient au destinataire respecte votre charte graphique, son ton est parfaitement naturel, et il a été expédié sans qu’aucun outil de design n’ait été ouvert.
Guide de démarrage rapide : opérationnel en 5 minutes
- Récupérez votre clé API dans Paramètres (Settings) → Intégration API (API Integration).
- Importez votre marque via une URL pour que le moteur assimile vos couleurs, votre ton et votre logo.
- Appelez le point de terminaison de génération en renseignant votre
projectIdet votre consigne. - Lancez un aperçu (optionnel) pour valider le rendu avant l’envoi.
Explorez l’ensemble de la documentation sur docs.migma.ai et rejoignez la communauté des développeurs sur Discord.
Récupérez votre clé API et envoyez votre premier e-mail dès aujourd’hui.
Conclusion : l’e-mail comme brique d’infrastructure
La création d’e-mails est restée artisanale bien après la programmmatisation du reste de la stack technique. Les paiements disposent d’une API. La recherche dispose d’une API. La messagerie dispose d’une API. Le design et la validation des e-mails sont quant à eux restés figés dans un cycle de deux semaines jalonné de transmissions, une réalité que confirment les données de Litmus pour la majorité des équipes.
L’API de Migma comble cet écart. Un premier point de terminaison génère du code React Email prêt pour la production à partir de votre mémoire de marque. Un second valide le rendu sur plus de 40 appareils réels avant toute validation d’envoi. L’intégration n8n étend ces possibilités aux équipes qui ne touchent jamais au code. Ce qui constituait autrefois un projet à part entière se résume désormais à une requête et une réponse.
Le démarrage rapide prend cinq minutes. Obtenez votre clé API, importez votre marque et effectuez votre premier appel. La documentation sur docs.migma.ai couvre le reste, et la communauté Discord vous accompagne en cas de blocage.
Petite anecdote : les images et les textes de cet article ont été générés par Migma.
Chaque e-mail conçu manuellement vous coûte de précieuses heures. Votre premier appel à Migma ne prend que 30 secondes. Obtenez votre clé API dès maintenant.
FAQ
- Que fait l’API de Migma ?
L’API de Migma génère des e-mails prêts pour la production et fidèles à votre image à partir d’une consigne textuelle. Elle exploite le contexte de marque mémorisé pour produire du code React Email, valide le rendu sur plus de 40 appareils réels et renvoie des variantes localisées en un seul appel. - L’API de Migma remplace-t-elle mon fournisseur d’envoi d’e-mails ?
Non. Migma se positionne en amont de votre ESP. L’API gère la création des e-mails et la validation du rendu. Votre prestataire actuel (SendGrid, Resend ou Mailchimp par exemple) s’occupe de l’acheminement effectif. - Quel format est renvoyé par l’API de Migma ?
Le point de terminaison de génération renvoie du code React Email prêt pour la production, lequel compile un code HTML qui s’affiche de manière fiable sur l’ensemble des clients de messagerie. - Puis-je utiliser Migma sans coder ?
Oui. L’intégration n8n de Migma vous permet de concevoir des flux d’e-mails automatisés — comme la synchronisation de produits Shopify ou la récupération de paniers abandonnés — à l’aide de blocs à glisser-déposer. - Comment obtenir une clé API Migma ?
Connectez-vous à Migma, rendez-vous dans les Paramètres, puis dans Intégration API, et générez une clé. Vous pourrez importer votre identité de marque depuis une URL et lancer votre première génération en moins de cinq minutes. - L’API de Migma prend-elle en charge plusieurs langues ?
Oui. Transmettez un tableau de langues dans votre requête de génération, et l’API renverra les versions localisées du même e-mail en un seul appel.
