Ensayo de política de registro
Añadir validación de email a un formulario de registro es una apuesta: frenas parte de la basura y puedes rechazar a clientes reales. No hace falta adivinar. Tus altas pasadas ya dicen quién acabó pagando. salchimail-local rehearse aplica cada regla sobre ellas y cuenta qué habría bloqueado.
Se ejecuta en tu máquina. Por defecto no se envía nada a nadie.
Los ejemplos de esta página son la salida real de la herramienta sobre datos de prueba sintéticos: altas inventadas en dominios .example con un DNS simulado. Las cifras enseñan el formato del informe. No dicen nada sobre tus altas.
Qué necesitas
Instala la herramienta como se explica en Verificación local primero. Después exporta tus altas pasadas a un CSV (o JSONL) con dos columnas:
email,outcome
ana@discrimina.example,paid
nora@discrimina.example,
tom@mailinator.com,fraudoutcome |
Cuenta como |
|---|---|
paid, activated |
Buena: un cliente que no querrías perder |
fraud, spam, chargeback |
Basura: un alta que te habría gustado frenar |
| vacío | Sin desenlace: no lo sabes. No se cuenta como basura |
También sirve una columna de verdadero o falso: --outcome-column paid. Las altas de los últimos 90 días son una muestra razonable.
Si además tienes un fichero de historial con el formato de Verificación local primero, pásalo con --history: los eventos payment y activation cuentan como buenas; los eventos fraud y los rebotes duros de tu propio correo, como basura.
Ejecútalo
salchimail-local rehearse --signups signups.csv --out detail.csv --lang esEnsayo de política de registro: 13 altas (5 buenas: pagaron o se activaron; 2 basura: marcadas o con rebote duro; 6 sin desenlace)
REGLA BLOQUEARÍA BUENAS PERDIDAS BASURA FRENADA SIN DESENLACE QUÉ HACE
reject_syntax 1 0 0 1 Rechazar direcciones con sintaxis inválida
require_mx 3 0 1 2 Rechazar dominios que no pueden recibir correo
reject_invalid 4 0 1 3 Rechazar lo que el modo basic llama invalid (las dos reglas anteriores)
block_disposable 2 1 1 0 Bloquear dominios desechables
block_legacy 1 1 0 0 Bloquear dominios de proveedores desaparecidos
block_free 0 0 0 0 Bloquear correo gratuito (Gmail, Outlook, Yahoo...)
reject_invalid_block_disposable 6 1 2 3 Rechazar invalid y bloquear desechables (el patrón documentado para registros)
Léelo con cuidado: las direcciones se comprueban como están hoy, no como estaban el día del alta; las altas que una regla anterior ya rechazó no están en tus datos; y los recuentos pequeños prueban poco.Cada fila es una regla que podrías activar:
| Regla | Qué bloquea | Con la API |
|---|---|---|
reject_syntax |
Direcciones que no tienen sintaxis de email válida | invalid · syntax_invalid |
require_mx |
Dominios que no pueden recibir correo | invalid · domain_not_found, domain_null_mx, domain_no_mail_host |
reject_invalid |
Las dos anteriores: todo lo que el modo basic llama invalid |
verdict es invalid |
block_disposable |
Dominios desechables | risky · disposable_domain |
block_legacy |
Dominios de proveedores desaparecidos | risky · legacy_domain |
block_free |
Correo gratuito (Gmail, Outlook, Yahoo…), como hacen los formularios de «solo email de empresa» | flags.free es true |
reject_invalid_block_disposable |
El patrón de Verificación en el registro | invalid, o disposable_domain |
detail.csv tiene una fila por alta con su desenlace y las reglas que la habrían bloqueado, para que puedas mirar qué clientes buenos hay detrás de una cifra antes de decidir.
Cómo leer las cifras
En el ejemplo sintético de arriba, reject_invalid habría frenado 4 altas y ninguna era un cliente: una regla segura. block_disposable habría frenado 1 alta basura y perdido 1 cliente que se activó: una regla para pensársela, o para convertirla en un aviso en lugar de un bloqueo.
Tres cosas limitan lo que el informe puede probar. La herramienta las imprime siempre:
- Las direcciones se comprueban como están hoy, no como estaban el día del alta. Un dominio puede haber muerto, o haber entrado en la lista de desechables, desde entonces.
- Solo ves las altas que entraron. Si ya había una regla activa, las altas que rechazó no están en tus datos.
- Los recuentos pequeños prueban poco. Con un puñado de clientes de pago, lee recuentos, no porcentajes.
Opcional: reglas que necesitan comprobar el buzón
Las reglas anteriores no necesitan ninguna llamada a la API. Otras dos dependen de lo que el servidor de correo diga de cada buzón, así que necesitan la API en modo mailbox y créditos. Mira primero qué se enviaría:
salchimail-local rehearse --signups signups.csv --dry-run --lang esEl ensayo con --dry-run no envía nada y lista las direcciones. Las altas que una regla local ya rechaza no se envían nunca, y las direcciones salen en dos olas, primero una por dominio, como en Verificación local primero. Si estás de acuerdo, fija el máximo de créditos de buzón que quieres gastar:
export SALCHIMAIL_API_KEY=sk_live_…
salchimail-local rehearse --signups signups.csv --budget 500 --lang esEnsayo de política de registro: 13 altas (5 buenas: pagaron o se activaron; 2 basura: marcadas o con rebote duro; 6 sin desenlace)
REGLA BLOQUEARÍA BUENAS PERDIDAS BASURA FRENADA SIN DESENLACE QUÉ HACE
reject_syntax 1 0 0 1 Rechazar direcciones con sintaxis inválida
require_mx 3 0 1 2 Rechazar dominios que no pueden recibir correo
reject_invalid 4 0 1 3 Rechazar lo que el modo basic llama invalid (las dos reglas anteriores)
block_disposable 2 1 1 0 Bloquear dominios desechables
block_legacy 1 1 0 0 Bloquear dominios de proveedores desaparecidos
block_free 0 0 0 0 Bloquear correo gratuito (Gmail, Outlook, Yahoo...)
reject_invalid_block_disposable 6 1 2 3 Rechazar invalid y bloquear desechables (el patrón documentado para registros)
mailbox_reject_invalid 5 0 1 4 Rechazar lo que el modo mailbox llama invalid
mailbox_reject_invalid_risky 10 3 2 5 Rechazar invalid y risky en modo mailbox
Las reglas de buzón usan las 6 de 13 direcciones que obtuvieron respuesta de la API.
Léelo con cuidado: las direcciones se comprueban como están hoy, no como estaban el día del alta; las altas que una regla anterior ya rechazó no están en tus datos; y los recuentos pequeños prueban poco.mailbox_reject_invalid añade los buzones que el servidor dice que no existen. mailbox_reject_invalid_risky rechaza además todos los resultados risky, incluidos los servidores que aceptan todo; en el ejemplo sintético habría perdido 3 clientes. Recuerda que el modo mailbox puede tardar hasta 30 segundos, así que en el registro va en una tarea en segundo plano, no en el formulario (tiempos).
Después, escribe la política
Activa las reglas que el ensayo ha mostrado seguras, con el patrón de Verificación en el registro: llama a la API desde tu servidor en modo basic, rechaza lo que hayas decidido rechazar y acepta el alta siempre que la llamada falle. Repite el ensayo dentro de unos meses: tus altas cambian.
Un agente de IA puede hacer todo el trabajo en tu repositorio: encontrar la tabla de usuarios, exportar las dos columnas, ejecutar el ensayo, enseñarte la tabla y escribir el código y sus tests. La skill es salchimail-local (en inglés).