Panoramica
SMTP relay
Invia email da qualsiasi app, framework o dispositivo che parla SMTP. Dati di connessione, come compare in Emailit la posta inoltrata e in cosa SMTP differisce dall’API.
L’SMTP relay di Emailit accetta posta da qualsiasi cosa sappia inviare via SMTP, come un CMS, il mailer di un framework, uno strumento di monitoraggio o uno scanner, e la consegna attraverso la stessa pipeline dell’API email. Usalo quando cambiare le impostazioni SMTP è più semplice che scrivere codice per l’API.
Quando usare SMTP
SMTP è la scelta giusta quando:
- Il tuo software supporta solo SMTP, come i plugin di WordPress, gli help desk e i dispositivi di rete.
- Stai passando da un altro provider e vuoi cambiare solo host e credenziali.
- Il tuo framework ha già un mailer SMTP, come Laravel, Django, Rails e Nodemailer.
Scegli l’API quando ti servono template con variabili, programmazione, metadati, chiavi di idempotenza o impostazioni di tracciamento per singola email. Per un confronto completo, vedi API o SMTP.
Come funziona
- La tua applicazione si collega a
smtp.emailit.com, passa la connessione a TLS e accede con una chiave API. - Invia il mittente della busta, un comando destinatario per ogni destinatario e il messaggio.
- Emailit controlla il workspace, i limiti di frequenza, la dimensione del messaggio e il dominio nell’header From, poi risponde
250 2.0.0 OK: queued as em_…. - Ogni destinatario diventa un’email separata con il proprio ID
em_. Emailit la firma con DKIM, esegue i controlli antispam, la consegna e ritenta gli errori temporanei, esattamente come per la posta inviata con l’API.
Dati di connessione
| Impostazione | Valore |
|---|---|
| Host | smtp.emailit.com |
| Porta | 587 con STARTTLS. Anche 465 (TLS implicito), e 2525 o 2587 (STARTTLS) per le reti che bloccano la 587. |
| Nome utente | emailit |
| Password | Una chiave API, che inizia con secret_ |
| Autenticazione | PLAIN o LOGIN |
La pagina di ogni chiave API in Email APIAPI Keys mostra gli stessi dati nel riquadro SMTP Info. Impostazioni SMTP descrive tutte le porte, le regole per l’indirizzo From e i limiti.
Invia un messaggio di prova
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 -vimport 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();I nuovi workspace sono in modalità sandbox e possono inviare solo alle email degli account dei membri del workspace. Richiedi l’accesso alla produzione prima di inviare a chiunque altro.
Come compare in Emailit la posta SMTP
- Un’email per destinatario. Un messaggio con tre destinatari crea tre email, ciascuna con il proprio ID
em_, il proprio stato e i propri eventi. - ID nella risposta. La risposta
250dopo il messaggio elenca i nuovi ID, ad esempio250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. Sono gli stessi ID usati dall’API, dal pannello e dai webhook. Vedi Header e risposte SMTP. - Elenco delle email. Le email compaiono in Email APIEmails. Filtra per API key per vedere la posta di una singola applicazione.
- Log. Ogni messaggio inviato compare in Email APILogs con l’origine SMTP e il relativo codice di risposta, insieme ai rifiuti per limite di frequenza e agli accessi non riusciti. Vedi Log delle richieste.
- Webhook. La posta SMTP genera gli stessi eventi di consegna e di engagement della posta inviata con l’API, ma non
email.accepted. Di solito il primo evento èemail.delivered.
Differenze tra SMTP e API email
| Funzione | API email | SMTP relay |
|---|---|---|
| Template e variabili Temple | Sì | No. Il messaggio viene inviato così come l’hai costruito. |
| Invio programmato | Sì, con scheduled_at |
No |
| Metadati | Sì, con meta |
No |
| Tracciamento di aperture e clic | Impostazioni del dominio, o per singola email con tracking |
Solo le impostazioni Track loads e Track clicks del dominio di invio |
| Chiavi di idempotenza | Sì | No |
Evento email.accepted |
Sì | No |
| Destinatari per messaggio | Fino a 50 ciascuno in to, cc e bcc |
Nessun limite fisso |
| Quando vengono addebitati i crediti | Quando la richiesta viene accettata. Con crediti insufficienti la risposta è 402. |
Quando ogni email viene elaborata. Con crediti insufficienti l’email viene trattenuta. |
| Cosa conta il limite di frequenza | Ogni destinatario | Ogni transazione SMTP (un messaggio) |
| Dimensione massima del messaggio | 40 MB | 40 MB |
Emailit non legge gli header di controllo X-Emailit-* nei messaggi SMTP. Vedi Header e risposte SMTP.
Limiti
| Limite | Valore |
|---|---|
| Dimensione del messaggio | 40 MB |
| Velocità di invio (predefinita) | 2 messaggi al secondo e 5000 messaggi al giorno per workspace, condivisi con l’API |
| Azzeramento giornaliero | Mezzanotte UTC |
| Crediti | 1 per destinatario |
I workspace Pro e Business ricevono aumenti automatici dei limiti in base alla salute degli invii, e qualsiasi workspace può chiederne di più dal riquadro Sending Limits della home page del pannello. Vedi Limiti e quote.