Relais SMTP

WordPress, Mattermost, un ERP, une imprimante qui envoie des scans : tout ce qui sait parler SMTP peut passer par Lekalao. Chaque message reçu repart comme un e-mail transactionnel, journalisé, suivi et compté.

Sur le service Lekalao, le relais est smtp.lekalao.com, port 465, en SSL/TLS. Sur votre propre installation, son administrateur le lance : Paramètres → Documentation affiche alors l’hôte et le port.

Avant de commencer

Un jeton d’API qui peut écrire. Créez-le dans Paramètres → Jetons d’API, avec Lecture et écriture. Il ne s’affiche qu’une fois, juste après sa création : copiez-le à ce moment-là.
Un domaine d’envoi vérifié. Ajoutez-le dans Délivrabilité et attendez qu’il soit vérifié (Domaines d’envoi). L’adresse d’expédition du logiciel doit être sur ce domaine : sur le service Lekalao, un message venant d’un autre domaine est refusé.

Se connecter

Réglage	Valeur
Hôte	`smtp.lekalao.com` ; sur votre installation, celui affiché dans Paramètres → Documentation.
Port	`465`.
Chiffrement	SSL/TLS dès la connexion. Selon le logiciel, il s’appelle SSL, SSL/TLS ou TLS. Jamais STARTTLS, jamais « aucun ».
Authentification	Activée, `PLAIN` ou `LOGIN`.
Utilisateur	N’importe lequel, par exemple `lekalao`.
Mot de passe	Le jeton d’API Lecture et écriture.
Adresse d’expédition	Une adresse de votre domaine d’envoi vérifié, réglée dans le logiciel lui-même.

Le jeton se révoque comme les autres, dans Paramètres → Jetons d’API. Il cesse de fonctionner si son propriétaire devient lecteur ou quitte l’équipe, ou, dans une équipe qui exige la double authentification, tant que son propriétaire n’a configuré ni second facteur ni clé d’accès. Avec une clé de test, chaque message est journalisé comme e-mail de test, et aucun ne part.

Mattermost

Dans System Console → Environment → SMTP (libellés de l’interface anglaise de Mattermost) :

SMTP Server : smtp.lekalao.com
SMTP Server Port : 465
Enable SMTP Authentication : True
SMTP Server Username : lekalao
SMTP Server Password : le jeton
Connection Security : TLS

Puis dans System Console → Site Configuration → Notifications, mettez dans Notification From Address une adresse de votre domaine d’envoi vérifié. Sans elle, Mattermost envoie sans aucun expéditeur, et le message est refusé. Test Connection envoie un vrai e-mail à votre propre adresse. Il apparaît dans le journal transactionnel.

WordPress (WP Mail SMTP)

Mailer : Other SMTP
SMTP Host : smtp.lekalao.com
Encryption : SSL
SMTP Port : 465
Authentication : activée, Username lekalao, Password le jeton
From Email : une adresse de votre domaine d’envoi vérifié

Laravel ou Symfony

.env

MAIL_MAILER=smtp
MAIL_SCHEME=smtps
MAIL_HOST=smtp.lekalao.com
MAIL_PORT=465
MAIL_USERNAME=lekalao
MAIL_PASSWORD=12|kJ3v8mQ2xP9…
MAIL_FROM_ADDRESS=bonjour@votre-domaine.example

Pour une application Laravel, le transport dédié est plus complet.

Ce qui passe

Élément
Destinataires	Ceux de l’enveloppe, 100 au plus par message. Ceux qui ne figurent ni dans `To` ni dans `Cc` restent en copie cachée.
Expéditeur	L’en-tête `From`. Une enveloppe sans expéditeur (`MAIL FROM:<>`) est acceptée. Sans en-tête `From`, l’adresse de l’enveloppe.
Objet, `Reply-To`	Lus dans les en-têtes, encodages compris.
Corps	La partie HTML, à n’importe quelle profondeur — un multipart dans un multipart est parcouru ; à défaut, la partie texte, affichée telle qu’écrite.
Taille	25 Mo au plus.
Pièces jointes	Refusées : le message est rejeté avec `554`. Envoyez-les par l’API.

Réponses du relais

Code	Signification
`250 Message accepted`	Pris en charge. Il est dans le journal transactionnel.
`530 Authentication required`	L’authentification est désactivée dans le logiciel. Activez-la.
`535 Authentication failed`	Jeton inconnu, révoqué, en lecture seule, propriétaire sans droit d’écriture, ou sans le second facteur que l’équipe exige.
`421 Too many failed attempts, closing`	Trois mauvais mots de passe sur une connexion : le relais la ferme. Le relais dans son ensemble accepte 60 mauvais mots de passe par minute ; au-delà, chaque connexion échoue jusqu’à la fin de la minute.
`421 Too many connections, try again later`	Le relais tient déjà autant de conversations qu’il en accepte (50 par défaut). Le logiciel doit réessayer un instant plus tard.
`550 …`	Expéditeur refusé : absent, ou d’un domaine qui n’est pas un domaine d’envoi vérifié. Le motif suit.
`554 Attachments are not relayed…`	Le message a une pièce jointe.
`452 Too many recipients`	Plus de 100 destinataires.
`451 Message could not be accepted`	Problème passager de Lekalao. Le logiciel doit réessayer.

Quand le logiciel ne se connecte pas

Le logiciel dit	À vérifier
`connection refused`	L’hôte et le port. Sur votre installation, le relais ne tourne pas ou n’est pas encore joignable : demandez à son administrateur.
Il attend, puis abandonne	Le chiffrement : SSL/TLS (TLS dans Mattermost), ni STARTTLS ni « aucun ».
`certificate is valid for …, not smtp.…`	Sur votre installation, le terminateur TLS placé devant le relais n’a pas encore de certificat pour son nom : demandez à son administrateur.
`535`, `550` ou un autre code	Le tableau ci-dessus.

L'API

Recettes

Intégrations

Avant de commencer

Se connecter

Mattermost

WordPress (WP Mail SMTP)

Laravel ou Symfony

Ce qui passe

Réponses du relais

Quand le logiciel ne se connecte pas

​Avant de commencer

​Se connecter

​Mattermost

​WordPress (WP Mail SMTP)

​Laravel ou Symfony

​Ce qui passe

​Réponses du relais

​Quand le logiciel ne se connecte pas

Avant de commencer

Se connecter

Mattermost

WordPress (WP Mail SMTP)

Laravel ou Symfony

Ce qui passe

Réponses du relais

Quand le logiciel ne se connecte pas