Voltar ao correio
Enviar via código
Envie e-mails do seu aplicativo usando qualquer biblioteca SMTP. Mostramos o fluxo Node.js / nodemailer porque é o mais comum - todas as outras linguagens usam exatamente os mesmos campos.
Instale o nodemailer
terminal
npm install nodemailer
# or
pnpm add nodemailer
# or
bun add nodemailerTransportador mínimo
mailer.ts
import nodemailer from "nodemailer";
export const transporter = nodemailer.createTransport({
host: process.env.SMTP_HOST!, // smtp host from the right rail
port: Number(process.env.SMTP_PORT), // 587
secure: false, // STARTTLS upgrades after connect
requireTLS: true, // refuse if TLS upgrade is unavailable
auth: {
user: process.env.SMTP_USER!, // your full email address
pass: process.env.SMTP_PASS!, // postmaster password - keep in .env
},
});Por que porta 587 + STARTTLS em vez de 465 + segura: verdadeira? Ambos funcionam. 587/STARTTLS é o padrão de envio moderno e é o que a maioria dos clientes escolhe. 465 (TLS implícito) também é suportado - defina
port: 465, secure: true e remova requireTLS.Envie uma mensagem
send.ts
import { transporter } from "./mailer";
await transporter.sendMail({
from: '"Your App" <[email protected]>',
to: "[email protected]",
subject: "Hello from your self-hosted mail server",
text: "Plain-text body.",
html: "<p>HTML body too - clients pick whichever they prefer.</p>",
});Verifique a conexão primeiro
Na inicialização, execute ping no servidor para que uma configuração quebrada falhe rapidamente em vez de esperar que o primeiro sendMail expire:
boot.ts
await transporter.verify();
console.log("SMTP ready");De outras línguas
A forma é idêntica em todas as bibliotecas – host, porta, modo TLS, nome de usuário, senha.
python · smtplib
import smtplib
from email.message import EmailMessage
msg = EmailMessage()
msg["From"] = "[email protected]"
msg["To"] = "[email protected]"
msg["Subject"] = "Hello"
msg.set_content("Plain text body")
with smtplib.SMTP("smtp.yourdomain.com", 587) as s:
s.starttls()
s.login("[email protected]", "PASSWORD")
s.send_message(msg)go · net/smtp
auth := smtp.PlainAuth("",
"[email protected]",
"PASSWORD",
"smtp.yourdomain.com",
)
err := smtp.SendMail(
"smtp.yourdomain.com:587",
auth,
"[email protected]",
[]string{"[email protected]"},
[]byte("Subject: Hello\r\n\r\nbody"),
)Lista de verificação de produção
- 1Nunca confirme a senha. Usar variáveis de ambiente carregado em tempo de execução (Vercel/Railway/Fly todos fazem isso; use localmente
.env.local). - 2Mantenha um único transportador instância durante a vida útil do seu processo - abrir um novo handshake TCP + TLS por e-mail elimina o rendimento.
- 3Defina o De endereço para uma caixa de correio que existe neste servidor. Endereços De estrangeiros são rejeitados pela sua política SPF + DMARC.
- 4Para volume transacional, execute verificar() na inicialização e adicione novas tentativas enviar e-mail; blips transitórios da rede são normais.
- 5Verifique a guia Integridade em seu administrador OpenShip se o e-mail parar de ser enviado - a fila de saída reside lá.