Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

SMTP relay

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.

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 (bs_...), como una credencial SMTP de la página SMTP (consulta claves de API)

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.

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

¿Te ha resultado útil esta página?