SMTP relay

O SMTP relay do Emailit aceita e-mails de qualquer coisa que consiga enviar por SMTP, como um CMS, o mailer de um framework, uma ferramenta de monitoramento ou um scanner, e os entrega pelo mesmo pipeline da API de e-mail. Use-o quando for mais fácil alterar as configurações SMTP do que escrever código para a API.

Quando usar o SMTP

O SMTP é uma boa escolha quando:

• O seu software só tem suporte a SMTP, como plugins do WordPress, help desks e dispositivos de rede.
• Você está vindo de outro provedor e quer trocar apenas o host e as credenciais.
• O seu framework já tem um mailer SMTP, como o Laravel, o Django, o Rails e o Nodemailer.

Escolha a API quando precisar de templates com variáveis, agendamento, metadados, chaves de idempotência ou configurações de rastreamento por e-mail. Consulte API ou SMTP? para uma comparação completa.

Como funciona

1. A sua aplicação se conecta a smtp.emailit.com, passa a conexão para TLS e faz login com uma chave de API.
2. Ela envia o remetente do envelope, um comando de destinatário por destinatário e a mensagem.
3. O Emailit verifica o workspace, os limites de envio, o tamanho da mensagem e o domínio do cabeçalho From, e então responde 250 2.0.0 OK: queued as em_….
4. Cada destinatário vira um e-mail separado, com o seu próprio ID em_. O Emailit o assina com DKIM, executa as verificações de spam, entrega-o e tenta de novo em caso de falhas temporárias, exatamente como faz com os e-mails da API.

Dados de conexão

A página de cada chave de API em Email API›API Keys mostra os mesmos dados no card SMTP Info. Configurações SMTP cobre todas as portas, as regras do endereço From e os limites.

Enviar uma mensagem de teste

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

Os workspaces novos estão no modo sandbox e só podem enviar para os e-mails das contas dos membros do workspace. Solicite o acesso de produção antes de enviar para qualquer outra pessoa.

Como os e-mails enviados por SMTP aparecem no Emailit

• Um e-mail por destinatário. Uma mensagem com três destinatários cria três e-mails, cada um com o seu próprio ID em_, status e eventos.
• IDs na resposta. A resposta 250 depois da mensagem lista os novos IDs, por exemplo 250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa. São os mesmos IDs que a API, o painel e os webhooks usam. Consulte Cabeçalhos e respostas SMTP.
• Lista de e-mails. Os e-mails aparecem em Email API›Emails. Filtre por API key para ver os e-mails de uma aplicação.
• Logs. Cada mensagem enviada aparece em Email API›Logs com a origem SMTP e o código de resposta dela, junto com as rejeições por limite de envio e as falhas de login. Consulte Logs de requisições.
• Webhooks. Os e-mails enviados por SMTP emitem os mesmos eventos de entrega e engajamento que os e-mails da API, mas não email.accepted. O primeiro evento normalmente é email.delivered.

Como o SMTP difere da API de e-mail

O Emailit não lê cabeçalhos de controle X-Emailit-* nas mensagens SMTP. Consulte Cabeçalhos SMTP.

Limites

Os workspaces no Pro e no Business recebem aumentos automáticos de limite com base na saúde de envio, e qualquer workspace pode pedir mais pelo card Sending Limits na página inicial do painel. Consulte Limites.

Próximos passos