Premiers pas avec l'API transactionnelle Flexmail
L'API transactionnelle de Flexmail vous permet d'envoyer des e-mails déclenchés en un-à-un depuis votre application — confirmations de commande, réinitialisations de mot de passe, factures et tout autre message déclenché en réponse à une action spécifique de l'utilisateur. Vous pouvez envoyer via HTTP (API REST) ou SMTP, en utilisant le même compte et les mêmes identifiants pour les deux.
Le produit transactionnel fonctionne indépendamment du produit marketing de Flexmail. Vous pouvez l'utiliser seul, sans configurer de campagnes ni de listes de contacts.
Attention l'API transactionnelle ne prend en charge qu'un seul destinataire par message. Elle ne peut pas être utilisée pour des envois en masse ou marketing. Consultez « E-mail marketing vs e-mail transactionnel » pour l'explication complète.
Prérequis
Un compte Flexmail. Vous en avez besoin pour utiliser l'API transactionnelle, même si vous n'envoyez que des e-mails transactionnels et n'utilisez pas les fonctionnalités marketing. Un accès aux paramètres DNS de votre domaine pour configurer l'authentification e-mail. Un accès développeur à votre application ou à votre système d'envoi pour intégrer l'API ou configurer SMTP.
Étape 1 : activer le produit transactionnel
Si vous disposez déjà d'un compte Flexmail, activez le produit transactionnel depuis le widget du tableau de bord. La période d'essai vous offre jusqu'à 1 000 envois sur 30 jours, sans frais. Vous pouvez passer à un abonnement transactionnel payant à tout moment, pendant ou après la période d'essai.
Si vous n'avez pas encore de compte, inscrivez-vous sur flexmail.be/en/signup. Vos abonnements marketing et transactionnel sont gérés depuis le même compte.
Attention vous n'avez pas besoin d'un abonnement marketing pour utiliser le produit transactionnel. Si vous souhaitez uniquement envoyer des e-mails transactionnels, vous pouvez activer le produit transactionnel et laisser les fonctionnalités marketing inutilisées.
Étape 2 : vérifier votre adresse d'expéditeur
Avant de pouvoir envoyer, vous devez vérifier l'adresse e-mail que vous utiliserez dans le champ « De ».
- Allez dans Configuration, puis Ajouter ou supprimer des expéditeurs.
- Ajoutez l'adresse e-mail depuis laquelle vous souhaitez envoyer.
- Flexmail envoie un e-mail de vérification à cette adresse ; cliquez sur le lien pour confirmer. Cela prouve que vous êtes bien le propriétaire de la boîte de réception depuis laquelle vous envoyez.
Étape 3 : configurer l'authentification e-mail
Configurez SPF, DKIM, DMARC et un return-path personnalisé pour le domaine de votre adresse d'expéditeur. Ces enregistrements DNS prouvent que vos e-mails proviennent bien de vous, ce qui permet aux fournisseurs de messagerie comme Gmail de décider de livrer votre e-mail dans la boîte de réception ou de le rejeter.
Les instructions détaillées de configuration DNS sont disponibles dans la documentation de l'API E-mail de Flexmail, sous la section Authentification e-mail.
Attention l'authentification e-mail n'est pas optionnelle pour l'e-mail transactionnel. Sans enregistrements SPF et DKIM correctement configurés, vos e-mails transactionnels échoueront aux contrôles d'authentification chez les principaux fournisseurs de messagerie et risquent d'être rejetés ou envoyés en spam.
Étape 4 : créer un jeton d'accès personnel
L'API transactionnelle utilise l'authentification HTTP Basic. Votre identifiant de compte est le nom d'utilisateur ; un jeton d'accès personnel est le mot de passe. Ces identifiants sont réservés à l'API HTTP — SMTP utilise des identifiants distincts, fournis par Flexmail sur demande.
- Allez dans Configuration, puis API, puis Jetons d'accès personnels.
- Cliquez sur Créer un nouveau jeton et donnez-lui un nom descriptif.
- Copiez le jeton et conservez-le en lieu sûr. Il ne sera plus affiché.
Étape 5 : choisir votre méthode d'envoi
Flexmail prend en charge deux manières d'envoyer des e-mails transactionnels. Les deux utilisent le même identifiant de compte et le même jeton d'accès personnel.
API HTTP
L'API REST vous offre le plus de contrôle. Vous pouvez envoyer des messages, gérer des modèles, traiter des Webhooks et récupérer les données de livraison par programmation. C'est l'approche recommandée pour les intégrations et applications sur mesure.
La documentation complète est disponible sur email-api.flexmail.eu/documentation. La section Premiers pas inclut un exemple curl que vous pouvez exécuter immédiatement pour vérifier votre configuration.
SMTP
Les envois SMTP sont inclus dans le produit transactionnel sans frais supplémentaires. Utilisez SMTP lorsque votre application ou plateforme le prend déjà en charge — par exemple, un CMS, une plateforme e-commerce ou un système hérité qui envoie des e-mails via un relais SMTP. Consultez « Envois SMTP pour l'e-mail transactionnel » pour les paramètres de connexion et les instructions de configuration.
Étape 6 : intégrer à votre application
Une fois l'envoi test réussi confirmé, vous êtes prêt à intégrer l'API à votre application. La documentation complète couvre :
- L'envoi de messages : tous les paramètres pour l'endpoint d'envoi.
- Les Webhooks — notifications d'événements en temps réel pour les envois, livraisons, bounces, ouvertures et clics. Consultez « Webhooks transactionnels » pour la configuration et la référence des événements.
Conseil support mettez en place la gestion des Webhooks dès le début de votre intégration. Savoir quand un e-mail transactionnel rebondit vous permet d'agir immédiatement, de marquer l'adresse dans votre système, de déclencher une notification de suivi ou d'alerter votre équipe, plutôt que de découvrir un problème de livraison plusieurs jours plus tard.