Tovanix
Tovanix

API SMTP agrégée

Connectez vos propres comptes d'envoi SMTP à la plateforme et envoyez vos e-mails via une seule API HTTP. La plateforme répartit les envois entre vos comptes par rotation, réessaie avec le compte suivant en cas d'échec, et propose des modèles, des contacts, des campagnes, une liste de désabonnement et des rappels Webhook. Le forfait gratuit est activé par défaut ; les forfaits payants sont débités du solde de votre compte.

Fonctionnement

La plateforme ne fournit ni service d'envoi ni IP d'envoi. Les e-mails partent par les comptes que vous connectez ; la plateforme choisit le compte, réessaie, conserve les enregistrements et envoie les rappels.

  1. Connecter des comptes d'envoi: Ajoutez un compte SMTP dans la console : hôte, port, chiffrement, nom d'utilisateur et mot de passe (ou mot de passe d'application). Vous pouvez d'abord tester la connexion et envoyer un e-mail de test. Les mots de passe sont stockés chiffrés.
  2. Créer une clé API: Générez une clé commençant par smk_ et envoyez-la dans l'en-tête Authorization: Bearer. Vous pouvez créer plusieurs clés et révoquer chacune séparément.
  3. Appeler l'API d'envoi: Un compte est choisi selon la priorité que vous avez définie et le volume qu'il a déjà envoyé aujourd'hui. En cas d'échec d'authentification, d'échec de connexion ou d'erreur temporaire, le compte suivant est essayé, dans la limite de 3 tentatives.
  4. Vérifier le résultat: Le journal d'envoi indique le statut de chaque e-mail, le compte utilisé et l'erreur éventuelle. Dès que le serveur destinataire accepte un e-mail, celui-ci est marqué comme livré, et l'événement peut être envoyé à votre Webhook.

Fonctionnalités

  • Rotation des comptes et nouvelles tentatives: Les comptes sont choisis selon leur priorité et leur volume du jour, et chaque compte peut avoir son propre plafond quotidien. Les défaillances de compte et les erreurs temporaires sont réessayées sur un autre compte ; les erreurs qu'aucun compte ne peut résoudre, comme une adresse inexistante ou un contenu refusé, ne sont pas réessayées. Vous pouvez aussi imposer un seul compte pour un envoi.
  • Mise en pause et rétablissement automatiques: Un compte qui échoue 3 fois de suite est mis en pause, et vous en êtes averti. La plateforme teste ensuite sa connexion à des intervalles qui s'allongent de 30 minutes à 12 heures, et ne le remet en rotation qu'après un test réussi. Les comptes que vous avez mis en pause vous-même ne sont jamais réactivés automatiquement.
  • Modèles et variables: Corps HTML et texte brut avec substitution de {{variable}}. Chaque enregistrement crée une version, et vous pouvez consulter l'historique des versions. L'API peut envoyer à partir du code d'un modèle.
  • Contacts et campagnes: Importez des contacts depuis un fichier CSV (10 MB maximum par fichier) et répartissez-les en groupes. Les campagnes s'envoient à des groupes ou à une liste, peuvent être planifiées, mises en pause et annulées, et ignorent automatiquement les adresses désabonnées ou en rejet.
  • Suivi des ouvertures et des clics, désabonnement en un clic: Les e-mails HTML des campagnes peuvent activer le suivi des ouvertures et des clics, et {{unsubscribe_url}} dans le corps est remplacé par le lien de désabonnement propre à chaque destinataire. Chaque e-mail de campagne comporte un en-tête de désabonnement en un clic.
  • Liste des désabonnements et des rejets: Les adresses ayant fait l'objet d'un rejet ou d'une plainte ne reçoivent plus aucun e-mail, pas même les e-mails transactionnels. Les adresses qui ont cliqué sur le lien de désabonnement ou qui ont été ajoutées à la main ne sont ignorées que pour les campagnes et les envois groupés, et pas pour les e-mails transactionnels comme les codes de vérification et les réinitialisations de mot de passe.
  • Rappels d'événements Webhook: Les événements de livraison, d'ouverture, de clic, de rejet, de plainte, de désabonnement et d'autres encore sont envoyés à votre URL avec une signature HMAC-SHA256. Ils peuvent aussi être envoyés directement aux bots de groupe Slack, Discord, Feishu, DingTalk et WeCom.
  • Vérification des domaines d'envoi: Vérifie les enregistrements SPF, DKIM et DMARC d'un domaine d'envoi, puis donne un score et les enregistrements DNS à ajouter.

Intégration

Une API HTTP avec des corps de requête JSON et une authentification par clé API. Dans la console, vous pouvez aussi rédiger un e-mail individuel ou créer une campagne sans code.

  • POST /api/v1/smtp/send: Envoyer un e-mail. Prend en charge la copie (Cc) et la copie cachée (Cci), les pièces jointes, les images intégrées, une version en texte brut, des en-têtes personnalisés et l'envoi planifié, avec un Idempotency-Key pour éviter les doublons.
  • POST /api/v1/smtp/send/batch: Envoyer un e-mail distinct à chacun de plusieurs destinataires en un seul appel ; le nombre maximal de destinataires dépend du forfait.
  • POST /api/v1/smtp/send/template: Envoyer à partir du code d'un modèle en renseignant ses variables.
  • GET /api/v1/smtp/status/{message_id}: Consulter le statut de livraison d'un e-mail.
  • GET /api/v1/smtp/quota: Consulter le quota restant pour aujourd'hui et pour ce mois-ci.
  • POST /api/v1/smtp/inbound: Signaler un rejet ou une plainte ; l'adresse est ajoutée à la liste de désabonnement.

Limites

  • Jusqu'à 20 requêtes par seconde par clé API et 60 par seconde par compte.
  • Jusqu'à 20 pièces jointes par e-mail, 15 MB au total après décodage.
  • Un envoi planifié doit être prévu au moins 30 secondes à l'avance, avec 500 envois en file d'attente au maximum par compte.
  • Seule l'API HTTP est disponible ; l'accès par le protocole SMTP n'est pas proposé.

Règles des forfaits et des quotas

  • Le forfait gratuit est activé par défaut sans abonnement, et se renouvelle de lui-même à son expiration.
  • Le quota quotidien est réinitialisé à minuit dans le fuseau horaire de votre compte ; le quota mensuel est réinitialisé le 1er de chaque mois.
  • Les forfaits payants sont débités mensuellement ou annuellement du solde de votre compte et peuvent être renouvelés dans la console avant leur expiration. Ils ne se renouvellent pas automatiquement.
  • À l'expiration d'un forfait payant, vous revenez aux quotas et aux fonctionnalités du forfait gratuit. Les comptes connectés, les modèles et les contacts ne sont pas supprimés.
  • Un changement de forfait prend effet immédiatement. La durée non utilisée de l'ancien forfait est créditée à son prix d'origine ; le crédit qui dépasse le prix du nouveau forfait prolonge votre durée au lieu d'être remboursé. La consommation de ce mois-ci est reportée sur le nouveau forfait.
  • Les e-mails partent par les comptes que vous connectez : leur arrivée en boîte de réception dépend donc de la réputation de ces comptes et de votre domaine d'envoi. La plateforme ne s'engage sur aucun taux de délivrabilité.

Forfaits et prix

ForfaitsMensuelAnnuelE-mails par jourE-mails par moisComptes d'envoiDestinataires par appel groupéModèles d'e-mailNombre de contactsCampagnes par moisVérifications de domaine d'envoiPoints de terminaison Webhook
GratuitGratuitGratuit50010,0002100201,000Non inclus1Non inclus
Basique$1.00/mois$10.00/an5,000100,00051,00010020,0005053
Professionnel$5.00/mois$50.00/an50,0001,000,0002010,0001,000200,0005002020
Entreprise$20.00/mois$200.00/an200,0005,000,00010050,0009,9992,000,0009,999100100

Les prix sont en USD et correspondent au prix standard avant connexion. Des points peuvent couvrir une partie du coût ; le montant affiché sur la page de commande fait foi. Les quotas comptent les e-mails envoyés, et les envois groupés et les campagnes comptent un e-mail par destinataire.

Questions fréquentes

À quoi sert l'API SMTP agrégée ?

Elle vous permet de connecter un ou plusieurs de vos propres comptes d'envoi SMTP et d'envoyer vos e-mails via une seule API HTTP. La plateforme alterne entre les comptes, réessaie avec un autre compte en cas d'échec, et fournit des modèles, des contacts, des campagnes, une liste de désabonnement et des rappels Webhook. La plateforme elle-même ne fournit pas de service d'envoi.

De quoi ai-je besoin ?

D'au moins un compte d'envoi auquel vous pouvez vous connecter en SMTP : le SMTP d'un fournisseur de messagerie, une messagerie professionnelle ou votre propre serveur de messagerie conviennent. Il vous faut l'hôte, le port, le nom d'utilisateur et le mot de passe (ou mot de passe d'application). Pour les campagnes, configurez d'abord SPF, DKIM et DMARC pour votre domaine d'envoi.

Quelles sont les limites du forfait gratuit ?

Le volume d'envoi, les comptes d'envoi, les modèles et les contacts sont indiqués dans le tableau des forfaits. Le forfait gratuit n'inclut ni les campagnes ni les Webhooks ; tous les autres points de terminaison d'envoi fonctionnent. Il ne nécessite aucun abonnement et reste disponible.

Pouvez-vous garantir l'arrivée en boîte de réception ?

Non. Les e-mails partent par les comptes que vous connectez, et c'est le destinataire qui décide entre boîte de réception et spam, selon la réputation du compte et du domaine d'envoi et selon le contenu. La plateforme peut vérifier les enregistrements SPF, DKIM et DMARC de votre domaine et ignore automatiquement les adresses ayant fait l'objet d'un rejet ou d'une plainte.

Puis-je me connecter directement à la plateforme en SMTP ?

Non. Seule l'API HTTP est disponible, ainsi que la rédaction d'e-mails et la création de campagnes dans la console. La plateforme se connecte aux comptes SMTP que vous ajoutez pour envoyer les e-mails ; elle ne propose pas de relais SMTP.

Que se passe-t-il si un compte échoue sans arrêt ?

Un compte qui échoue 3 fois de suite est mis en pause et vous en êtes averti, tandis que vos autres comptes continuent d'envoyer. La plateforme teste ensuite régulièrement la connexion de ce compte et ne le remet en rotation qu'après un test réussi. Si vous modifiez ses paramètres de connexion ou si vous le réactivez vous-même, il est également rétabli immédiatement.

Comment les quotas sont-ils comptés, et que se passe-t-il quand ils sont épuisés ?

Les quotas comptent les e-mails envoyés, et les envois groupés et les campagnes comptent un e-mail par destinataire. Le quota quotidien est réinitialisé à minuit et le quota mensuel le 1er de chaque mois. Une fois un quota épuisé, l'API d'envoi refuse les nouvelles requêtes ; attendez la réinitialisation ou passez à un forfait supérieur, ce qui prend effet immédiatement.

Puis-je l'utiliser depuis un client IA ?

Oui. Après avoir connecté votre compte dans un client IA compatible MCP, vous pouvez consulter les forfaits et la consommation, lire les journaux d'envoi, envoyer un e-mail à un nombre de destinataires compris entre 1 et 10, et gérer les contacts, les modèles, les Webhooks et les domaines d'envoi. Le renouvellement exige un code à usage unique.

Pages connexes: Routage des e-mails entrants et API d’envoi par domaine · Une messagerie professionnelle sur votre propre domaine · Vérification par SMS · API e-mail SMTP · Utiliser l’API d’agrégation SMTP

Chargement…