Mailbeam
API · Puntuación

API de verificación de emails catch-all

En el roadmap: la detección de catch-all necesita el sondeo SMTP, que todavía no está activo. Hoy el veredicto sale de la sintaxis, MX/DNS, las listas de desechables y las direcciones de rol. Los dominios corporativos aceptan a menudo todo el correo; cuando llegue el sondeo, Mailbeam marcará ese comportamiento con una puntuación acotada de 0 a 100 en lugar de 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 el roadmap: en la misma conexión que la dirección real, Mailbeam sondeará 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 diremos.

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, desechable, rol— con pesos y topes publicados. El resultado del sondeo y el catch-all se sumarán cuando llegue el sondeo SMTP (está en el roadmap). Sin caja negra: cada punto es trazable.

Campo de motivo explicable

El motivo `catch_all_unverifiable` forma parte del contrato de la respuesta. Cuando llegue el sondeo SMTP, estas direcciones volverán como `risky` en lugar de `deliverable`, y tu aplicación podrá 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. Cuando llegue la detección de catch-all (está en el roadmap), Mailbeam los informará como arriesgados-pero-no-verificables en vez de no entregables, y podrás aceptarlos por umbral.

Se combina con las comprobaciones MX y de desechables

La detección de catch-all y el resultado SMTP están en el roadmap. Hoy recibes la comprobación MX, la marca de desechable, la de rol, la puntuación y el motivo en una sola respuesta.

Cómo funciona

1

Se envía el sondeo SMTP al servidor

En el roadmap: Mailbeam sondeará 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 marcará como catch-all.

2

Las señales se combinan en una puntuación

La sintaxis, la ruta de correo y las señales de desechable y de rol se combinan hoy con pesos publicados. Cuando llegue el sondeo, el catch-all aplicará un tope, no una penalización, porque el problema es que falta evidencia, no que haya evidencia de un problema.

3

Se genera la puntuación de confianza

Vuelve una puntuación de 0 a 100 junto al veredicto. Cuando llegue la detección de catch-all, una dirección catch-all no pasará de 70 por muy limpio que esté todo lo demás: el techo honesto para una dirección que ningún sondeo puede confirmar.

4

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

TypeScriptTypeScript
// 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

¿Qué es exactamente un dominio de email catch-all?

Un dominio catch-all configura su servidor de correo para aceptar la entrega a cualquier dirección del dominio, incluso a direcciones que no corresponden a ningún buzón real. Eso hace que la verificación SMTP no sea concluyente: el servidor dice «aceptada» para cualquier dirección que sondees.

¿Por qué no rechazar sin más todas las direcciones catch-all?

Muchos grandes dominios corporativos son catch-all. Rechazarlas en bloque en un producto B2B significa rechazar empleados legítimos de organizaciones grandes. Un veredicto puntuado más un motivo catch_all_unverifiable explícito te permite fijar tu propio umbral en lugar de aplicar una política única.

¿Cómo de precisa es la puntuación en catch-all?

En el conjunto de validación de Mailbeam, las direcciones con puntuación de 70 o más tienen una tasa de entregabilidad superior al 90 %. Las de puntuación por debajo de 40 se quedan por debajo del 30 %. El modelo sigue mejorando conforme se recogen más datos de verificación.

¿Qué umbral debería usar en mi caso?

Para formularios de leads B2B donde un rechazo erróneo sale caro: 50 o más. Para secuencias en frío donde la entregabilidad es crítica: 70 o más. Para marketplaces o contextos de alta seguridad: 80 o más. Ajústalo según lo que te cueste un falso positivo frente a lo que te cueste un rebote.

¿Listo para integrarlo?

Elige el plan que encaje con tu volumen. Todas las cuentas incluyen claves de test para tu CI.