Relais SMTP
Envoyez en SMTP en changeant des réglages, pas votre code
Si votre application, votre CMS ou votre framework permet de configurer un serveur SMTP, il peut envoyer via MailLand. Modifiez quatre réglages et bénéficiez des mêmes contrôles de domaine, journaux, webhooks et de la même gestion des suppressions que l’API REST.
Paramètres de connexion
- Hôte
smtp.mail.land- Port
- 587 (STARTTLS)
- Nom d’utilisateur
- n’importe quelle valeur, par exemple apikey
- Mot de passe
- une clé API avec le canal SMTP activé
Configuration en trois étapes
Vérifiez votre domaine d’envoi
Ajoutez votre domaine dans le panneau et publiez les enregistrements SPF, DKIM et DMARC qu’il affiche. Les trois doivent être vérifiés avant que vous puissiez envoyer.
Créez un identifiant SMTP
Créez une clé avec le canal SMTP activé. Elle n’est affichée qu’une seule fois ; MailLand n’en conserve qu’un hachage.
Mettez à jour vos réglages SMTP
Saisissez smtp.mail.land, le port 587 avec STARTTLS, n’importe quel nom d’utilisateur et la clé comme mot de passe. Envoyez ensuite un message de test et retrouvez-le dans le journal des messages.
Configuration pour les stacks courantes
Ce sont des exemples de configuration, pas des plugins. MailLand ne propose aucun paquet pour WordPress, Laravel ou Django : vous utilisez la prise en charge SMTP que votre stack offre déjà.
MAIL_MAILER=smtp
MAIL_HOST=smtp.mail.land
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=ml_pet_...
[email protected]
MAIL_FROM_NAME="Your App"La même plateforme que l’API
Le relais est une deuxième porte d’entrée vers le même compte, pas un produit distinct avec ses propres règles.
Contrôles de domaine
L’adresse d’expéditeur doit appartenir à un domaine vérifié. Un message provenant d’un domaine non vérifié est refusé avec un code 550, avant d’être mis en file d’attente.
Journaux et webhooks
Les messages envoyés en SMTP apparaissent dans le journal des messages et produisent les mêmes événements délivré, différé, rebond, échec et plainte que les envois par l’API.
Gestion des suppressions
Les rebonds définitifs et les plaintes sont ajoutés à votre liste de suppression, et les messages ultérieurs à ces adresses sont refusés.
Règles des clés
La restriction par domaine, les listes d’IP autorisées et les limites de la clé par minute, par heure et par jour s’appliquent exactement comme pour l’API. Une clé sandbox accepte et enregistre les e-mails sans les livrer.
Une réponse claire pendant la session SMTP
Le relais répond à chaque message pendant la session SMTP : votre bibliothèque de messagerie voit immédiatement l’acceptation ou le motif d’un refus. Un 250 signifie que MailLand a accepté le message pour livraison, pas que le serveur du destinataire l’a reçu : les événements de livraison suivent.
- 250
- Accepté pour livraison.
- 421
- Temporaire : une limite de débit ou le quota mensuel est atteint. Réessayez plus tard.
- 451
- Temporaire : l’envoi est suspendu pour ce compte. Gardez le message en file d’attente et réessayez.
- 550
- Permanent : par exemple, le domaine n’est pas vérifié ou le destinataire figure sur la liste de suppression.
- 552
- Permanent : le message dépasse 15 MiB.
Limites à connaître
- Messages jusqu’à 15 MiB, pièces jointes comprises.
- Jusqu’à 5 destinataires par message avec une clé transactionnelle, jusqu’à 1 000 avec une clé marketing.
- 30 connexions par minute et 300 par heure depuis une même adresse IP, comptées avant l’authentification.
- Seul le port 587 avec STARTTLS est publié. Le port 465 n’est pas proposé, et le port 25 est réservé à la passerelle de réception.
SMTP ou API REST ?
Utilisez SMTP lorsque votre logiciel le parle déjà. Utilisez l’API lorsque vous avez besoin de fonctionnalités que SMTP ne peut pas transporter.
| Relais SMTP | API REST | |
|---|---|---|
| Réponse | 250 ou un code d’erreur, pendant la session | 202 Accepted ou une erreur, puis des événements |
| Modèles enregistrés | Non, envoyez le message MIME complet | Oui, avec templateId |
| Envoi planifié | Non | Oui, jusqu’à 7 jours à l’avance |
| Envoi par lots | Non | Oui, avec une clé marketing |
| Variables par destinataire | Non | Oui |
| Pièces jointes | MIME standard | Base64 dans le JSON |
| Suivi des ouvertures et des clics | Réglé par domaine | Réglé par domaine ou par message |
Questions sur le relais SMTP
Quel port et quel chiffrement utiliser ?
Le port 587 avec STARTTLS. C’est le seul port publié pour le relais. Le port 465 avec TLS implicite n’est pas proposé.
Puis-je me connecter avec l’adresse e-mail et le mot de passe de mon compte ?
Non. Le mot de passe est une clé API avec le canal SMTP activé. Le nom d’utilisateur est ignoré : n’importe quelle valeur, comme apikey, fonctionne.
Est-ce compatible avec WordPress ?
Oui, avec n’importe quel plugin SMTP qui permet de saisir un hôte, un port, un nom d’utilisateur et un mot de passe. MailLand ne publie pas son propre plugin WordPress.
Puis-je utiliser des modèles enregistrés ou la planification en SMTP ?
Non. En SMTP, vous envoyez un message MIME finalisé. Les modèles, l’envoi planifié, l’envoi par lots et les variables par destinataire sont des fonctionnalités de l’API REST.
Existe-t-il une taille maximale de message ?
Oui, 15 MiB par message, pièces jointes comprises. Un message plus volumineux est refusé avec un code 552.
Que doit faire mon application face à un 421 ou un 451 ?
Les deux sont temporaires : conservez le message et réessayez plus tard. Un code 5xx est permanent : ne renvoyez donc pas le même message sans le modifier.
Changez d’hôte SMTP dès aujourd’hui
Créez un compte gratuit, vérifiez votre domaine et créez un identifiant SMTP. 1 000 e-mails par mois sont gratuits.