Envoyer votre premier e-mail via SMTP

Ce démarrage rapide vous montre comment envoyer un e-mail de test via le relais SMTP d’Emailit depuis votre terminal, puis connecter votre propre application. Utilisez le SMTP quand votre logiciel dispose déjà de paramètres SMTP. Pour du nouveau code, l’API offre davantage de possibilités.

Avant de commencer

• Un domaine d’envoi vérifié. Si vous n’en avez pas encore, suivez la première section du démarrage rapide API ou la page Ajouter un domaine d’envoi.
• Une clé API. Créez-en une dans Email API›API Keys avec Add API key. Votre clé API est votre mot de passe SMTP.

Vos identifiants SMTP

Vous retrouvez aussi ces paramètres sur la carte SMTP Info quand vous ouvrez une clé dans Email API›API Keys.

Le relais propose TLS sur tous les ports, mais ne l’impose pas. Activez toujours TLS dans votre client pour que votre clé API ne soit pas envoyée en clair.

Envoyer un e-mail de test

Choisissez l’un de ces outils. Remplacez hello@acme.com par une adresse de votre domaine vérifié, et ada@example.com par l’adresse e-mail avec laquelle vous avez créé votre compte.

swaks

swaks est un outil de test SMTP en ligne de commande. Installez-le avec brew install swaks ou apt install swaks, puis exécutez :

swaks --server smtp.emailit.com:587 --tls \
  --auth-user emailit --auth-password "$EMAILIT_API_KEY" \
  --from hello@acme.com --to ada@example.com \
  --header "Subject: Hello from Emailit SMTP" \
  --body "This is my first email sent through the Emailit SMTP relay."

swaks affiche toute la conversation SMTP. La dernière réponse du serveur contient l’ID de l’e-mail :

<~  250 2.0.0 OK: queued as em_2pX7cN4kQ9vLm3RtB8yWd1Zs

OpenSSL

OpenSSL est préinstallé sur la plupart des systèmes et vous permet de saisir vous-même les commandes SMTP. Commencez par encoder vos identifiants pour AUTH PLAIN :

printf '\0emailit\0%s' "$EMAILIT_API_KEY" | base64

Ouvrez ensuite une connexion et saisissez les commandes ci-dessous, en collant la chaîne encodée après AUTH PLAIN :

openssl s_client -connect smtp.emailit.com:587 -starttls smtp -crlf -quiet

EHLO localhost
AUTH PLAIN AGVtYWlsaXQAc2VjcmV0X...
MAIL FROM:<hello@acme.com>
RCPT TO:<ada@example.com>
DATA
From: Acme <hello@acme.com>
To: ada@example.com
Subject: Hello from Emailit SMTP

This is my first email sent through the Emailit SMTP relay.
.
QUIT

Après AUTH PLAIN, le serveur répond 235. Après la ligne contenant un seul ., il répond 250 2.0.0 OK: queued as em_….

Python

Le module intégré smtplib de Python ne nécessite aucun paquet supplémentaire :

import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "Hello from Emailit SMTP"
msg.set_content("This is my first email sent through the Emailit SMTP relay.")
msg.add_alternative("<p>This is my first email sent through the Emailit SMTP relay.</p>", subtype="html")

with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
    smtp.starttls()
    smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
    smtp.send_message(msg)

print("Accepted by Emailit")

Si le script se termine sans exception, Emailit a accepté l’e-mail.

Vérifier dans le tableau de bord

Accédez à Email API›Emails. Votre e-mail se trouve en haut de l’onglet Outgoing, et son statut passe de accepted à delivered dès que le serveur du destinataire l’accepte. Chaque session SMTP apparaît aussi dans Email API›Logs avec la source SMTP : vous voyez donc également les échecs de connexion et les messages rejetés.

Réponses fréquentes

Pour tous les codes de réponse, consultez Dépannage SMTP.

Connecter votre application

Reportez les mêmes paramètres dans votre application ou votre framework. Ces guides indiquent la configuration exacte :

Étapes suivantes