API de verificación de emails catch-all
Los dominios corporativos aceptan a menudo todo el correo. Mailbeam detecta ese comportamiento de forma explícita y te dice que el veredicto no es verificable, con una puntuación acotada de 0 a 100, en lugar de dar por buena una certeza que no puede respaldar.
Qué comprueba Mailbeam
Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.
Detección de dominios catch-all
En la misma conexión que la dirección real, Mailbeam sondea un buzón aleatorio del dominio. Si también se acepta, el servidor lo acepta todo, así que la aceptación de la dirección real no demuestra nada, y lo decimos.
Puntuación de calidad de 0 a 100
La puntuación es aditiva a partir de un conjunto fijo de señales —sintaxis, ruta de correo, resultado del sondeo, desechable, rol, catch-all— con pesos y topes publicados. Una dirección catch-all se acota en 70, porque ningún sondeo puede confirmarla. Sin caja negra: cada punto es trazable.
Campo de motivo explicable
El campo `reason` devuelve `catch_all_unverifiable` para estas direcciones, y `status` vuelve como `risky` en lugar de `deliverable`. Tu aplicación puede tratar «no hemos podido confirmarlo» de forma distinta a «este buzón no existe».
Umbrales configurables
La puntuación es tuya para interpretarla. Fija un umbral de 70 o más en formularios B2B estrictos, y de 40 o más para aceptar listas amplias. La API devuelve los datos; tu lógica aplica la política.
Precisión en dominios corporativos
Los grandes dominios corporativos son catch-all con frecuencia. Como Mailbeam los informa como arriesgados-pero-no-verificables en vez de no entregables, puedes aceptarlos por umbral en lugar de rechazar clientes potenciales legítimos.
Se combina con las comprobaciones SMTP y MX
La detección de catch-all se ejecuta junto al conjunto completo de verificación. Recibes la comprobación MX, el resultado SMTP, la marca de desechable, la puntuación y el motivo en una sola respuesta.
Cómo funciona
Se envía el sondeo SMTP al servidor
Mailbeam sondea el servidor de correo con un comando RCPT TO. Si el servidor acepta todas las direcciones exista o no el buzón, el dominio se marca como catch-all.
Las señales se combinan en una puntuación
La sintaxis, la ruta de correo, el resultado del sondeo y las señales de desechable y de rol se combinan con pesos publicados. El catch-all aplica un tope, no una penalización, porque el problema es que falta evidencia, no que haya evidencia de un problema.
Se genera la puntuación de confianza
Vuelve una puntuación de 0 a 100 junto al veredicto. Una dirección catch-all no puede pasar de 70 por muy limpio que esté todo lo demás, que es el techo honesto para una dirección que ningún sondeo puede confirmar.
Se devuelven la puntuación y el motivo
Los campos `score`, `catch_all` y `reason` se incluyen en la respuesta estándar de verificación. Úsalos para aplicar tu propia lógica de umbral en tu aplicación.
Intégralo en minutos
// Todavía no hay SDK: el wrapper de 12 líneas de /docs/quickstart.
import { verifyEmail } from "@/lib/mailbeam";
type Decision = "accept" | "review" | "reject";
function evaluate(result: Awaited<ReturnType<typeof verifyEmail>>): Decision {
if (!result.valid || result.disposable) return "reject";
if (result.catch_all) {
// Umbral por tramos para las direcciones catch-all
if (result.score >= 70) return "accept";
if (result.score >= 40) return "review";
return "reject";
}
// Dirección normal: comprobación binaria de valid + suelo de puntuación
return result.score >= 30 ? "accept" : "review";
}
export async function handleLeadSubmission(email: string) {
const result = await verifyEmail(email);
const decision = evaluate(result);
if (decision === "reject") {
throw new Error("No se ha podido verificar la dirección de email.");
}
await db.leads.create({
email,
score: result.score,
catchAll: result.catch_all,
queue: decision === "review" ? "manual_review" : "active",
});
}Cuándo usarlo
Formularios de demo y captación B2B
Las direcciones corporativas están en dominios catch-all de forma desproporcionada. Rechazarlas en bloque en un formulario B2B es rechazar clientes potenciales reales. Usa la puntuación y el motivo catch_all_unverifiable para fijar tu propio umbral.
Importación y enriquecimiento del CRM comercial
Al importar listas de clientes potenciales B2B, muchas direcciones vienen de dominios corporativos catch-all. Aceptar por puntuación en vez de rechazar en binario mejora muchísimo la proporción de leads aprovechables.
Preparación de listas de prospección en frío
En secuencias salientes, usa un umbral de puntuación más alto (70 o más) para incluir solo las direcciones catch-all de alta confianza: proteges tu dominio de envío y maximizas los contactos alcanzables.
Registros en un SaaS enterprise
Los usuarios enterprise suelen tener correo corporativo en dominios catch-all. Rechazar el catch-all en bloque en tu formulario de registro es rechazar clientes enterprise. Aceptar por puntuación lo resuelve.
Preguntas frecuentes
¿Listo para integrarlo?
El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.