Inicio Rapido
WordPress envia emails usando la funcion mail() de PHP por defecto, que frecuentemente termina en spam o no funciona en muchos hosts. aGo SMTP enruta todos los emails de WordPress a traves de un servidor SMTP real, asegurando una entrega confiable.
Instalacion
- Sube
ago-smtp.zip desde Plugins → Add New → Upload Plugin - Activa el plugin
- Ve a aGo Herramientas → SMTP
Configuracion en 3 minutos
- Selecciona un preset de proveedor (Gmail, Outlook, SendGrid, etc.) — host, puerto y encriptacion se llenan automaticamente
- Ingresa tu usuario (generalmente tu direccion de email)
- Ingresa tu contraseña (o App Password — ver instrucciones de proveedor abajo)
- Configura From Name y From Email — el nombre y direccion del remitente para emails salientes
- Guarda y envia un Email de Prueba para verificar
Tip: Si usas Gmail o Outlook, necesitas un App Password — no tu contraseña regular de la cuenta. Ve la seccion de Configuracion de Proveedores abajo para instrucciones paso a paso.
Configuracion de Proveedores
aGo SMTP incluye presets para 6 proveedores de email populares. Seleccionar un preset auto-completa los campos de host, puerto y encriptacion. Solo necesitas ingresar tu usuario y contraseña.
Valores de Presets
| Proveedor | Host | Puerto | Encriptacion |
|---|
| Gmail | smtp.gmail.com | 587 | TLS |
| Outlook / Hotmail | smtp-mail.outlook.com | 587 | TLS |
| SendGrid | smtp.sendgrid.net | 587 | TLS |
| Mailgun | smtp.mailgun.org | 587 | TLS |
| Amazon SES | email-smtp.us-east-1.amazonaws.com | 587 | TLS |
| Acumbamail | smtp.acumbamail.com | 587 | TLS |
Proveedor personalizado: Si tu proveedor no esta listado, selecciona "Custom" e ingresa el host SMTP, puerto y encriptacion manualmente. Consulta la documentacion de tu proveedor para los valores correctos.
Gmail
- Ve a myaccount.google.com/security
- Activa la Verificacion en 2 pasos si no esta activa
- Ve a Contraseñas de aplicaciones
- Crea un nuevo App Password (selecciona "Mail" y "Other", nombralo "WordPress")
- Copia la contraseña de 16 caracteres
- En aGo SMTP: Username = tu direccion Gmail, Password = el App Password
Outlook / Hotmail
- Ve a account.microsoft.com/security
- Activa la Verificacion en dos pasos
- Ve a Opciones de seguridad avanzadas → Contraseñas de aplicaciones
- Crea un nuevo App Password
- En aGo SMTP: Username = tu email de Outlook, Password = el App Password
SendGrid
- Crea una cuenta gratuita en sendgrid.com
- Ve a Settings → API Keys
- Crea una API Key con permiso "Mail Send"
- En aGo SMTP: Username =
apikey (literalmente la palabra "apikey"), Password = tu API key
Mailgun
- Registrate en mailgun.com
- Verifica tu dominio de envio
- Ve a Sending → Domain settings → SMTP credentials
- En aGo SMTP: Username = tu usuario SMTP (ej:
[email protected]), Password = la contraseña SMTP
Amazon SES
- Ve a la Consola de AWS SES
- Verifica tu dominio o direccion de email de envio
- Crea credenciales SMTP en Account dashboard → SMTP settings
- En aGo SMTP: Username = usuario SMTP de AWS, Password = contraseña SMTP de AWS
- Cambia la region del host si es necesario (ej:
email-smtp.eu-west-1.amazonaws.com para Irlanda)
Region SES: El preset por defecto usa us-east-1. Si tu cuenta SES esta en una region diferente, selecciona "Custom" y actualiza el host para que coincida con tu region.
Acumbamail
- Registrate en acumbamail.com
- Ve a los ajustes SMTP de tu cuenta
- En aGo SMTP: Username = tu email de Acumbamail, Password = tu contraseña de Acumbamail o API key
Encriptacion de Contraseña
aGo SMTP encripta tu contraseña SMTP antes de almacenarla en la base de datos de WordPress. La contraseña nunca se guarda en texto plano.
Como Funciona
- Cuando guardas los ajustes, la contraseña se encripta usando las claves de autenticacion de WordPress (
AUTH_KEY y SECURE_AUTH_SALT de wp-config.php) - La contraseña encriptada se almacena en la opcion
ago_smtp_settings - Al enviar un email, la contraseña se desencripta en memoria y se pasa a PHPMailer
- La pagina de ajustes siempre muestra
******** — la contraseña real nunca se devuelve al navegador
Nota: Si cambias tus claves de autenticacion de WordPress en wp-config.php, la contraseña almacenada sera ilegible. Necesitaras re-ingresar tu contraseña SMTP despues de cambiar las claves.
Email de Prueba
Despues de configurar tus ajustes SMTP, haz clic en el boton Enviar Email de Prueba. El email de prueba se envia a la direccion de email del usuario administrador actualmente logueado.
Que Hace la Prueba
- Llama a
wp_mail() con un asunto y cuerpo de prueba - aGo SMTP intercepta la llamada y la enruta a traves de tu servidor SMTP configurado
- Si tiene exito, veras una confirmacion verde: "Email de prueba enviado exitosamente a [email protected]"
- Si falla, veras el mensaje de error de PHPMailer con detalles sobre que salio mal
Tip: Revisa tu carpeta de spam si el email de prueba no aparece en tu bandeja de entrada. Tambien verifica que tu From Email coincida con una direccion de remitente verificada para tu proveedor.
Registro de Emails
aGo SMTP registra todos los emails enviados a traves de WordPress. El registro es accesible desde la pestaña Email Log en la pagina de ajustes.
Informacion Registrada
- Fecha/hora del email
- Destinatario
- Asunto
- Estado — exito o fallo
- Mensaje de error (si fallo)
El registro muestra las ultimas 50 entradas. Haz clic en Limpiar Registro para eliminar todas las entradas.
Nota de privacidad: El registro de emails almacena direcciones de destinatarios y lineas de asunto en la base de datos de WordPress. Si manejas datos sensibles, limpia el registro periodicamente o desactiva el registro cuando no lo necesites para depuracion.
Solucion de Problemas
Errores Comunes
| Mensaje de Error | Causa | Solucion |
|---|
SMTP connect() failed | No puede alcanzar el servidor SMTP | Verifica host y puerto. Asegurate de que tu hosting no bloquee el puerto 587 saliente. Prueba el puerto 465 con SSL si TLS no funciona. |
Authentication failed | Usuario o contraseña incorrectos | Para Gmail/Outlook: asegurate de usar un App Password, no tu contraseña regular. Re-ingresa la contraseña (puede haberse corrompido). |
Sender address rejected | From Email no coincide con el remitente verificado del proveedor | Configura el From Email a una direccion verificada con tu proveedor SMTP. Para Gmail, usa tu direccion Gmail. Para SendGrid/Mailgun, usa un dominio verificado. |
Connection timed out | Firewall o restriccion del hosting | Contacta a tu proveedor de hosting para confirmar que las conexiones SMTP salientes en puerto 587 estan permitidas. Algunos hosting compartidos bloquean SMTP completamente. |
SSL routines: wrong version number | Desajuste de encriptacion | Estas usando encriptacion SSL en un puerto TLS (o viceversa). Puerto 587 usa TLS, puerto 465 usa SSL. Asegurate de que coincidan. |
Emails Llegando a Spam
- Configura registros DNS SPF, DKIM, y DMARC para tu dominio de envio
- Asegurate de que el From Email coincida con tu dominio (evita enviar como
@gmail.com desde un servidor que no es de Google) - Usa un servicio de envio dedicado (SendGrid, Mailgun, SES) para sitios en produccion
- Evita palabras que activan filtros de spam en asuntos y contenido del email
Depuracion
Si el email de prueba falla sin un mensaje de error claro:
- Revisa la pestaña Email Log para detalles del error
- Activa
WP_DEBUG y WP_DEBUG_LOG en wp-config.php para capturar errores de PHPMailer en wp-content/debug.log - Verifica que tus credenciales funcionen fuera de WordPress probando con una herramienta como smtper.net
Preguntas Frecuentes
aGo SMTP anula todos los emails de WordPress?
Si. Una vez configurado, aGo SMTP se engancha a phpmailer_init y enruta cada llamada wp_mail() a traves de tu servidor SMTP. Esto incluye emails de formularios de contacto, WooCommerce, restablecimiento de contraseñas, y cualquier plugin que use wp_mail().
Puedo usar el SMTP de mi proveedor de hosting?
Si. Selecciona "Custom" como preset e ingresa los datos SMTP de tu hosting. Valores comunes: host = mail.tudominio.com, puerto = 587 o 465, encriptacion = TLS o SSL. Consulta con tu host los ajustes exactos.
Que pasa si desactivo el plugin?
WordPress vuelve a usar la funcion mail() de PHP. Tus ajustes SMTP se preservan en la base de datos — reactivar el plugin restaurara tu configuracion sin necesidad de re-ingresar nada.
Gmail es gratis para SMTP?
Si, para envio de bajo volumen. Gmail permite aproximadamente 500 emails por dia para cuentas personales y 2,000 por dia para cuentas de Google Workspace. Para volumenes mayores, usa un servicio de envio dedicado como SendGrid o Amazon SES.
Puedo usar diferentes ajustes SMTP para diferentes tipos de email?
No. aGo SMTP usa una unica configuracion SMTP para todos los emails salientes. Si necesitas enrutamiento por email, considera un servicio de email transaccional mas avanzado con integracion por API.
Mi contraseña cambio y los emails dejaron de funcionar. Que paso?
aGo SMTP encripta la contraseña usando las claves de autenticacion de WordPress de wp-config.php. Si esas claves fueron regeneradas (ej: durante un incidente de seguridad), la contraseña almacenada se vuelve ilegible. Ve a aGo Herramientas → SMTP y re-ingresa tu contraseña SMTP.
Necesitas ayuda?
Contactanos en ago.cl/contacto o escribe a [email protected].
