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 →
i

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

Nenhuma

Conexão sem criptografia (não recomendada em produção)

Porta 588

STARTTLSrecomendada

Criptografia 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);
i

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-Id

Identifica 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-Abuse

Uma URL onde os destinatários podem denunciar a mensagem como abuso ou spam.

Uma URL completa.

https://yourdomain.com/report-abuse
Feedback-ID

Marca 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-Unsubscribe

Informa 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-Post

Ativa 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. 1

    Adicione os dois headers

    Defina List-Unsubscribe com uma URL https e List-Unsubscribe-Post com o valor fixo.

  2. 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. 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. 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

i

Retentativas e hard bounces: controle por email com headers X-Sendcorex-* — veja Opções de entrega.