SMTP
Integração SMTP
Envie emails usando o protocolo SMTP padrão. Pegue suas credenciais na página SMTP Settings do seu dashboard.
Antes de começar
As credenciais SMTP só podem ser geradas quando você já pode enviar. Escolha o caminho que combina com a forma como você envia:
Seu próprio domínio
Domínio verificado
Adicione seu domínio de envio e publique os registros DNS. Quando ele aparecer como verificado, você pode enviar de qualquer endereço nele.
Abrir Domínios →Domínio compartilhado
Remetente cadastrado
Não tem domínio próprio? Cadastre o endereço de remetente que você quer usar. Só remetentes cadastrados podem enviar em um domínio compartilhado.
Abrir Remetentes →Depois pegue suas credenciais: abra Dashboard → SMTP Settings para gerar seu usuário e senha.
Configurações do servidor
Host
smtp.emailsbit.com
Hostname do servidor SMTP
Portas
505 · 588
Portas de conexão disponíveis (588 recomendada, com STARTTLS)
Segurança
STARTTLS
Protocolo de segurança recomendado
Porta 505
NenhumaConexão sem criptografia (não recomendada em produção)
Porta 588
STARTTLSrecomendadaCriptografia TLS oportunista — começa em texto puro e passa para TLS
Boas práticas de segurança: Nunca coloque credenciais fixas no código-fonte. Use variáveis de ambiente ou um gerenciador de segredos seguro.
Transacional
Confirmações de pedido, redefinição de senha, recibos. Conecte na porta 588 com STARTTLS e envie. Sem headers extras.
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
host: 'smtp.emailsbit.com',
port: 588,
secure: false, // STARTTLS: starts as plain text, upgrades to TLS
requireTLS: true,
auth: {
user: process.env.SMTP_USER,
pass: process.env.SMTP_PASS,
},
});
async function main() {
await transporter.sendMail({
from: '"Support" <support@yourdomain.com>',
to: 'user@example.com',
subject: 'Your Order Confirmation',
html: '<h2>Thank you for your purchase!</h2>',
});
}
main().catch(console.error);Cc e Bcc também funcionam: use as opções cc e bcc da sua biblioteca e cada endereço recebe sua própria cópia. Exemplos em todas as linguagens estão em CC & BCC.
Marketing
Newsletters e campanhas. Adicione os headers de lista abaixo para que os clientes de email mostrem um botão de descadastro e as reclamações sejam rastreadas por campanha. Eles são lidos e aplicados automaticamente, sem chamada extra à API.
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
host: 'smtp.emailsbit.com',
port: 588,
secure: false, // STARTTLS: starts as plain text, upgrades to TLS
requireTLS: true,
auth: {
user: process.env.SMTP_USER,
pass: process.env.SMTP_PASS,
},
});
async function main() {
await transporter.sendMail({
from: '"Support" <support@yourdomain.com>',
to: 'user@example.com',
subject: 'Our October newsletter',
html: '<h2>What is new this month</h2>',
headers: {
'List-Id': 'My List <mylist.yourdomain.com>',
'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
'List-Unsubscribe': '<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
},
});
}
main().catch(console.error);Headers reservados
Estes cinco são aceitos como estão, sem o prefixo X-.
List-IdIdentifica a lista de email ou o fluxo de envio ao qual a mensagem pertence. Provedores e clientes de email o usam para agrupar e filtrar mensagens da mesma lista.
Nome de exibição seguido de um identificador da lista entre sinais de menor e maior.
My List <mylist.yourdomain.com>
X-Report-AbuseUma URL onde os destinatários podem denunciar a mensagem como abuso ou spam.
Uma URL completa.
https://yourdomain.com/report-abuse
Feedback-IDMarca a mensagem com seus próprios identificadores para que os relatórios de feedback loop (como as taxas de reclamação no Gmail Postmaster Tools) possam ser separados por campanha, assinante ou lista.
Campos separados por dois-pontos: campanha : assinante : lista : sua conta.
campaign123:subscriber456:list789:youraccount
List-UnsubscribeInforma aos clientes de email como descadastrar o destinatário, o que ativa o botão nativo de "Unsubscribe" ao lado do nome do remetente.
Uma ou mais URIs entre sinais de menor e maior, separadas por vírgulas. Aceita URIs mailto: e https:.
<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>
List-Unsubscribe-PostAtiva o descadastro com um clique (RFC 8058). O cliente de email envia uma requisição POST para a URI https do List-Unsubscribe, sem página de confirmação no meio.
O valor fixo abaixo. Exige uma URI https no List-Unsubscribe.
List-Unsubscribe=One-Click
Descadastro com um clique
Defina List-Unsubscribe e List-Unsubscribe-Post juntos e o destinatário pode se descadastrar direto do cliente de email.
- 1
Adicione os dois headers
Defina List-Unsubscribe com uma URL https e List-Unsubscribe-Post com o valor fixo.
- 2
O destinatário clica em Unsubscribe
O cliente de email mostra o próprio botão. O destinatário nunca visita o seu site.
- 3
O cliente envia um POST
A requisição vai para a sua URL https com o body abaixo, sem cookies e sem interação do usuário.
- 4
Seu endpoint faz o descadastro
Remova o destinatário e responda com status 2xx. Não redirecione nem peça login.
Requisição que seu endpoint recebe
POST /unsubscribe?u=123 HTTP/1.1 Host: yourdomain.com Content-Type: application/x-www-form-urlencoded List-Unsubscribe=One-Click
Limite de marketing do plano free
No plano free você pode enviar até 30 emails de marketing ou cold outreach por dia. Quando uma mensagem passaria desse limite, o servidor recusa no fim do DATA com:
550 5.7.1 Daily marketing limit reached for the free plan (30/30, 2 recipients in this email). Transactional emails still go out. Upgrade: https://app.sendcorex.com/dashboard/billing
Contado por destinatário: um email para 5 pessoas conta 5.
Janela móvel de 24 horas, não dia do calendário.
Emails transacionais não são afetados e continuam saindo.
Nada fica na fila: envie de novo quando a janela liberar, ou faça upgrade. Planos pagos não têm limite de marketing separado.
Toda mensagem é classificada automaticamente como transacional ou marketing; não existe configuração para escolher. Regras completas: Política de Uso Aceitável — Plano free
Headers personalizados
Anexe seus próprios metadados a qualquer mensagem, transacional ou de marketing, com um header que comece com X-.
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
host: 'smtp.emailsbit.com',
port: 588,
secure: false, // STARTTLS: starts as plain text, upgrades to TLS
requireTLS: true,
auth: {
user: process.env.SMTP_USER,
pass: process.env.SMTP_PASS,
},
});
async function main() {
await transporter.sendMail({
from: '"Support" <support@yourdomain.com>',
to: 'user@example.com',
subject: 'Your Order Confirmation',
html: '<h2>Thank you for your purchase!</h2>',
headers: {
'X-MyCustomHeader': 'testcustom0',
'X-CUSTOM-X': 'testcustom1',
},
});
}
main().catch(console.error);Restrição de nome: qualquer header fora da lista reservada precisa ter o prefixo X-, ou a mensagem é rejeitada com HEADER_NOT_ALLOWED.
Válido
"X-MyCustomHeader": "testcustom0" "X-CUSTOM-X": "testcustom1"
Inválido
"MyCustomHeader": "testcustom0"
→ HEADER_NOT_ALLOWED
Retentativas e hard bounces: controle por email com headers X-Sendcorex-* — veja Opções de entrega.