---
title: SMTP relay
description: "Usa el SMTP relay de BillionSend desde cualquier cliente SMTP o mailer de framework: servidor, puertos, TLS, límites de tasa y cada código de respuesta."
ai:
  exclude: true
---

El SMTP relay recibe correo de cualquier cliente SMTP o mailer de framework y lo envía como `POST /emails`: las mismas comprobaciones de remitente, supresiones, límites del plan y eventos.

## Conexión

| Ajuste | Valor |
| --- | --- |
| Servidor SMTP (host) | `smtp.billionsend.com` |
| Puerto, STARTTLS | `587` |
| Puerto, TLS implícito | `465` |
| Usuario | `billionsend` |
| Contraseña | Una [clave de API](/docs/es/api-reference/basics) (`bs_...`), como una credencial SMTP de la página **SMTP** (consulta [claves de API](/docs/es/api-keys)) |

TLS es obligatorio en ambos puertos. Una clave solo de envío, o limitada a un dominio o a una bandeja de entrada, mantiene esos límites por SMTP.

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

## Qué comprueba el SMTP relay

- La dirección `From` debe pertenecer a un [dominio verificado](/docs/es/concepts/domains) del equipo de la clave.
- Se exigen un `Subject` no vacío y un cuerpo en HTML o texto.
- Un mensaje puede pesar hasta 40 MiB y tener hasta 50 destinatarios.
- Los adjuntos siguen las mismas reglas que la API: se rechazan los programas y los tipos de archivo disfrazados.
- Las cabeceras siguen la misma lista permitida que `POST /emails` (nombres `X-*`, hilos, prioridad, `List-Unsubscribe`). BillionSend escribe él mismo todas las demás cabeceras.
- Tres inicios de sesión fallidos cierran la conexión. Una sesión dura 15 minutos como máximo, y una misma dirección IP puede mantener como máximo 10 conexiones.

## Límites de tasa y reintentos

Los mensajes cuentan en el mismo límite por minuto que las peticiones de API de la clave. Por encima de él, el relay responde `451 4.7.1` con los segundos de espera. Los clientes SMTP reintentan por su cuenta.

Si un cliente nunca recibió el `250` final y reenvía el mismo mensaje con el mismo `Message-ID`, recibe de vuelta la primera respuesta en lugar de un segundo email.

## Errores

| Respuesta | Significado |
| --- | --- |
| `530` / `535` | Credenciales ausentes o incorrectas |
| `550` | Remitente no permitido para esta clave, destinatario que no puede recibir correo, todos los destinatarios suprimidos o equipo suspendido |
| `552` | Mensaje o adjunto demasiado grande |
| `553` | Asunto ausente o dirección mal formada |
| `554` | Mensaje rechazado, por ejemplo por un dominio de remitente sin verificar o una cabecera no permitida |
| `451` | Temporal: por encima del límite por minuto (`4.7.1`, con los segundos de espera) o envío en pausa mientras se recuperan tus tasas. Reintenta. |
| `452` | Más de 50 destinatarios (envía el resto en otro mensaje), o una cuota agotada: la cola diaria está llena, el volumen mensual se ha agotado (se libera al renovarse el periodo), la cola de calentamiento de un dominio nuevo está llena o se ha alcanzado el límite diario de envío de la bandeja de entrada |
