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:

CSV
email,outcome
ana@discrimina.example,paid
nora@discrimina.example,
tom@mailinator.com,fraud
outcome 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

curl
salchimail-local rehearse --signups signups.csv --out detail.csv --lang es
Text
Ensayo 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:

curl
salchimail-local rehearse --signups signups.csv --dry-run --lang es

El 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:

curl
export SALCHIMAIL_API_KEY=sk_live_…
salchimail-local rehearse --signups signups.csv --budget 500 --lang es
Text
Ensayo 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).

Ver esta página en Markdown