API de courriel : Guide complet pour envoyer des courriels programmatiquement (2026)

curl --request POST \
  --url https://api.brevo.com/v3/smtp/email \
  --header ’api-key: YOUR_API_KEY’ \
  --header ’content-type: application/json’ \
  --data ’{
    "sender": {
      "name": "Your App",
      "email": "[email protected]"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Customer"
      }
    ],
    "subject": "Welcome to your account",
    "htmlContent": "<h1>Welcome</h1><p>Your account is ready.</p>"
  }’
```Le code de production ne doit pas coder les clés API. Entreposez des secrets dans un gestionnaire secret ou une variable d’environnement, faites-les tourner, limitez l’accès et ne les exposez jamais en code frontend.

## Production Email API Architecture
Une intégration d’API par courriel de production ne devrait pas envoyer directement de chaque contrôleur ou gestionnaire de route.

Utilisez une petite couche de message:

1. Un événement produit se produit.
2. Application écrit l’événement à une file d’attente, travail, ou l’événement bus.
3. Le service d’email cartographie l’événement vers un modèle.
4. Le service de courriel valide les règles de consentement et de suppression des destinataires.
5. Le service d’email appelle l’API du fournisseur.
6. Le service de courriel enregistre l’identifiant du message du fournisseur.
7. Webhooks met à jour l’état du message plus tard.

Cela maintient le code produit propre et rend les erreurs d’email plus faciles à isoler.

Champs internes recommandés :

- "Event id".
- "type message".
- "recevant id".
- "recevant email".
- "template id".
- "locale".
- "fournisseur".
- `provider message id`.
- "Impossible clé".
- "état".
- "code erreur".
- "créé at".
- "sentat".
- "livraison".

Utilisez les clés idempotency pour les messages critiques. Une réessayer ne devrait pas envoyer trois courriels de réinitialisation de mot de passe parce qu’une demande de réseau a pris fin après que le fournisseur a accepté le premier message.

## Meilleures API de messagerie comparées
C’est Brevo.

Brevo est utile lorsque l’email transactionnel fait partie d’un système de communication client plus large.

Choisissez Brevo lorsque :

- Vous avez besoin d’email transactionnel plus campagnes, CRM, automatisation, SMS ou WhatsApp.
- Les données du commerce électronique devraient déclencher des messages sur le cycle de vie.
- Marketing et messagerie de produits doivent partager des profils de contact.
- Les non-développeurs doivent avoir accès aux modèles et aux rapports.
- Vous voulez une plate-forme plutôt que des outils point séparés pour chaque canal.

Veillez à :

- La différence entre la configuration des courriels marketing et transactionnel.
- La propriété du modèle entre l’ingénierie et le marketing.
- Limites tarifaires et contraintes de plan.
- Comment les données de contact sont synchronisées.
- Comment les règles de désabonnement et de suppression s’appliquent à différentes catégories de messages.

La documentation de Brevo couvre l’envoi transactionnel, l’envoi par lots, le mode sandbox, le relais SMTP, les webhooks, les SDK et les pages de référence des API. Utilisez ces documents pour les détails de mise en œuvre.

### SendGrid

SendGrid est un choix commun pour les équipes qui veulent une API de messagerie mature développeur avec un large langage et support de plate-forme.

Choisissez SendGrid lorsque :

- Les développeurs veulent un e-mail familier API et l’écosystème SDK.
- Vous avez besoin d’email transactionnel et marketing du même vendeur.
- Vous avez déjà une infrastructure Twilio.
- Vous avez besoin de webhooks événement et des contrôles d’envoi détaillés.

Veillez à :

- Quelles caractéristiques de livraison et de support sont incluses dans le plan sélectionné.
- Comment les modèles sont gérés à travers les environnements.
- Si l’email marketing et l’email transactionnel doivent partager la même structure de compte.

Un pistolet à courrier

Mailgun est construit autour de l’envoi dirigé par le développeur et API-premier flux de travail.

Choisissez Mailgun lorsque :

- L’ingénierie possède une infrastructure de messagerie.
- Vous avez besoin d’envoi HTTP, de retour SMTP, de logs, d’itinéraires entrants et d’outils de validation.
- Vous voulez un fournisseur explicite sur les opérations de livraison.

Veillez à :

- Quelles caractéristiques de validation, d’analyse et de livraison sont incluses.
- Conservation des données et accès au journal.
- Soutenir les attentes pendant la migration et l’échauffement.

SES Amazonique

Amazon SES est axée sur les infrastructures.

Choisissez Amazon SES lorsque:

- Votre application fonctionne déjà beaucoup sur AWS.
- Vous avez des ressources d’ingénierie à posséder.
- Tu as besoin d’un gros volume de paiement.
- Vous voulez une intégration étroite avec IAM, CloudWatch, SNS, Lambda, ou d’autres services AWS.

Veillez à :

- Enlèvement de la boîte à sable et accès à la production.
- Configuration de l’identité du domaine.
- Bounce et traitement des plaintes.
- Des décisions de propriété intellectuelle spécifiques.
- Surveillance et alerte.
- Le coût d’ingénierie des caractéristiques de construction d’autres fournisseurs incluent dans le produit UI.

SES peut être excellent à l’échelle, mais ce n’est pas le choix le plus bas pour chaque équipe.

Marque postale

Le cachet postal est axé sur le courriel transactionnel.

Choisissez Postmark lorsque :

- La fiabilité transactionnelle et la clarté importent plus que l’ensemble de la commercialisation.
- Vous voulez des flux de messages qui séparent les types d’email.
- Vous avez besoin de modèles, de courriels entrants et d’événements de livraison dans un produit simple.

Veillez à :

- Tarification à votre volume.
- Combien de temps vous avez besoin d’événements et de messages.
- Que le marketing en vrac fasse partie d’un flux ou d’une plateforme séparé.

C’est vrai.

Tajo est pertinent lorsque l’envoi d’e-mails est lié au commerce électronique, aux événements clients et à l’automatisation connectée à Brevo.

Utilisez Tajo lorsque:

- Les événements produits et ecommerce doivent entrer dans Brevo.
- Shopify ou d’autres données commerciales devraient déclencher des messages de panier, de commande ou de cycle de vie abandonnés.
- Vous voulez une seule couche d’intégration pour les données client, commande, produit et événement.
- Vous avez besoin d’un chemin de messagerie transactionnelle documenté connecté à votre modèle de données client plus large.

Tajo ne doit pas remplacer la référence IPA d’un fournisseur. Il devrait réduire le travail d’intégration nécessaire pour obtenir les bonnes données client et événement dans le système de messagerie.

## Quand utiliser une API de messagerie
Courriels transactionnels

Les courriels transactionnels sont déclenchés par une action utilisateur ou un événement système.

Exemples:

- Vérification des comptes.
- Connexion de lien magique.
- Réinitialisation du mot de passe.
- Authentification à deux facteurs.
- Produit invité.
- Confirmation de commande.
- Reçu.
- Confirmation d’expédition.
- Mise à jour de livraison.
- Avis de remboursement.
- Renouvellement de l’abonnement.
- L’alerte a échoué.
- Avis de sécurité.

L’email transactionnel a une forte attente de fiabilité. Les utilisateurs remarquent immédiatement qu’un lien de connexion, un reçu de commande ou un mot de passe réinitialisé n’arrive pas.

Voir aussi : [emails de confirmation de commande](/blog/order-confirmation-email-guide/) et [exemples de courriels transactionnels](/blog/transactional-email-examples/).

Courriels sur le cycle de vie du produit

Les e-mails du cycle de vie s’assoient entre transactionnel et marketing.

Exemples:

- Essai à bord.
- Activation des fonctionnalités.
- C’est la date limite.
- Mise à niveau rapide.
- Rappel de compte inactif.
- Enregistrement du succès client.
- Séquence de renouvellement.
- Message de reconquête.

Ces courriels fonctionnent mieux lorsqu’ils sont déclenchés par des données de produit plutôt qu’un calendrier générique.

Adresses électroniques

Les équipes de commerce électronique ont souvent besoin d’email à la fois transactionnel et marketing :

- Offre de bienvenue.
- Chariot abandonné.
- Parcourez l’abandon.
- De retour en stock.
- Baisse des prix.
- Recommandation produit.
- Rappel de reconstitution.
- Mise à jour sur la loyauté.
- Demande de révision.
- Accès VIP tôt.

Pour les équipes Shopify et Brevo, Tajo peut aider à connecter les données de commande, client, consentement, produit et panier afin que ces messages soient déclenchés par un comportement commercial réel.

### Marketing des courriels via API

Ne traitez pas le courriel de marketing comme un simple travail de bulletin de lot.

Le marketing déclenché par l’API peut supporter:

- Segmentation par événement.
- Des campagnes personnalisées.
- Déclenchement des [séquences de drip](/blog/drip-campaign-guide/).
- Le produit à bord.
- Voyages de cycle de vie basés sur les comptes.
- [Email automatisé](/blog/email automatisé-guide/) lié au comportement du client.

La barre de conformité s’applique toujours. Les messages de marketing nécessitent un consentement approprié, un traitement de refus et des règles de suppression.

## Caractéristiques clés de l’API à rechercher
Authentification et gestion des clés

Une API e-mail sérieuse devrait prendre en charge des clés d’API sécurisées et des documents d’authentification clairs.

Dépenses opérationnelles :

- Des clés séparées par environnement.
- Restreindre l’accès aux clés de production.
- Rotation des clés.
- Conservez les clés en dehors du code.
- Enregistrer l’utilisation de la clé sans enregistrer la valeur de la clé.
- Enlever les clés des décharges de requête ratées.

Modèles

Les modèles maintiennent la cohérence des courriels transactionnels.

Cherchez :

- La version.
- Test envoyé.
- Variables.
- Valeurs de recul.
- Localisation.
- Le rendu de l’aperçu.
- Des processus d’approbation.
- Modèles de mise en scène et de production séparés.

Les modèles ne sont pas seulement des actifs de conception. Ils font partie du contrat de produit. Un modèle de réinitialisation du mot de passe, un modèle de confirmation de commande ou un modèle de facture doit être examiné avec le même sérieux que l’assurance-chômage.

### Boucliers Web

Webhooks transformer en une boucle de rétroaction.

Voie & #160;:

- Traitement.
- Reporté.
- Livré.
- Ouvert, avec prudence.
- Avec prudence.
- Bousculé.
- Lâché.
- Je me suis plaint.
- Désabonnement.

Magasinez les identifiants de message du fournisseur afin que les événements webhook puissent être adaptés aux utilisateurs internes et aux événements.

### Gestion de la répression

La suppression de la manipulation protège la livraison et la conformité.

Le système devrait gérer:

- Ça rebondit.
- Plaintes.
- Désabonnement.
- Des blocs manuels.
- Adresses basées sur le rôle si votre politique les exclut.
- Des contacts non valides.
- Suppression de compte ou demandes de confidentialité.

N’essayez jamais à nouveau une adresse définitivement échouée parce que le code produit ne voit que « envoyer un courriel » comme une tâche de fond.

Limites de taux et débit

Vérifiez comment le fournisseur gère :

- Limites des demandes d’API.
- Passage des messages.
- Les paramètres du lot.
- Limites de bourrage.
- Limites quotidiennes ou mensuelles.
- Un nouveau compte.
- Échauffement IP dédié.

Prévoyez des pics. Un lancement de produit, un incident de réinitialisation de mot de passe, la vente de Black Friday ou une notification de sécurité peuvent créer un volume d’envoi bien supérieur à la moyenne quotidienne.

### Analyse et exportations

Déclaration minimale:

- Envoyé.
- Livré.
- Bousculé.
- Reporté.
- Plaintes.
- Désabonnement.
- Exécution du modèle.
- Erreurs de réponse du fournisseur.
- Événements de revenus ou de conversion, le cas échéant.

Traiter ouvre et clique soigneusement. Les protections de la vie privée, le blocage d’images et l’activité des robots peuvent fausser les mesures d’engagement. Pour les courriels transactionnels, la livraison et l’action réussie de l’utilisateur comptent souvent plus que le taux ouvert.

Parsing entrant

Les courriels entrants sont importants lorsque les utilisateurs répondent ou envoient du contenu dans le produit.

Cas d’utilisation:

- Réponses d’appui.
- Email-to-ticket.
- Réponse au commentaire.
- Des processus d’approbation.
- Reçus.
- Capture de plomb.

Si l’analyse interne fait partie de la feuille de route, choisissez un fournisseur avec des documents clairs, un routage, des contrôles de sécurité et une gestion des pièces jointes.

## Livraison avec une API de messagerie
Une API ne résout pas automatiquement la délivrance.

Vous avez encore besoin :

- SPF.
- DKIM.
- DMARC.
- Domaines d’envoi vérifiés.
- L’identité de l’expéditeur.
- Des listes propres.
- Je me débrouille.
- Traitement des plaintes.
- Effacer le désabonnement aux messages marketing.
- Contenu pertinent.
- Fréquence d’envoi raisonnable.
- Contrôle.

Pour les nouveaux domaines ou IPs, échauffez-vous progressivement. Commencez par le courrier à faible risque et à fort engagement et augmentez le volume à mesure que la réputation se stabilise.

Séparer les types de messages si possible:

- Authentification et sécurité.
- Réceptions et mises à jour de commande.
- Cycle de vie des produits.
- Commercialisation.
- Des promotions en vrac.

Ne laissez pas une campagne de promotion agressive endommager mot de passe réinitialiser ou recevoir la livraison.

## Gestion des erreurs et retraits
Les échecs de l’API par courriel doivent être classifiés.

Réessayez :

- Temps mort.
- Erreur temporaire du fournisseur.
- Taux limite après délai.
- Échec du réseau.
- Un problème d’attente temporaire.

Ne réessayez pas pour toujours :

- Adresse du destinataire invalide.
- Clé API non autorisée.
- Numéro de modèle non valide.
- Champ requis manquant.
- Reçu.
- Politique ou bloc de conformité.

Utilisez une file d’attente exponentielle et une lettre morte pour les messages qui échouent encore après les relevés.

Chaque courriel critique devrait avoir un chemin opérationnel :

- Tu peux le soutenir ?
- L’utilisateur peut-il le redemander ?
- L’ingénierie peut retracer l’événement ?
- Vous voyez la réponse du fournisseur ?
- Pouvez-vous prouver si elle a été acceptée par le fournisseur ?

## Liste de contrôle de mise en œuvre de l’API par courriel
Utilisez cette liste de contrôle avant le lancement.

1. Choisissez les types de messages et la propriété.
2. Choisissez le fournisseur d’API et l’approche de repli.
3. Vérifier les domaines de l’expéditeur.
4. Configurer SPF, DKIM et DMARC.
5. Créer des clés API de mise en scène et de production.
6. Entreposez les secrets en toute sécurité.
7. Construisez un service de message ou un adaptateur.
8. Ajouter les clés d’idempotency.
9. Ajouter des journaux structurés.
10. Construisez un comportement de réessayer et de lettre morte.
11. Créer des modèles.
12. Personnalisation de l’AQ et valeurs de recul.
13. Configurer les boutons de connexion.
14. Enregistrer les identifiants de message du fournisseur.
15. Gérez les rebonds, les plaintes et les désabonnements.
16. Construire des outils d’appui pour la recherche de resend et de statut.
17. Surveiller les taux d ’ erreur et de livraison.
18. Limites des tarifs des documents et manuels de lecture des incidents.

## Carte de pointage de sélection du fournisseur
Noter chaque fournisseur de 1 à 5 :

Critère Poids
- Oui.
Une API à faible coût coûte cher si le courrier n’arrive pas.
Documentation API de l’API de 5
Des équipes de produits ont besoin d’une livraison et d’un retour d’échec
Résoudre la manipulation
Réduit la dérive des produits et du marketing
SDKs.SdKs.SdKs.SdKs.SdKs.SdKs.SdKs.SdKs.
Modèle de tarification
Support de l’Email Les incidents sont orientés vers le client
Retenue des données
L’analyse interne est critique uniquement pour les workflows basés sur la réponse.
Utile lorsque l’email se connecte à SMS, WhatsApp, CRM ou l’automatisation

Pour de nombreuses équipes, la bonne réponse n’est pas "l’API email la moins chère". C’est le fournisseur qui réduit le risque opérationnel pour les types d’email clients dépendent.

## Erreurs fréquentes
Évitez:

- Envoi direct du code d’application dispersé.
- Logging API touches ou pleine charge utile avec des données privées.
- Réessayer chaque erreur comme si c’était temporaire.
- Ignorer les identifiants du fournisseur.
- Oublier les webhooks jusqu’à ce que le support demande "l’email est arrivé?"
- Mélanger mot de passe réinitialise et marketing en vrac sur le même chemin de réputation.
- Utiliser un modèle pour chaque local.
- Sauter les valeurs de recul pour les variables du modèle.
- Le traitement s’ouvre comme preuve de livraison ou de succès client.
- Laisser le marketing désabonnement logique supprimer les messages de sécurité de compte obligatoire sans une politique délibérée.
- Comparaison des fournisseurs uniquement par niveau gratuit.
- Lancer un volume élevé sans échauffement.

## Commencer
Pour une nouvelle implémentation, prenez le chemin le plus court possible :

1. Commencez par un message transactionnel, comme la réinitialisation du mot de passe ou la confirmation de commande.
2. Construire un adaptateur fournisseur au lieu de coupler le code produit à un seul fournisseur.
3. Ajouter l’authentification de domaine.
4. Ajouter le suivi d’état webhook.
5. Ajouter la visibilité du support.
6. Ajouter des modèles et la localisation.
7. Élargir à l’automatisation du cycle de vie et du commerce électronique.

Si votre équipe utilise déjà Brevo pour le marketing et le CRM, commencez par l’API transactionnelle de Brevo et mapez les données d’événement dont vous avez besoin. Si votre produit a besoin de données de commerce électronique entrant dans Brevo, utilisez Tajo pour connecter client, consentement, produit, panier et commande d’événements avant de construire plus de messagerie cycle de vie.

Pour la configuration SMTP, voir plutôt le [Guide complet SMTP](/blog/smtp-complete-guide/) et [Guide du serveur SMTP gratuit](/blog/free-smtp-server-guide/).

## Guides connexes
- [Guide de service de courrier électronique transactionnel](/blog/transactional-email-service-guide/)
- [Exemples de courriels transactionnels](/blog/transactional-email-examples/)
- [Guide complet du SMTP](/blog/smtp-complete-guide/)
- [SPF, DKIM et DMARC](/blog/spf-dkim-dmarc-guide/)
- [Guide d’automatisation du courriel](/blog/guide-email automatisé/)
- [Brevo Shopify intégration](/blog/brevo-shopify-intégration/)