Ejemplos de Integración SMTP
Prólogo
Esta guía muestra cómo integrarse con el servicio SMTP de Forward Email desde varios lenguajes de programación, frameworks y clientes de correo.
Cómo Funciona el Procesamiento SMTP de Forward Email
Nuestro servicio SMTP procesa los correos electrónicos de la siguiente manera:
Cola de Correos y Sistema de Reintentos
Cuando envías un correo vía SMTP a nuestros servidores:
- Procesamiento Inicial: El correo es validado, escaneado en busca de malware y revisado contra filtros de spam
- Cola: Nuestro sistema coloca los correos en una cola de entrega
- Mecanismo de Reintentos: Si la entrega falla temporalmente, nuestro sistema:
- Analiza la respuesta de error usando nuestra función
getBounceInfo - Determina si el problema es temporal (por ejemplo, "intenta más tarde", "temporalmente diferido") o permanente (por ejemplo, "usuario desconocido")
- Para problemas temporales, marca el correo para reintento
- Para problemas permanentes, genera una notificación de rebote
- Analiza la respuesta de error usando nuestra función
- Periodo de Reintentos de 5 Días: Reintentamos la entrega hasta por 5 días (similar a estándares de la industria como Postfix), dando tiempo para resolver problemas temporales
- Notificaciones de Estado de Entrega: Los remitentes reciben notificaciones sobre el estado de sus correos (entregado, retrasado o rebotado)
Note
Después de la entrega exitosa, el contenido del correo SMTP saliente se redacta tras un periodo configurable de retención (por defecto 30 días) por seguridad y privacidad. Solo queda un mensaje marcador de posición indicando la entrega exitosa.
A Prueba de Errores para Mayor Confiabilidad
Nuestro sistema maneja estos casos límite:
- Si se detecta una lista negra, el correo será reintentado automáticamente
- Si ocurren problemas de red, la entrega será reintentada
- Si el buzón del destinatario está lleno, el sistema reintentará más tarde
- Si el servidor receptor está temporalmente no disponible, seguiremos intentando
Este enfoque mejora las tasas de entrega mientras mantiene la privacidad y seguridad.
Integración con Node.js
Usando Nodemailer
Nodemailer es un módulo popular para enviar correos desde aplicaciones Node.js.
const nodemailer = require('nodemailer');
// Crear un objeto transporter
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true, // Usar TLS
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// Enviar correo con el objeto de transporte definido
async function sendEmail() {
try {
const info = await transporter.sendMail({
from: '"Tu Nombre" <your-username@your-domain.com>',
to: 'recipient@example.com',
subject: 'Hola desde Forward Email',
text: '¡Hola mundo! Este es un correo de prueba enviado usando Nodemailer y Forward Email SMTP.',
html: '<b>¡Hola mundo!</b> Este es un correo de prueba enviado usando Nodemailer y Forward Email SMTP.'
});
console.log('Mensaje enviado: %s', info.messageId);
} catch (error) {
console.error('Error al enviar el correo:', error);
}
}
sendEmail();
Usando Express.js
Aquí se explica cómo integrar Forward Email SMTP con una aplicación Express.js:
const express = require('express');
const nodemailer = require('nodemailer');
const app = express();
const port = 3000;
app.use(express.json());
// Configurar el transportador de correo
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true,
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// Punto final API para enviar correos
app.post('/send-email', async (req, res) => {
const { to, subject, text, html } = req.body;
try {
const info = await transporter.sendMail({
from: '"Your App" <your-username@your-domain.com>',
to,
subject,
text,
html
});
res.status(200).json({
success: true,
messageId: info.messageId
});
} catch (error) {
console.error('Error enviando correo:', error);
res.status(500).json({
success: false,
error: error.message
});
}
});
app.listen(port, () => {
console.log(`Servidor corriendo en http://localhost:${port}`);
});
Integración con Python
Usando smtplib
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
# Configuración del correo
sender_email = "your-username@your-domain.com"
receiver_email = "recipient@example.com"
password = "your-password"
# Crear mensaje
message = MIMEMultipart("alternative")
message["Subject"] = "Hola desde Forward Email"
message["From"] = sender_email
message["To"] = receiver_email
# Crear la versión en texto plano y HTML de tu mensaje
text = "¡Hola mundo! Este es un correo de prueba enviado usando Python y Forward Email SMTP."
html = "<html><body><b>¡Hola mundo!</b> Este es un correo de prueba enviado usando Python y Forward Email SMTP.</body></html>"
# Convertir estos en objetos MIMEText de texto plano/HTML
part1 = MIMEText(text, "plain")
part2 = MIMEText(html, "html")
# Añadir partes HTML/texto plano al mensaje MIMEMultipart
message.attach(part1)
message.attach(part2)
# Enviar correo
try:
server = smtplib.SMTP_SSL("smtp.forwardemail.net", 465)
server.login(sender_email, password)
server.sendmail(sender_email, receiver_email, message.as_string())
server.quit()
print("¡Correo enviado con éxito!")
except Exception as e:
print(f"Error enviando correo: {e}")
Usando Django
Para aplicaciones Django, añade lo siguiente a tu settings.py:
# Configuración de correo
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.forwardemail.net'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'your-username@your-domain.com'
EMAIL_HOST_PASSWORD = 'your-password'
DEFAULT_FROM_EMAIL = 'your-username@your-domain.com'
Luego envía correos en tus vistas:
from django.core.mail import send_mail
def send_email_view(request):
send_mail(
'Asunto aquí',
'Aquí está el mensaje.',
'from@your-domain.com',
['to@example.com'],
fail_silently=False,
html_message='<b>Aquí está el mensaje HTML.</b>'
)
return HttpResponse('¡Correo enviado!')
Integración con PHP
Usando PHPMailer
<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
try {
// Configuración del servidor
$mail->isSMTP();
$mail->Host = 'smtp.forwardemail.net';
$mail->SMTPAuth = true;
$mail->Username = 'your-username@your-domain.com';
$mail->Password = 'your-password';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port = 465;
// Destinatarios
$mail->setFrom('your-username@your-domain.com', 'Tu Nombre');
$mail->addAddress('recipient@example.com', 'Nombre del Destinatario');
$mail->addReplyTo('your-username@your-domain.com', 'Tu Nombre');
// Contenido
$mail->isHTML(true);
$mail->Subject = 'Hola desde Forward Email';
$mail->Body = '<b>¡Hola mundo!</b> Este es un correo de prueba enviado usando PHPMailer y Forward Email SMTP.';
$mail->AltBody = '¡Hola mundo! Este es un correo de prueba enviado usando PHPMailer y Forward Email SMTP.';
$mail->send();
echo 'Mensaje enviado';
} catch (Exception $e) {
echo "El mensaje no pudo ser enviado. Error de Mailer: {$mail->ErrorInfo}";
}
Usando Laravel
Para aplicaciones Laravel, actualice su archivo .env:
MAIL_MAILER=smtp
MAIL_HOST=smtp.forwardemail.net
MAIL_PORT=465
MAIL_USERNAME=your-username@your-domain.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=your-username@your-domain.com
MAIL_FROM_NAME="${APP_NAME}"
Luego envíe correos usando la fachada Mail de Laravel:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Mail;
use App\Mail\WelcomeEmail;
class EmailController extends Controller
{
public function sendEmail()
{
Mail::to('recipient@example.com')->send(new WelcomeEmail());
return '¡Correo enviado con éxito!';
}
}
Integración Ruby
Usando Ruby Mail Gem
require 'mail'
Mail.defaults do
delivery_method :smtp, {
address: 'smtp.forwardemail.net',
port: 465,
domain: 'your-domain.com',
user_name: 'your-username@your-domain.com',
password: 'your-password',
authentication: 'plain',
enable_starttls_auto: true,
ssl: true
}
end
mail = Mail.new do
from 'your-username@your-domain.com'
to 'recipient@example.com'
subject 'Hola desde Forward Email'
text_part do
body '¡Hola mundo! Este es un correo de prueba enviado usando Ruby Mail y Forward Email SMTP.'
end
html_part do
content_type 'text/html; charset=UTF-8'
body '<b>¡Hola mundo!</b> Este es un correo de prueba enviado usando Ruby Mail y Forward Email SMTP.'
end
end
mail.deliver!
puts "¡Correo enviado con éxito!"
Integración Java
Usando JavaMail API
import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;
public class SendEmail {
public static void main(String[] args) {
// Correo y contraseña del remitente
final String username = "your-username@your-domain.com";
final String password = "your-password";
// Propiedades del servidor SMTP
Properties props = new Properties();
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.host", "smtp.forwardemail.net");
props.put("mail.smtp.port", "465");
props.put("mail.smtp.socketFactory.port", "465");
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
// Crear sesión con autenticador
Session session = Session.getInstance(props,
new javax.mail.Authenticator() {
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(username, password);
}
});
try {
// Crear mensaje
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(username));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
message.setSubject("Hola desde Forward Email");
// Crear mensaje multipart
Multipart multipart = new MimeMultipart("alternative");
// Parte de texto
BodyPart textPart = new MimeBodyPart();
textPart.setText("¡Hola mundo! Este es un correo de prueba enviado usando JavaMail y Forward Email SMTP.");
// Parte HTML
BodyPart htmlPart = new MimeBodyPart();
htmlPart.setContent("<b>¡Hola mundo!</b> Este es un correo de prueba enviado usando JavaMail y Forward Email SMTP.", "text/html");
// Añadir partes al multipart
multipart.addBodyPart(textPart);
multipart.addBodyPart(htmlPart);
// Establecer contenido
message.setContent(multipart);
// Enviar mensaje
Transport.send(message);
System.out.println("¡Correo enviado con éxito!");
} catch (MessagingException e) {
throw new RuntimeException(e);
}
}
}
Configuración del Cliente de Correo
Thunderbird
- Abra Thunderbird y vaya a Configuración de la cuenta
- Haga clic en "Acciones de cuenta" y seleccione "Agregar cuenta de correo"
- Ingrese su nombre, dirección de correo electrónico y contraseña
- Haga clic en "Configuración manual" e ingrese los siguientes detalles:
- Servidor entrante:
- IMAP: imap.forwardemail.net, Puerto: 993, SSL/TLS
- POP3: pop3.forwardemail.net, Puerto: 995, SSL/TLS
- Servidor saliente (SMTP): smtp.forwardemail.net, Puerto: 465, SSL/TLS
- Autenticación: Contraseña normal
- Nombre de usuario: su dirección de correo electrónico completa
- Servidor entrante:
- Haga clic en "Probar" y luego en "Hecho"
Apple Mail
- Abra Mail y vaya a Mail > Preferencias > Cuentas
- Haga clic en el botón "+" para agregar una nueva cuenta
- Seleccione "Otra cuenta de correo" y haga clic en "Continuar"
- Ingrese su nombre, dirección de correo electrónico y contraseña, luego haga clic en "Iniciar sesión"
- Cuando la configuración automática falle, ingrese los siguientes detalles:
- Servidor de correo entrante: imap.forwardemail.net (o pop3.forwardemail.net para POP3)
- Servidor de correo saliente: smtp.forwardemail.net
- Nombre de usuario: su dirección de correo electrónico completa
- Contraseña: su contraseña
- Haga clic en "Iniciar sesión" para completar la configuración
Gmail (Enviar correo como)
- Abra Gmail y vaya a Configuración > Cuentas e importación
- Bajo "Enviar correo como", haga clic en "Agregar otra dirección de correo electrónico"
- Ingrese su nombre y dirección de correo electrónico, luego haga clic en "Siguiente paso"
- Ingrese los siguientes detalles del servidor SMTP:
- Servidor SMTP: smtp.forwardemail.net
- Puerto: 465
- Nombre de usuario: su dirección de correo electrónico completa
- Contraseña: su contraseña
- Seleccione "Conexión segura usando SSL"
- Haga clic en "Agregar cuenta" y verifique su dirección de correo electrónico
Solución de problemas
Problemas comunes y soluciones
-
Autenticación fallida
- Verifique su nombre de usuario (dirección de correo electrónico completa) y contraseña
- Asegúrese de estar usando el puerto correcto (465 para SSL/TLS)
- Compruebe si su cuenta tiene acceso SMTP habilitado
-
Tiempo de conexión agotado
- Verifique su conexión a internet
- Asegúrese de que la configuración del firewall no esté bloqueando el tráfico SMTP
- Intente usar el puerto 465 con SSL/TLS (recomendado) o el puerto 587 con STARTTLS
-
Mensaje rechazado
- Asegúrese de que la dirección "De" coincida con su correo autenticado
- Verifique si su IP está en una lista negra
- Compruebe que el contenido de su mensaje no active filtros de spam
-
Errores TLS/SSL
- Actualice su aplicación/biblioteca para soportar versiones modernas de TLS
- Asegúrese de que los certificados CA de su sistema estén actualizados
- Intente TLS explícito en lugar de TLS implícito
Obtener ayuda
Si encuentra problemas no cubiertos aquí, por favor:
- Consulte nuestra página de preguntas frecuentes para preguntas comunes
- Revise nuestra entrada de blog sobre entrega de correo para información detallada
- Contacte a nuestro equipo de soporte en support@forwardemail.net
Recursos adicionales
- Documentación de Forward Email
- Límites y configuración del servidor SMTP
- Guía de mejores prácticas para correo electrónico
- Prácticas de seguridad
Conclusión
El servicio SMTP de Forward Email ofrece una forma confiable, segura y enfocada en la privacidad para enviar correos electrónicos desde sus aplicaciones y clientes de correo. Incluye un sistema de colas, un mecanismo de reintentos de 5 días y notificaciones del estado de entrega.
Para casos de uso más avanzados o integraciones personalizadas, por favor contacte a nuestro equipo de soporte.