Versión: 1.3.13 · Plataforma: Plugin de WordPress · API: email-validaton.com
N-Software Email Validator es un plugin de WordPress para la verificación de correos electrónicos en tiempo real mediante la email-validaton.com API. It blocks fake registrations, disposable addresses, and non-existent mailboxes before they reach your database. The plugin works across three layers: real-time form protection, bulk CSV validation, and an Email Health scanner for cleaning existing data.
Esta guía cubre en detalle todas las funciones, desde la instalación hasta la resolución avanzada de problemas.
¿Qué es?
El plugin intercepta cada dirección de correo electrónico enviada en tu sitio de WordPress (en formularios de registro, formularios de contacto, comentarios y el proceso de compra de WooCommerce) y la valida con la email-validaton.com API before WordPress processes it.
Tres capas de protección
| Capa | Propósito |
|---|---|
| Protección en tiempo real | Bloquea las direcciones no válidas al enviar formularios o registros |
| Validación masiva | Verifica de una vez listas CSV/TXT de hasta 5.000 direcciones |
| Salud del correo electrónico | Analiza las direcciones existentes en la base de datos y permite eliminarlas o anonimizarlas |
Requisitos
| Requisito | Mínimo |
|---|---|
| WordPress | 6.2 o superior |
| PHP | 8.0 o superior |
| Clave de API | email-validaton.com/dashboard |
| Internet | Conexión al servicio de API |
| Acceso de administrador | manage_options capability for setup |
Instalación — 4 pasos
- Sube el archivo ZIP o la carpeta
n-software-email-validatorto/wp-content/plugins/ - Plugins → Plugins instalados → Activar
- El elemento de menú N-Software Email Validator aparece en la barra lateral
- Ve a Ajustes → introduce tu clave de API → guarda. Un punto verde con la etiqueta API conectada confirma la conexión
Estructura del panel de administración
N-Software Email Validator
├── Panel de control — Cuenta, plan, estadísticas, rápido único-email validación
├── Ajustes — API clave, validación reglas, form integraciones
├── Carga masiva Validar — Masivo verificación de CSV/TXT files
├── Registros — Último 100 validaciones with detalle
└── Email Estado — Escanear existente direcciones + limpieza
Adicional:
- Widget del panel de WordPress — plan, créditos, barra de progreso, estadísticas de hoy
- Usuarios → Todos los usuarios — Estado del correo columna (Válido, No válido, Riesgoso, etc.)
Referencia de ajustes
Configuración de la API
| Opción | Descripción | Recomendación |
|---|---|---|
| Clave de API | Clave de email-validaton.com | Obligatorio |
| Tiempo de espera de validación | Tiempo máximo de espera de la respuesta de la API (1–30 s) | 10 s |
| Guardar resultados en caché | TTL de caché en minutos (0 = desactivado) | 60 min |
La caché ahorra créditos: la misma dirección no se vuelve a enviar a la API mientras la caché sea válida.
Reglas de validación
| Opción | Efecto |
|---|---|
| Validar en el registro | Comprueba el correo electrónico durante el registro de usuarios de WP |
| Bloquear proveedores de correo gratuitos | Bloquea Gmail, Yahoo, Outlook, etc. independientemente del estado |
Integraciones de formularios
Activa solo los formularios que utilizas: Contact Form 7, WPForms, Gravity Forms, WooCommerce Checkout, Ninja Forms, Fluent Forms, Formidable, Forminator, MC4WP (Mailchimp), WS Forms, Mailster, WordPress Comments.
Cómo funciona la validación
Flujo de validación
El usuario envía un form with un email física
↓
Plugin intercepta ANTES DE WordPress procesa it
↓
Memoria caché (instantánea, por-request)
↓
Persistente caché (WordPress transitorio, configurable TTL)
↓
API créditos comprobación (GET /api/v1/cuenta)
↓
API validación llama (POST /api/v1/verificar)
↓
API devuelve status with confianza score y MX detalles
↓
BLOQUEAR: invalid, desechable, error
PERMITIR: valid, riesgoso, desconocido, over_quota
↓
Registrar a base de datos + incremento diario estadísticas
Estados devueltos por la API
| Estado | Significado | ¿Bloqueado? | ¿Consume créditos? |
|---|---|---|---|
valid |
Buzón confirmado como existente | No | Sí |
invalid |
El buzón no existe | Sí | Sí |
disposable |
Proveedor temporal/desechable | Sí | Sí |
error |
Error de verificación | Sí | No |
risky |
Confianza baja (catch-all, Yahoo, greylisting) | No | No |
unknown |
Sin respuesta definitiva | No | No |
over_quota |
La casilla de correo existe pero está llena | No | Sí |
Dato clave:
valid,invalid,over_quota, anddisposableconsume 1 credit each.
Los estados error, desconocido y arriesgado son gratuitos. Puerta SMTP interna ocupada
los estados nunca se devuelven; aparecen comounknown.
Reglas de bloqueo predeterminadas
- Permitidos: válido, arriesgado, desconocido, over_quota
- Bloqueados: no válido, desechable, error
- Bloqueados opcionalmente: proveedores de correo gratuitos (Gmail, Yahoo…) si la opción está activada
Cuando algo sale mal
El plugin nunca rompe tus formularios:
| Situación | Comportamiento |
|---|---|
| Créditos en 0 | Aviso rojo en el panel de administración, validación en pausa; los formularios siguen funcionando |
| Créditos < 5 % | Aviso amarillo de advertencia |
| API inaccesible | Los correos pasan sin verificar (alternativa segura) |
| Límite de peticiones | Reintento automático con espera — El escaneo de estado no se detiene |
| Error de red | Reintento con retroceso exponencial |
Panel — Inicio rápido
N-Software Email Validator → Panel
- Cuenta: Plan, créditos restantes, barra de progreso
- Estadísticas de hoy: válidos / no válidos / arriesgados / desechables del día actual
- Validación rápida: Introduce un correo electrónico, haz clic en Validar y verás el resultado al instante
Usa la validación rápida para probar tu clave de API y una única dirección antes de ponerte en producción.
Validación masiva — Verificación en lote
N-Software Email Validator → Validación masiva
Preparación del archivo
- Formato: CSV o TXT
- Una dirección por fila (CSV: primera columna)
- Máximo 5.000 direcciones únicas
- Filas de encabezado (
email,e-mail) are auto-skipped
Pasos
- Elegir archivo → selecciona un CSV o TXT
- Iniciar validación masiva
- Sigue la barra de progreso (lote por lote)
- Al finalizar: Exportar CSV con resultados
La exportación contiene
Email, Status, Confidence, MX Server, Is Free, Is Disposable, Is Role, Reason, Domain
Registros: historial de validaciones
N-Software Email Validator → Registros
- Últimos 100 validaciones (correo, estado, confianza, MX, fecha)
- Prueba de depuración — valida una dirección y registra el resultado
- Borrar caché — elimina los resultados en caché (no los registros)
- Actualizar — vuelve a cargar la tabla
- Los registros de más de 7 días se eliminan automáticamente mediante WP Cron
Salud del correo — Análisis y limpieza
El módulo más potente. Comprueba las direcciones existentes en la base de datos de tu sitio.
Fuentes analizadas
| Origen | Qué analiza |
|---|---|
| Usuarios de WordPress | user_email for all users |
| Clientes de WooCommerce | Búsqueda de clientes de WC |
| Pedidos de WooCommerce | Correo de facturación de los pedidos |
| Autores de comentarios | Correos de autores de comentarios |
| Envíos de CF7 | Metadatos de correo de CF7 (si existen) |
Controles de análisis
| Botón | Función |
|---|---|
| Iniciar análisis | Nuevo análisis (borra el anterior) |
| Continuar análisis | Reanudar escaneo pausado |
| Empezar de nuevo | Empezar desde cero |
| Pausa | Pausar (conserva el progreso) |
| Detener | Detener: los datos se conservan |
| Guardar progreso | Guardar manualmente en el servidor |
Tamaño del lote: 5–50 por lote. Ritmo: 200–10 000 ms entre solicitudes; un valor menor es más rápido, pero aumenta la carga de la API.
Flujo de trabajo habitual
- Elige las fuentes (p. ej., WP Users + Comments)
- Iniciar análisis
- Supervisa la barra de progreso y las estadísticas
- Filtra las categorías no válidas (Invalid, Disposable, Error)
- Selecciona filas o usa la selección automática
- Eliminar seleccionados o Anonimizar seleccionados
- Para eliminar: escribe DELETE en el cuadro de confirmación
Filtros y tabla
- Filtros: All, Valid, Invalid, Risky, Disposable, Unknown, Error, Mailbox Full, Rate Limited, Re-verified
- Columnas: Email, Status, Confidence, MX Server
- Paginación: 25 / 50 / 100 por página
Volver a verificar
- Volver a verificar esta categoría — vuelve a comprobar todas las entradas del filtro activo
- Verificado de nuevo entradas muestran un marcador 🔄 y un filtro específico
Eliminar frente a anonimizar
| Acción | Efecto |
|---|---|
| Eliminar | Elimina permanentemente los datos de usuario, comentario y WC |
| Anonimizar | Sustituye el correo electrónico por anon-{id}@deleted.invalid |
⚠️ La eliminación es irreversible: el modal requiere escribir la palabra DELETE para confirmar.
Persistencia
- Progreso guardado en las tablas de MySQL:
wp_north_ev_health_emails,wp_north_ev_health_results - Estado de meta:
nev_health_scan_stateoption - Guardar progreso usa UPSERT: nunca elimina los resultados existentes
- Al salir de la pestaña, el plugin guarda automáticamente mediante
sendBeacon
Importante: pestaña en segundo plano
Email Health y la Validación masiva se ejecutan en el navegador (JavaScript + AJAX). Las pestañas inactivas ralentizan los temporizadores: los análisis se hacen más lentos o se detienen. Mantén la pestaña de administración activa durante los análisis grandes. La protección de formularios y del registro funciona con normalidad sin una pestaña abierta.
Usuarios → Columna de estado del correo
En Usuarios → Todos los usuarios verás una insignia para cada usuario:
- Estado a partir de la meta del usuario (
nev_email_status) - Alternativa: la entrada más reciente en los registros de validación
- Se actualiza al registrarse, al validar formularios y en los análisis de Email Health
Créditos y notificaciones
| Escenario | Comportamiento |
|---|---|
| Créditos en 0 | Aviso rojo de administrador, validación en pausa, los formularios siguen funcionando |
| Créditos < 5 % | Aviso amarillo de advertencia |
| Límite de peticiones | Espera automática + reintento (el análisis de estado continúa) |
| Error de red | Reintento con retroceso (el análisis de estado continúa) |
| Comprar créditos | email-validaton.com/dashboard |
Guías rápidas de escenarios
A — Proteger el registro
- Ajustes → introduce la clave de API
- Activa Validar en el registro
- Prueba: regístrate con
test@mailinator.com— should be blocked
B — Formulario CF7
- Ajustes → activa Contact Form 7
- Envía un formulario de prueba con un correo no válido
- Revisa los registros
C — Limpiar usuarios antiguos
- Salud del correo → selecciona Usuarios de WordPress
- Iniciar análisis → espera
- Filtrar no válidos + desechables
- Eliminar seleccionados (confirma escribiendo DELETE)
D — Validar una lista de correo
- Validación masiva → sube el CSV
- Exportar resultados
- Elimina los no válidos o desechables de tu lista en Mailchimp/Brevo/etc.
Esquema de la base de datos (técnico)
Tablas con $wpdb prefix:
| Tabla | Propósito |
|---|---|
north_ev_validation_logs |
Cada validación con todo detalle |
north_ev_bulk_jobs |
Estado y resultados de los trabajos masivos |
north_ev_health_emails |
Lista de correos de Email Health |
north_ev_health_results |
Resultados de verificación de Email Health |
- Desactivación: Datos conservados
- Desinstalación: Elimina todas las tablas, opciones, transitorios y tareas cron
- Multisitio: Compatible: activación por sitio o en toda la red
Preguntas frecuentes / Solución de problemas
P: ¿Plugin Check informa de errores?
A: Usa el ZIP más reciente (1.3.13). Elimina el plugin antiguo antes de reinstalarlo.
P: ¿La validación no funciona en un formulario?
R: Comprueba que la integración esté activada en Ajustes y que tengas créditos.
P: ¿Perdiste el progreso de Email Health?
R: Haz clic en Continuar escaneo. Los datos están en la base de datos a menos que hayas usado Empezar de nuevo.
P: Guardar progreso muestra un error, pero los datos están ahí?
R: En la 1.3.x, Guardar verifica el número de filas en el servidor; actualiza la página.
P: ¿Puedo analizar 50 000 direcciones?
R: Técnicamente sí, pero mantén la pestaña abierta y ajusta el ritmo a 1000–2000 ms.
P: ¿Dónde obtengo una clave API?
R: email-validaton.com → Panel → Clave API.
Resumen
N-Software Email Validator es un kit completo de higiene de correos electrónicos para WordPress:
- Protección en tiempo real en formularios, registros y el proceso de pago de WooCommerce
- Validación masiva de listas con carga de CSV/TXT
- Limpieza de la base de datosvía Escáner de salud de correo electrónico
- Seguimiento de créditos con indicadores de estado claros
Para uso en producción: configure primero Ajustes y Validación rápida, luego active las integraciones y, por último, use Salud del correo electrónico para auditar las direcciones existentes.