SMTP relay

SMTP relay Emailitu přijímá poštu od čehokoli, co umí odesílat přes SMTP, například od CMS, maileru frameworku, monitorovacího nástroje nebo skeneru, a doručuje ji stejnou cestou jako e-mailové API. Použijte ho, když je změna nastavení SMTP jednodušší než psaní kódu pro API.

Kdy použít SMTP

SMTP se hodí, když:

• Váš software podporuje jen SMTP, jako pluginy pro WordPress, helpdesky a síťová zařízení.
• Přecházíte od jiného poskytovatele a chcete změnit jen hostitele a přístupové údaje.
• Váš framework už má SMTP mailer, jako Laravel, Django, Rails a Nodemailer.

API zvolte, když potřebujete šablony s proměnnými, plánování, metadata, idempotenční klíče nebo nastavení měření pro jednotlivé e-maily. Úplné srovnání najdete na stránce Volba mezi API a SMTP.

Jak to funguje

1. Vaše aplikace se připojí k smtp.emailit.com, přepne spojení na TLS a přihlásí se API klíčem.
2. Pošle odesílatele v obálce, jeden příkaz pro každého příjemce a zprávu.
3. Emailit zkontroluje workspace, limity rychlosti, velikost zprávy a doménu v hlavičce From a pak odpoví 250 2.0.0 OK: queued as em_….
4. Každý příjemce se stane samostatným e-mailem s vlastním ID em_. Emailit ho podepíše DKIM, provede kontroly spamu, doručí ho a dočasné chyby zkouší znovu, přesně jako u pošty z API.

Údaje pro připojení

Stránka každého API klíče v Email API›API Keys ukazuje stejné údaje v panelu SMTP Info. Všechny porty, pravidla pro adresu odesílatele a limity popisuje stránka Nastavení SMTP.

Pošlete testovací zprávu

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();

Nové workspace jsou v režimu sandbox a mohou posílat jen na e-maily účtů členů workspace. Než začnete posílat komukoli jinému, požádejte o produkční přístup.

Jak se pošta ze SMTP zobrazuje v Emailitu

• Jeden e-mail na příjemce. Zpráva se třemi příjemci vytvoří tři e-maily, každý s vlastním ID em_, stavem a událostmi.
• ID v odpovědi. Odpověď 250 po zprávě uvádí nová ID, například 250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. Jsou to stejná ID, jaká používá API, webové rozhraní a webhooky. Viz Hlavičky a odpovědi SMTP.
• Seznam e-mailů. E-maily se zobrazují v Email API›Emails. Filtrem API key zobrazíte poštu jedné aplikace.
• Logy. Každá odeslaná zpráva se objeví v Email API›Logs se zdrojem SMTP a kódem odpovědi, spolu s odmítnutími kvůli limitu rychlosti a neúspěšnými přihlášeními. Viz Logy požadavků.
• Webhooky. Pošta ze SMTP vyvolává stejné události doručení a zapojení jako pošta z API, kromě email.accepted. První událostí je obvykle email.delivered.

Čím se SMTP liší od e-mailového API

Emailit ve zprávách přes SMTP nečte řídicí hlavičky X-Emailit-*. Viz Hlavičky a odpovědi SMTP.

Limity

Workspace s tarifem Pro a Business dostávají automatická navýšení limitů podle kondice odesílání a každý workspace může požádat o víc v panelu Sending Limits na úvodní stránce webového rozhraní. Viz Limity a kvóty.

Další kroky