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
Fromdeve pertencer a um domínio verificado da equipe da chave. - É obrigatório um
Subjectnã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(nomesX-*, 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. |