Vos e-mails transactionnels par API
Votre produit écrit à vos utilisateurs — facture, alerte, mot de passe oublié. L'API Mailcheer remplace votre service d'envoi, avec les mêmes champs que celui que vous quittez.
Lis mailcheer.com/app/install et connecte Mailcheer pour moi.Ce que l'agent peut faire
- Envoyer vos e-mails transactionnels : bienvenue, confirmation, facture, alerte.
- Savoir ensuite si le message a été remis, a rebondi, ou a été signalé.
- Ajouter et désinscrire des contacts depuis votre code, double opt-in compris.
- Créer une campagne et l'envoyer, si la clé porte le droit correspondant.
- Ne jamais envoyer deux fois, grâce à l'en-tête d'idempotence.
Ce qu'il ne peut pas faire
- Envoyer quoi que ce soit avec une clé à laquelle vous n'avez pas donné le droit d'envoi.
- Écrire depuis une adresse dont le domaine n'est pas vérifié dans votre espace.
- Envoyer une campagne à quelqu'un qui s'est désinscrit, ou écrire à une adresse revenue en erreur.
- Retirer une adresse de la liste de suppression : aucun outil ne le permet.
- Voir un autre espace que celui de la clé utilisée.
Détails de connexion
| Surface | API REST, appelée depuis votre code — aucune bibliothèque à installer |
|---|---|
| Connexion | Clé d'API en en-tête Bearer, une par service qui appelle |
| Périmètre | Un espace Mailcheer par clé, avec les droits que vous cochez |
| Révocation | Un clic dans Réglages → API, effet au prochain appel |
Trois points à connaître avant de brancher votre code : le domaine de l'expéditeur se vérifie dans votre espace Mailcheer, une adresse revenue en erreur, ou qui vous a signalé comme indésirable, est refusée aussi aux envois unitaires, et ces envois comptent dans le quota mensuel de votre offre.
Connexion en 3 étapes
Créez une clé dans votre espace Mailcheer : Réglages → API → Nouvelle clé, droit « emails:send ».
Posez-la dans les variables d'environnement de votre service, comme n'importe quel secret.
Changez l'adresse de base de vos appels d'envoi. Les champs et la réponse ne bougent pas.
Ce que vous pouvez demander
Six exemples à copier, du premier brouillon à la santé du domaine.
Campagnes
Envoie l'e-mail de bienvenue à chaque nouvelle inscription validée.
Déclenche la campagne d'annonce quand je publie une nouvelle version.
Abonnés
Abonne les nouveaux clients à la liste Produit, avec double opt-in.
Désabonne proprement les comptes supprimés, partout.
Domaine & délivrabilité
Utilise mon sous-domaine d'envoi dédié pour le transactionnel.
Remonte-moi les rebonds dans mon outil de supervision.
Un accès utile, des limites nettes
Une clé, un espace
Chaque clé est liée à un seul espace Mailcheer. Vos autres marques ou clients restent invisibles pour l'agent, sans réglage à faire.
Vous cochez ce que la clé peut faire
Sept droits, choisis à la création : envoyer des e-mails, lire les abonnés, les modifier, lire les campagnes, les envoyer, lire les webhooks, les gérer. Une clé sans le droit d'envoi ne pourra jamais expédier, même si l'agent le demande.
Révocation immédiate
Un clic dans Réglages → API coupe la clé. L'appel suivant est refusé, et les autres clés continuent de fonctionner.
Questions fréquentes
Ici, pas de conversation : c'est votre code qui parle à Mailcheer. Les autres pages branchent un agent que vous pilotez ; celle-ci branche votre produit.
Non. Un appel HTTP ordinaire suffit, dans n'importe quel langage. Le fichier OpenAPI permet d'engendrer un client si vous en voulez un.
Oui, comme les campagnes : c'est le même compte d'envoi et la même facture. L'appel /api/v1/me dit combien d'e-mails il vous reste ce mois-ci.
Oui : une désinscription n'arrête que les envois en nombre, ceux qui portent unsubscribe_url. Une adresse revenue en erreur, ou qui vous a signalé comme indésirable, est refusée à tout envoi, avec le motif. Un seul espace suffit pour le transactionnel et la newsletter.
Une seule sorte de clé, qui envoie pour de vrai : vous ne pouvez pas expédier par erreur avec une clé que vous pensiez de test. Pour essayer, utilisez les adresses du simulateur d'Amazon SES, comme success@simulator.amazonses.com.
Votre produit sait déjà écrire. Donnez-lui une adresse d'envoi.
Lis mailcheer.com/app/install et connecte Mailcheer pour moi.