# 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](https://docs.salchimail.com/es/verificacion-local-primero.md). 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](https://docs.salchimail.com/es/verificacion-local-primero.md), 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

```sh
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](https://docs.salchimail.com/es/verificacion-en-registro.md) | `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:

```sh
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](https://docs.salchimail.com/es/verificacion-local-primero.md). Si estás de acuerdo, fija el máximo de créditos de buzón que quieres gastar:

```sh
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](https://docs.salchimail.com/es/verificacion-en-registro.md)).

## 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](https://docs.salchimail.com/es/verificacion-en-registro.md): 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`](https://docs.salchimail.com/skills/salchimail-local/SKILL.md) (en inglés).
