Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Relay SMTP

Envie pelo BillionSend a partir de qualquer coisa que fale SMTP.

O relay SMTP recebe e-mail de qualquer cliente SMTP ou biblioteca de e-mail de framework e o envia como POST /emails: mesmas verificações de remetente, supressões, limites do plano e eventos.

Conectar

Configuração Valor
Host smtp.billionsend.com
Porta, STARTTLS 587
Porta, TLS implícito 465
Usuário billionsend
Senha Uma chave de API (bs_...)

TLS é obrigatório nas duas portas. Uma chave só de envio, ou limitada a um domínio ou a uma caixa de entrada, mantém esses limites por SMTP.

curl --ssl-reqd smtp://smtp.billionsend.com:587 \
  --user "billionsend:$BILLIONSEND_API_KEY" \
  --mail-from hello@mail.example.com \
  --mail-rcpt user@example.org \
  -T message.eml

O que o relay verifica

  • O endereço From deve pertencer a um domínio verificado da equipe da chave.
  • É obrigatório um Subject não vazio e um corpo em HTML ou texto.
  • Uma mensagem pode ter até 40 MiB e até 50 destinatários.
  • Os anexos seguem as mesmas regras da API: programas e tipos de arquivo disfarçados são recusados.
  • Os cabeçalhos seguem a mesma lista permitida de POST /emails (nomes X-*, encadeamento, prioridade, List-Unsubscribe). O BillionSend escreve todos os outros cabeçalhos.
  • Três logins com falha encerram a conexão. Uma sessão dura no máximo 15 minutos, e um mesmo endereço IP pode manter no máximo 10 conexões.

Limites de taxa e novas tentativas

As mensagens contam no mesmo limite por minuto das requisições de API da chave. Acima dele, o relay responde 451 4.7.1 com os segundos de espera. Clientes SMTP tentam de novo sozinhos.

Se um cliente nunca viu o 250 final e reenvia a mesma mensagem com o mesmo Message-ID, recebe a primeira resposta de volta, em vez de um segundo e-mail.

Erros

Resposta Significado
530 / 535 Credenciais ausentes ou erradas
550 Remetente não permitido para esta chave, ou destinatário que não pode receber e-mail
552 Mensagem ou anexo grande demais
553 Assunto ausente ou endereço malformado
554 Mensagem recusada, por exemplo domínio do remetente não verificado ou cabeçalho não permitido
451, 452 Temporário: limite de taxa ou capacidade. Tente de novo.

Esta página foi útil?