aGo Mail Pilot, documentación

Versión del plugin: 1.0.0 · Documentación actualizada: 2026-06-28

aGo Mail Pilot envía los correos de WordPress a través del servidor SMTP que elijas. Trae ocho presets de proveedores con un asistente que te indica, paso a paso, cómo conseguir el usuario y la contraseña de cada uno, además de prueba de envío con diagnóstico, auditoría DNS de SPF/DKIM/DMARC, almacenamiento cifrado de la contraseña y alertas por tasa de fallos. No realiza llamadas a APIs externas por su cuenta, no envía telemetría y no tiene servidor de licencias.

1. Instalación y activación

1. Sube el archivo ago-mail-pilot.zip desde Plugins → Añadir nuevo plugin → Subir plugin y actívalo. También puedes copiar la carpeta ago-mail-pilot a /wp-content/plugins/.
2. Activa el plugin desde el menú Plugins.
3. Ve a aGo Tools → Mail Pilot.

Requisitos: WordPress 6.0 o superior y PHP 8.1 o superior.

2. Configuración del SMTP

En aGo Tools → Mail Pilot, tarjeta SMTP configuration, completa los datos de tu servidor de envío. Lo más práctico es elegir primero un preset (ver sección 3): el preset rellena solo el host, el puerto y el tipo de cifrado, y solo tienes que ingresar usuario y contraseña.

Campos disponibles:

• Provider preset. Proveedor preconfigurado o Custom (enter manually) para un servidor SMTP propio.
• SMTP host. Servidor de envío, por ejemplo smtp.example.com.
• Port. Puerto. Lo habitual es 587 para TLS o 465 para SSL.
• Encryption. Cifrado de la conexión: TLS, SSL o None (sin cifrado).
• Username. Usuario que tu proveedor exige para autenticar (ojo: no siempre es tu correo, ver el asistente).
• Password. Contraseña o clave de aplicación o API. Si dejas el campo en blanco al guardar, se conserva la contraseña actual.
• From name. Nombre del remitente que verán los destinatarios.
• From email. Dirección del remitente. Debe estar verificada o autorizada por tu proveedor.

Pulsa Save settings para guardar. A partir de ese momento, todo correo que envíe WordPress (recuperación de contraseña, avisos de plugins, formularios de contacto, etc.) sale por tu servidor SMTP.

3. Presets de proveedores

El selector de proveedor incluye ocho presets curados. Al elegir uno, se autocompletan host, puerto y cifrado:

Si tu proveedor no está en la lista, elige Custom (enter manually) e ingresa el host, el puerto, el cifrado, el usuario y la contraseña a mano. El plugin funciona con cualquier servidor SMTP.

4. Asistente de credenciales paso a paso

Es lo que diferencia a este plugin de otros de SMTP. Al elegir un preset se abre solo un asistente que explica cómo obtener el usuario y la contraseña para ese proveedor exacto, con enlaces directos a la página correspondiente en el panel del proveedor. Puedes ocultarlo con Hide guide y volver a mostrarlo con Show step-by-step guide for this provider.

El asistente cubre los detalles que suelen costar horas de errores de autenticación. Por ejemplo:

• Gmail requiere una contraseña de aplicación de 16 caracteres (la contraseña normal de la cuenta no sirve para SMTP) y tener activada la verificación en dos pasos.
• SendGrid usa la palabra literal apikey como usuario y la clave API (que empieza con SG.) como contraseña.
• Amazon SES usa credenciales SMTP dedicadas que se generan dentro de la consola de SES, distintas de las credenciales de la cuenta de AWS.
• Brevo, Resend, MailerSend, SMTP2GO y Acumbamail tienen cada uno su propio formato de usuario y de clave, explicado en su guía.

El asistente se muestra en el idioma del sitio: inglés, español o portugués de Brasil.

5. Prueba de envío

En la tarjeta Send test email puedes mandar un correo de prueba a la dirección de tu propia cuenta para verificar que la configuración SMTP funciona de punta a punta. Pulsa Send test email.

• Si llega, verás un aviso de éxito (revisa tu bandeja de entrada).
• Si falla, el plugin muestra la respuesta exacta del servidor SMTP y una pista sobre la causa probable: error de autenticación (usuario o contraseña incorrectos, o formato especial del usuario), problema de conexión (host, puerto o firewall), remitente no autorizado por el proveedor, o rechazo del mensaje por SPF/DKIM/DMARC.

6. Auditoría DNS (SPF, DKIM, DMARC)

La mayoría de los problemas de entrega no vienen del plugin, sino de la autenticación del remitente. En la tarjeta DNS health check puedes auditar el dominio desde el que envías para confirmar que SPF, DKIM y DMARC están bien configurados.

• Domain to check. Dominio a auditar. Si lo dejas vacío, el plugin usa el dominio de tu dirección de remitente.
• DKIM selector. Selector DKIM a consultar. Cada proveedor indica el suyo; algunos comunes son default, google, s1, selector1, brevo, sendgrid.

Pulsa Run DNS check y verás una tabla con el estado de cada registro (OK o ausente), el contenido del registro encontrado y una recomendación concreta para cada uno. La auditoría es de solo lectura: hace consultas DNS y nunca modifica tus registros. No envía ningún dato a aGo Lab ni a terceros.

7. Registro de correos recientes

La tarjeta Recent email log muestra los últimos diez correos salientes con su destinatario, asunto, estado (enviado o fallido) y cuándo se enviaron. Al pasar el cursor sobre un envío fallido se ve el mensaje de error. El registro vive en la tabla de opciones de WordPress; no se crea ninguna tabla de base de datos adicional. Puedes vaciarlo con Clear log.

8. Alertas por tasa de fallos

Configurables en la tarjeta de SMTP, sección Failure rate alerts. Sirven para detectar a tiempo una caída del proveedor: el plugin revisa el registro reciente cada hora y, si la proporción de correos fallidos supera el umbral que definas, envía un aviso por correo.

• Alerts. Activa o desactiva la notificación al administrador.
• Threshold (%). Umbral de fallos a partir del cual se avisa (por ejemplo, 30%).
• Minimum sample size. Cantidad mínima de correos enviados antes de evaluar (evita alertas con muestras pequeñas).
• Alert recipient. Dirección que recibe el aviso. Por defecto, el correo del administrador del sitio.

Para no generar ruido, se envía como máximo una alerta cada 24 horas.

9. Almacenamiento seguro de la contraseña

La contraseña SMTP se guarda cifrada con AES-256-CBC, atada a la clave AUTH_KEY de tu instalación de WordPress. La tarjeta de SMTP confirma cuándo el cifrado está activo.

Si las claves secretas de tu wp-config.php siguen siendo los valores de marcador de WordPress, el plugin no puede cifrar: usa una codificación base64 de respaldo (que no es segura) y te recuerda regenerar las salts. Puedes generarlas desde el enlace Generate WordPress secret keys del panel lateral.

Para máxima protección, define la constante AGOMP_PASSWORD en wp-config.php. Cuando está definida, el plugin lee la contraseña de la constante y nunca de la base de datos.

10. Datos almacenados y desinstalación

El plugin guarda en la tabla wp_options de tu sitio:

• Los ajustes SMTP (host, puerto, cifrado, usuario y contraseña cifrada) bajo la clave agomp_settings.
• El registro de envíos (destinatario, asunto, estado, error y fecha), limitado a las últimas diez entradas, bajo la clave agomp_log.

Desactivar el plugin no borra estos datos, solo detiene la tarea programada de las alertas. Desinstalarlo elimina agomp_settings y agomp_log.

No se realizan llamadas a APIs de terceros por iniciativa del plugin, ni hay telemetría ni servidor de licencias. El único tráfico saliente es la conexión SMTP que tú configuras y las consultas DNS de la auditoría, que usan el resolutor DNS de tu propio servidor.

11. Soporte

aGo Mail Pilot es un plugin gratuito de código abierto bajo licencia GPL-2.0+.

Foro de soporte oficial: https://wordpress.org/support/plugin/ago-mail-pilot/

Las dudas, reportes de bugs y solicitudes de mejora se atienden en ese foro. Respondemos según disponibilidad: el plugin es de código abierto bajo licencia GPL-2.0+ y atendemos la comunidad cuando podemos.

No damos soporte por correo electrónico para la versión gratuita. Para uso comercial con soporte directo y SLA, próximamente lanzaremos planes de suscripción anual y lifetime.