Utiliser l’API d’agrégation SMTP
Réunissez plusieurs de vos propres comptes SMTP en une seule sortie d’envoi, que la plateforme utilise à tour de rôle :
- La première utilisation active automatiquement l’offre gratuite ; le quota, les fonctions disponibles et les limites dépendent de l’offre, et « Changer d’offre » déduit le temps restant au prix d’origine
- Ajoutez d’abord un compte dans « Comptes SMTP », puis créez une clé dans « Clés API » ; la création et la réinitialisation exigent une vérification d’identité, et la clé n’est affichée qu’une fois
- Trois modes d’envoi : rédaction en ligne, campagnes et appels API ; les campagnes fusionnent les destinataires, suppriment les doublons et ignorent la liste de désabonnement
- Un compte SMTP qui échoue 3 fois de suite à cause d’un problème qui lui est propre passe à « Erreur », puis se rétablit automatiquement quand le test de la plateforme réussit
- Erreurs courantes : 400 se traite selon le message (quota épuisé, destinataire signalé comme rebond, etc.), 401 indique une clé invalide, 403 un compte restreint et 429 des requêtes trop fréquentes
Ce que fait ce service
L’API d’agrégation SMTP réunit plusieurs de vos propres comptes d’envoi SMTP en une seule sortie : votre système ne s’intègre qu’une fois avec la plateforme, qui répartit les envois entre ces comptes à tour de rôle. Vous pouvez envoyer directement depuis la console ou, via l’API, depuis votre propre système.
- Elle convient aux e-mails transactionnels, comme les codes d’inscription et les notifications de commande, ainsi qu’aux envois groupés à des groupes de contacts.
- La première utilisation active automatiquement l’offre gratuite. Après avoir ajouté un compte SMTP et créé une clé API, vous pouvez envoyer ; changez d’offre quand vous avez besoin de plus de quota ou de fonctions.
- Le point d’entrée est « API SMTP agrégée » dans la console, avec des pages réparties en trois groupes : « Envoi », « Intégration » et « Configuration ».
Quelques termes pour commencer
Cette section comporte de nombreuses pages. Comprendre ces notions d’abord vous évitera de vous retrouver sur la mauvaise page.
- Offre — Elle détermine le nombre d’e-mails que vous pouvez envoyer par jour et par mois, les fonctions disponibles (modèles d’e-mails, contacts, campagnes, Webhook) et la limite de chaque élément, détaillés sur les cartes de la page « S’abonner ». La première utilisation active automatiquement l’offre gratuite ; à l’expiration d’une offre payante, le compte revient à l’offre gratuite.
- Compte SMTP — Vos propres comptes d’envoi SMTP (chez un fournisseur de messagerie ou sur votre propre serveur) : la plateforme ne fournit pas de canal d’envoi. Vous pouvez en ajouter plusieurs, chacun avec sa priorité et sa limite d’envoi quotidienne, et la plateforme les utilise à tour de rôle.
- Clé API — L’identifiant utilisé par votre système pour appeler l’API d’envoi. La clé API détermine « qui appelle », le compte SMTP « avec quelle boîte envoyer ».
- Domaine d’envoi — Le domaine qui suit le @ de votre adresse d’envoi. La page « Domaines d’envoi » vérifie ses enregistrements SPF, DKIM et DMARC ; une fois ceux-ci complets, vos e-mails arrivent plus facilement en boîte de réception.
- Liste de désabonnement — Les adresses des destinataires qui se sont désabonnés par le lien de désabonnement, ainsi que celles que votre système a signalées par l’API comme rebonds ou plaintes. La plateforme ignore automatiquement ces adresses d’après la liste, sans gestion manuelle de votre part.
Envoyer votre premier e-mail
- Vérifier votre offre: La première visite active automatiquement l’offre gratuite. « API SMTP agrégée → S’abonner » affiche votre offre actuelle et le quota de chaque offre ; souscrivez une offre supérieure quand vous avez besoin de plus de quota ou de fonctions.
- Ajouter un compte SMTP: Sur la page « Comptes SMTP », cliquez sur « Ajouter un compte » et saisissez l’adresse de l’hôte, le port, le nom d’utilisateur, le mot de passe et l’adresse d’envoi. Le nombre de comptes possibles dépend de l’offre ; avec plusieurs comptes, la plateforme les utilise automatiquement à tour de rôle.
- Créer une clé API: Sur la page « Clés API », cliquez sur « Créer une clé API ». La création et la réinitialisation exigent une vérification d’identité : saisissez le code à usage unique si l’authentification à deux facteurs est activée, sinon le code reçu par e-mail ; après une vérification, aucune nouvelle vérification n’est demandée pendant 10 minutes dans la même session. La clé n’est affichée qu’une fois : copiez-la et enregistrez-la immédiatement. Chaque compte peut avoir 50 clés au maximum.
- Envoyer un e-mail de test: Sur la page « Comptes SMTP », cliquez sur « Tester » pour tester la connexion ou envoyer un e-mail de test à votre propre adresse. Les e-mails de test ne consomment pas le quota d’envoi : vous pouvez tester autant que nécessaire.
Si vous avez déjà une offre payante, choisissez une autre offre sur la page « S’abonner » et cliquez sur « Changer d’offre » : le changement est immédiat. Le temps restant de l’offre actuelle est déduit au prix d’origine et vous ne payez que la différence ; la part de la déduction qui dépasse le prix de la nouvelle offre est convertie en durée supplémentaire, sans remboursement sur le solde ; le quota déjà utilisé ce mois-ci est reporté sur la nouvelle offre.
Une fois une clé API supprimée, toutes les requêtes qui l’utilisent encore échouent ; une réinitialisation invalide aussi l’ancienne clé immédiatement. Pour une clé utilisée par un système en production, mettez d’abord la nouvelle en place avant de toucher à l’ancienne.
Trois méthodes d’envoi
Un quota, trois voies : choisissez selon la situation :
- Rédiger en ligne — Rédigez et envoyez depuis la console. Adapté aux notifications ponctuelles et aux renvois manuels.
- Campagne — Choisissez un modèle et des groupes de contacts pour un envoi groupé avec limitation du débit, suivi et programmation. Le système fusionne les contacts, supprime les doublons et exclut les adresses désabonnées.
- Appel API — Votre système appelle directement le point de terminaison. Une requête peut viser plusieurs destinataires, chacun avec ses propres variables de modèle.
Modèles et variables
Placez le contenu dans un modèle et ne transmettez que les variables à l’envoi pour séparer le contenu du code.
- Les modèles sont gérés sur la page Modèles et référencés par leur identifiant lors de l’envoi ; la plateforme effectue les substitutions.
- La plateforme génère une version texte à partir du HTML pour que le message reste lisible lorsque le HTML n’est pas pris en charge.
Contacts et désabonnements
La page « Contacts » gère les adresses et les groupes, avec import et export CSV ; une campagne cible les groupes choisis.
- La sélection de plusieurs groupes les fusionne et supprime les doublons, afin que personne ne reçoive deux fois le même e-mail.
- À l’import CSV, les adresses désabonnées sont automatiquement ignorées.
- Le lien de désabonnement ouvre une page de confirmation ; la confirmation ajoute l’adresse à la liste de désabonnement et marque le contact.
La liste de désabonnement s’applique automatiquement. Une adresse signalée comme rebond ou plainte ne reçoit plus aucun e-mail ; une adresse désabonnée par le lien de désabonnement n’est ignorée que pour les campagnes et les envois groupés : les e-mails unitaires, comme les codes de vérification, lui sont toujours envoyés.
Domaines d’envoi
Sur la page « Domaines d’envoi », ajoutez le domaine utilisé pour envoyer (la partie qui suit le @ de l’adresse d’envoi) et, si vous le souhaitez, le sélecteur DKIM (fourni par votre fournisseur de messagerie). La plateforme vérifie les enregistrements SPF, DKIM et DMARC, et indique les enregistrements DNS à ajouter ainsi qu’un état de santé. Une fois ces enregistrements complets, les e-mails arrivent plus facilement en boîte de réception. Cette étape n’est pas obligatoire pour envoyer ; le nombre de domaines possibles dépend de l’offre.
Webhooks et événements
Pour connaître le devenir de chaque message, configurez un webhook : la plateforme transmettra les événements de livraison à votre service.
- Les événements couvrent le processus de livraison et son résultat, ainsi que des actions comme le désabonnement d’un destinataire ou la fin d’une campagne.
- Les rappels sont signés et votre serveur doit vérifier leur signature avant de leur faire confiance. Cette vérification constitue la frontière de sécurité : ne l’omettez pas.
Erreurs courantes et solutions
Quand un appel à l’API échoue, consultez d’abord le code d’état HTTP et le message de la réponse, puis suivez le tableau ci-dessous.
- Réponse 400 — Requête refusée : quota épuisé, destinataire déjà signalé comme rebond ou plainte, aucun compte SMTP disponible, paramètre incorrect, etc. — Agissez selon le message. Si le quota est épuisé, attendez sa réinitialisation (le quota quotidien se réinitialise à 0 h dans le fuseau horaire de votre compte, modifiable dans les paramètres du compte ; le quota mensuel se réinitialise au début de chaque mois) ou passez à une offre supérieure ; si aucun compte SMTP n’est disponible, vérifiez leur état sur la page « Comptes SMTP ».
- Réponse 401 — Clé API absente, ou clé invalide, désactivée, supprimée ou réinitialisée — Vérifiez son état sur la page « Clés API » et remplacez la clé de votre système par celle qui est actuellement valide.
- Réponse 403 — Le compte est gelé ou restreint — Un compte restreint (code d’erreur 4031) peut toujours appeler les API de consultation, mais les envois sont refusés. Contactez le support.
- Réponse 429 — Requêtes trop fréquentes : 20 par seconde au maximum par clé API, et 60 par seconde au maximum pour l’ensemble d’un compte — Attendez le délai indiqué par l’en-tête Retry-After avant de renvoyer. Pour écrire à de nombreux destinataires, mettez plusieurs destinataires dans une même requête ou utilisez une campagne, plutôt que d’enchaîner rapidement les appels e-mail par e-mail.
- L’e-mail est envoyé mais arrive dans les spams — Domaine d’envoi non configuré ou contenu déclenchant les filtres — Sur la page « Domaines d’envoi », vérifiez SPF, DKIM et DMARC et complétez les enregistrements DNS selon les recommandations, puis examinez le contenu ; avant une vraie campagne, vous pouvez tout contrôler avec la « Simulation de livraison ».
Si un compte SMTP échoue 3 fois de suite à cause d’un problème qui lui est propre, comme un échec de connexion au compte ou un serveur injoignable, son état passe à « Erreur » et il ne participe plus à la rotation. La plateforme le teste automatiquement à intervalles réguliers et le rétablit si le test réussit ; vous pouvez aussi, sur la page « Comptes SMTP », tester sa connexion ou lui faire envoyer un e-mail de test, ce qui le rétablit en cas de succès, corriger ses paramètres de connexion ou l’activer manuellement.
Questions fréquentes
Tout est configuré : pourquoi l’envoi échoue-t-il encore ?
Vérifiez dans l’ordre : « Comptes SMTP » contient-il un compte activé (un compte à l’état « Erreur » ne participe pas aux envois) ; la clé API utilisée est-elle celle qui est actuellement valide ; le quota du jour ou du mois est-il épuisé. Le message renvoyé par l’API précise la cause exacte.
Un e-mail de test consomme-t-il du quota ?
Non. Les envois de test de la page « Comptes SMTP » ne sont pas décomptés du quota d’envoi : vous pouvez tester librement pendant la configuration.
Que se passe-t-il à l’expiration d’une offre payante ?
À l’expiration, le compte revient au quota et aux fonctions de l’offre gratuite. Pour continuer, cliquez sur « Renouveler » dans « S’abonner » avant l’expiration, ou souscrivez à nouveau après l’expiration.
Pages connexes: Centre d'aide · Guides et FAQ · API SMTP agrégée · Documentation API
Chargement…