---
title: Relay SMTP
description: Envie pelo BillionSend a partir de qualquer coisa que fale SMTP.
ai:
  exclude: true
---

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](/docs/pt-br/api-reference/basics) (`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.

```bash
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](/docs/pt-br/concepts/domains) 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. |
