Envois SMTP pour les e-mails transactionnels
En plus de l'API HTTP, Flexmail prend en charge l'envoi d'e-mails transactionnels via SMTP. Cela est utile lorsque votre application ou plateforme dispose déjà d'une prise en charge SMTP intégrée, comme un CMS, une plateforme e-commerce ou un système legacy qui envoie des e-mails via un relais SMTP.
Les envois SMTP sont inclus dans le module transactionnel sans frais supplémentaires. Ils offrent la même fiabilité de livraison et les mêmes capacités de suivi que l'API, avec quelques différences dans les paramètres par défaut et les fonctionnalités prises en charge.
Attention Les envois SMTP ne sont pas activés par défaut. Vous devez demander l'accès explicitement. Consultez « Demander l'accès » ci-dessous.
Demander l'accès
L'accès SMTP n'est pas activé automatiquement lorsque vous activez le module transactionnel. Pour demander des identifiants SMTP pour votre compte, contactez l'assistance Flexmail à l'adresse support@flexmail.eu en incluant votre identifiant de compte dans la demande. Votre nom d'utilisateur et mot de passe SMTP vous seront communiqués dans la réponse.
Attention Vos identifiants SMTP sont distincts de votre jeton d'accès personnel. Le nom d'utilisateur et le mot de passe pour SMTP sont fournis par Flexmail sur demande — n'utilisez pas votre identifiant de compte et votre jeton d'accès personnel comme identifiants SMTP.
Paramètres de connexion
Une fois votre accès SMTP accordé, utilisez les paramètres suivants :
| Paramètre | Valeur |
|---|---|
| Serveur | submission.flexmail.eu |
| Port | 587 |
| Sécurité de connexion | STARTTLS |
| Nom d'utilisateur | Fourni par Flexmail sur demande |
| Mot de passe | Fourni par Flexmail sur demande |
En-têtes personnalisés
Les envois SMTP prennent en charge plusieurs en-têtes personnalisés optionnels qui contrôlent le comportement des messages et le suivi. Ils fonctionnent de manière similaire aux options disponibles dans l'API HTTP.
| En-tête | Description |
|---|---|
| X-Flexmail-Tag | Ajoutez un tag pour catégoriser les messages et accumuler des statistiques. Doit être au format snake_case (1 à 50 caractères, ex. : order_confirmation). |
| X-Flexmail-Metadata-{clé} | Ajoutez des métadonnées personnalisées sous forme de paires clé/valeur. Remplacez {clé} par le nom de votre champ en snake_case. La valeur doit contenir de 1 à 80 caractères. |
| X-Flexmail-Open-Tracking | Définissez sur true pour activer le suivi des ouvertures. Désactivé par défaut. |
| X-Flexmail-Link-Tracking | Définissez sur true pour activer le suivi des clics. Désactivé par défaut. |
Exemple :
X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true
Attention Le suivi des ouvertures et des clics est désactivé par défaut pour les envois SMTP et pour l'API HTTP. Ajoutez les en-têtes correspondants si vous souhaitez activer le suivi.
ID de message et corrélation des webhooks
L'en-tête Message-ID original de votre e-mail soumis est automatiquement enregistré comme métadonnée sous la clé original_message_id. Cela vous permet de corréler les événements de livraison des webhooks avec les messages que vous avez envoyés depuis votre propre système.
SMTP vs l'API HTTP
Les deux méthodes présentent quelques différences dans les paramètres par défaut et les capacités :
| Fonctionnalité | API HTTP | Envoi SMTP |
|---|---|---|
| Suivi des ouvertures | Désactivé par défaut | Désactivé par défaut |
| Suivi des clics | Désactivé par défaut | Désactivé par défaut |
| Message-ID original | N/A | Conservé en tant que métadonnée original_message_id |
| Pièces jointes en ligne | Pris en charge | Non pris en charge |
| E-mail en texte seul | Pris en charge | Non pris en charge |
Fonctionnalités prises en charge
- E-mails HTML avec ou sans partie en texte brut.
- Suivi des ouvertures et des clics (via des en-têtes personnalisés).
- Destinataires CC et BCC.
- Pièces jointes — doivent être encodées en base64. Les pièces jointes en ligne ne sont pas prises en charge.
- Limitation du débit par destinataire, conforme aux limites de débit de l'API.
Exigences
- L'adresse De doit être un expéditeur vérifié dans votre compte Flexmail.
- Le domaine d'envoi doit être authentifié avec SPF, DKIM et DMARC, et un return-path doit être configuré. Ces exigences sont les mêmes que pour l'API HTTP.
Gestion des erreurs
Les erreurs d'envoi sont signalées via un NDR (Non-Delivery Report) envoyé à l'adresse de l'expéditeur de l'enveloppe. Les événements de rebond et tous les autres événements de message sont également disponibles via le point de terminaison des détails du message et les webhooks, de la même manière que les envois par API.
Étapes suivantes
- Consultez « Premiers pas avec l'API transactionnelle Flexmail » pour le processus complet de configuration du compte.
- Consultez « Webhooks transactionnels » pour recevoir des événements de livraison et de suivi en temps réel.
- Consultez « Résolution de problèmes des e-mails transactionnels » si votre connexion SMTP ou votre délivrabilité ne fonctionne pas comme prévu.