E-mail par API ou par SMTP : quand choisir quoi ?
Choisissez SMTP quand c'est un logiciel existant qui envoie le courrier et que vous ne pouvez que modifier des réglages : une boutique, un logiciel de facturation, un CRM, un scanner. Choisissez l'API quand vous développez vous-même et voulez savoir pour chaque message ce qu'il est devenu, quand vous voulez une erreur immédiate plutôt qu'un rebond des heures plus tard, ou quand vous remettez de grandes quantités en une fois. Les deux ne s'excluent pas : la plupart des entreprises utilisent les deux, chacun avec son propre identifiant.
Ce que les deux ont en commun
Les deux remettent votre message à la même infrastructure d'envoi, avec la même authentification pour votre domaine, la même réputation et le même journal. La différence est dans le chemin : SMTP est le protocole que chaque programme de messagerie et chaque logiciel parlent depuis trente ans ; une API e-mail est une interface web où votre propre code présente un message sous forme de données structurées et reçoit une réponse immédiate.
Quand SMTP est le bon choix
- Vous ne pouvez rien programmer, seulement configurer. WordPress, WooCommerce, Odoo, PrestaShop, Magento, Microsoft 365, un scanner : tous ont un champ pour le nom de serveur, le port et l'identifiant. Remplissez-le et ça fonctionne.
- Le logiciel vient d'un fournisseur. Qui ne gère pas le code ne peut pas ajouter d'appel API, mais peut modifier les réglages SMTP.
- Votre framework a déjà une couche mail. Laravel, Symfony et la plupart des autres envoient via un transport SMTP intégré. Une ligne dans la configuration suffit.
- Le volume est modeste et les messages simples. Une réinitialisation de mot de passe, une confirmation, une notification : SMTP fait ça très bien.
L'inconvénient de SMTP, c'est la réponse limitée. Le serveur dit « accepté » et le reste vous parvient plus tard, via le journal ou un rebond. Une connexion SMTP est aussi relativement lente quand vous voulez y faire passer des milliers de messages : chacun ouvre un dialogue avec le serveur.
Quand l'API est le bon choix
- Vous voulez savoir tout de suite si ça a marché. L'API répond immédiatement avec un identifiant unique par message, ou avec une erreur claire : adresse invalide, champ manquant, quota atteint. Votre code peut réagir au lieu d'attendre un rebond pendant des heures.
- Vous envoyez beaucoup en une fois. Un appel avec mille destinataires est plus rapide et plus fiable que mille dialogues SMTP, et votre application n'a pas à gérer de file d'attente.
- Vous voulez joindre des métadonnées à chaque message. Un numéro de client, une campagne, un numéro de commande, pour savoir immédiatement de quel client il s'agit en cas de rebond ou de plainte.
- Vous voulez recevoir les événements. Livraison, rebond, ouverture, plainte : par webhooks signés, ils arrivent dans votre système, reliés à l'identifiant reçu à l'envoi.
- Vous voulez séparer l'envoi du serveur applicatif. Pas de file de mail sur votre propre serveur, pas de ports ouverts, juste un appel web.
L'inconvénient de l'API, c'est qu'il faut du code. Pour un développeur, c'est un après-midi de travail, mais ce n'est pas un réglage qu'un administrateur modifie en passant.
Trois exemples concrets
Une boutique sur WooCommerce envoie ses confirmations de commande via SMTP, parce que l'envoi est dans le logiciel. La newsletter passe par le gestionnaire de campagnes de la plateforme. Aucun code nécessaire.
Une application SaaS envoie des milliers de notifications par jour, veut savoir par client si elles sont arrivées et veut avertir le client dans l'interface dès un rebond permanent. C'est l'API, avec des webhooks vers l'application.
Un cabinet comptable utilise un logiciel qui envoie via SMTP, et dispose en plus d'un portail maison qui remet des documents via l'API et affiche le statut de livraison au gestionnaire de dossier. Deux identifiants, un domaine, un tableau de bord.
Ce que vous réglez dans les deux cas
Un identifiant ou une clé distincte par application, pour pouvoir en révoquer un sans toucher aux autres. SPF et DKIM pour votre domaine. Une adresse d'expéditeur fixe par application. Et un œil sur le journal la première semaine après la connexion. Le choix entre API et SMTP est un choix technique ; la livraison dépend de la même base de délivrabilité.
Questions fréquentes
L'API est-elle livrée plus vite que SMTP ?
La livraison chez le destinataire est identique. L'API est plus rapide pour remettre de grandes quantités et pour obtenir une réponse.
Puis-je passer plus tard de SMTP à l'API ?
Oui. Les deux utilisent le même domaine et la même authentification ; vous ajoutez une clé et adaptez le code quand vous êtes prêt.
Faut-il un développeur pour l'API ?
Oui, même si la connexion est simple : un appel web avec une clé et le contenu du message. Pour les logiciels sans code propre, SMTP reste la voie.