Relais SMTP

Le relais SMTP d’Emailit accepte les e-mails de tout ce qui peut envoyer via SMTP, comme un CMS, le mailer d’un framework, un outil de supervision ou un scanner, et les livre par le même circuit que l’API e-mail. Utilisez-le quand modifier des paramètres SMTP est plus simple qu’écrire du code pour l’API.

Quand utiliser SMTP

SMTP est adapté quand :

• Votre logiciel ne prend en charge que SMTP, comme les plugins WordPress, les outils de support et les équipements réseau.
• Vous venez d’un autre fournisseur et ne voulez changer que l’hôte et les identifiants.
• Votre framework dispose déjà d’un mailer SMTP, comme Laravel, Django, Rails et Nodemailer.

Choisissez l’API si vous avez besoin de modèles avec variables, de la programmation, de métadonnées, de clés d’idempotence ou de réglages de suivi par e-mail. Pour un comparatif complet, consultez API ou SMTP ?.

Fonctionnement

1. Votre application se connecte à smtp.emailit.com, passe la connexion en TLS et s’authentifie avec une clé API.
2. Elle envoie l’expéditeur d’enveloppe, une commande de destinataire par destinataire, puis le message.
3. Emailit contrôle l’espace de travail, les limites de débit, la taille du message et le domaine de l’en-tête From, puis répond 250 2.0.0 OK: queued as em_….
4. Chaque destinataire devient un e-mail distinct avec son propre ID em_. Emailit le signe avec DKIM, effectue les contrôles anti-spam, le livre et réessaie en cas d’échec temporaire, exactement comme pour les e-mails envoyés via l’API.

Paramètres de connexion

La page de chaque clé API dans Email API›API Keys affiche ces mêmes informations sur sa carte SMTP Info. Paramètres SMTP détaille chaque port, les règles d’adresse d’expéditeur et les limites.

Envoyer un message de test

cat > message.txt <<'EOF'
From: Acme <hello@acme.com>
To: ada@example.com
Subject: SMTP test from Acme

It works.
EOF

curl --url "smtp://smtp.emailit.com:587" --ssl-reqd --crlf \
  --user "emailit:$EMAILIT_API_KEY" \
  --mail-from hello@acme.com \
  --mail-rcpt ada@example.com \
  --upload-file message.txt -v

import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtp.emailit.com',
  port: 587,
  secure: false, // STARTTLS on 587
  requireTLS: true,
  auth: { user: 'emailit', pass: process.env.EMAILIT_API_KEY },
});

const info = await transporter.sendMail({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'SMTP test from Acme',
  text: 'It works.',
});

console.log(info.response); // 250 2.0.0 OK: queued as em_…

import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "SMTP test from Acme"
msg.set_content("It works.")

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

use PHPMailer\PHPMailer\PHPMailer;

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.emailit.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = 'emailit';
$mail->Password = getenv('EMAILIT_API_KEY');

$mail->setFrom('hello@acme.com', 'Acme');
$mail->addAddress('ada@example.com');
$mail->Subject = 'SMTP test from Acme';
$mail->Body = 'It works.';
$mail->send();

Les nouveaux espaces de travail sont en mode bac à sable et ne peuvent envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail. Demandez l’accès production avant d’envoyer à quelqu’un d’autre.

Affichage des e-mails SMTP dans Emailit

• Un e-mail par destinataire. Un message à trois destinataires crée trois e-mails, chacun avec son propre ID em_, son statut et ses événements.
• Les ID dans la réponse. La réponse 250 qui suit le message liste les nouveaux ID, par exemple 250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. Ce sont les mêmes ID que ceux qu’utilisent l’API, le tableau de bord et les webhooks. Consultez En-têtes et réponses SMTP.
• Liste des e-mails. Les e-mails apparaissent dans Email API›Emails. Filtrez par API key pour voir les e-mails d’une application.
• Logs. Chaque message soumis apparaît dans Email API›Logs avec la source SMTP et son code de réponse, ainsi que les refus liés aux limites de débit et les échecs d’authentification. Consultez Logs de requêtes.
• Webhooks. Les e-mails SMTP émettent les mêmes événements de livraison et d’engagement que les e-mails envoyés via l’API, sauf email.accepted. Le premier événement est généralement email.delivered.

Différences entre SMTP et l’API e-mail

Emailit ne lit pas les en-têtes de contrôle X-Emailit-* dans les messages SMTP. Consultez En-têtes SMTP.

Limites

Les espaces de travail Pro et Business bénéficient de hausses de limite automatiques selon leur santé d’envoi, et tout espace de travail peut en demander davantage depuis la carte Sending Limits de la page d’accueil du tableau de bord. Consultez Limites.

Étapes suivantes