Mailbeam
API · SMTP

API de verificación de email por SMTP

En el roadmap: el sondeo SMTP a nivel de buzón todavía no está activo. Hoy el veredicto sale de la sintaxis, MX/DNS, las listas de desechables y las direcciones de rol. Un registro MX confirma que el dominio puede recibir correo; la verificación SMTP confirmará que ese buzón concreto existe.

Qué comprueba Mailbeam

Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.

Handshake SMTP directo

En el roadmap: Mailbeam conectará con el servidor de correo de destino y ejecutará EHLO + MAIL FROM + RCPT TO para comprobar si ese buzón concreto se acepta, sin entregar ningún mensaje. Es el sondeo que se conoce informalmente como ping de email.

Gestión de MX múltiples

Los dominios con varios registros MX se resuelven hoy por orden de prioridad. Cuando llegue el sondeo SMTP, si el servidor principal no responde se pasará automáticamente a los registros MX secundarios.

Resultado de la comprobación SMTP en la respuesta

El campo `smtp_check` ya forma parte del contrato de la respuesta. Hasta que llegue el sondeo SMTP (está en el roadmap), no confirma ningún buzón y el veredicto sale del resto de comprobaciones.

Trato elegante de los servidores que bloquean sondeos

Google, Microsoft y algunos servidores corporativos bloquean los sondeos SMTP directos. Cuando llegue el sondeo, un sondeo bloqueado devolverá `status: unknown` en vez de un falso negativo. Hoy el veredicto sale de la sintaxis, MX/DNS, las listas de desechables y las direcciones de rol.

Distinta de una comprobación solo de MX

La validación MX confirma que el dominio tiene infraestructura de correo y hoy se ejecuta en cada petición. La verificación SMTP del buzón individual (el nombre antes de la arroba) está en el roadmap.

Ejecución en paralelo con el resto de comprobaciones

La sintaxis, los desechables y el rol casi no cuestan nada, y la consulta MX suele estar en caché, así que hoy las respuestas son rápidas. Cuando llegue el sondeo SMTP (está en el roadmap), será la parte lenta que decida el tiempo de respuesta.

Cómo funciona

1

Se obtienen los registros MX

Mailbeam resuelve los registros MX del dominio para identificar el servidor de correo responsable. Los registros de los dominios más comunes se cachean para reducir la latencia de la consulta DNS.

2

Se abre la conexión SMTP

En el roadmap: se abrirá una conexión TCP con el servidor MX de mayor prioridad en el puerto 25 (o el 587 en servidores solo de envío) y Mailbeam mandará EHLO para presentarse.

3

Se envía el comando RCPT TO

Mailbeam emitirá MAIL FROM con una dirección de sondeo y RCPT TO con la dirección de destino. El código de respuesta del servidor (250 = aceptada, 550 = rechazada) determinará si el buzón existe.

4

Se cierra la conexión y se devuelve el resultado

Mailbeam enviará QUIT y cerrará la conexión sin entregar ningún correo. Hasta entonces, el resultado sale de la sintaxis, MX/DNS, las listas de desechables y las direcciones de rol.

Intégralo en minutos

PythonPython
import asyncio
import os

import httpx

# Todavía no hay SDK: Mailbeam es un único POST.
async def verify_email(email: str) -> dict:
    async with httpx.AsyncClient(timeout=3.0) as client:
        response = await client.post(
            "https://api.mailbeam.dev/v1/verify",
            json={"email": email},
            headers={"Authorization": f"Bearer {os.environ['MAILBEAM_KEY']}"},
        )
    response.raise_for_status()
    return response.json()


async def verify_with_smtp_detail(email: str) -> dict:
    result = await verify_email(email)

    print(f"Comprobación SMTP:  {result['checks']['smtp']}")
    print(f"Comprobación MX:    {result['checks']['mx']}")
    print(f"Estado:             {result['status']}")
    print(f"Puntuación:         {result['score']}")

    if result["status"] == "unknown":
        # El sondeo no ha llegado a un veredicto: a Google y Microsoft nunca se
        # les sondea, y algunos servidores aplican greylisting. Usa la puntuación.
        if result["score"] >= 60:
            return {"action": "allow", "reason": "domain_signals_positive"}
        return {"action": "review", "reason": "low_confidence_unknown"}

    if not result["valid"]:
        return {"action": "reject", "reason": result["reason"]}

    return {"action": "allow", "reason": "smtp_verified"}

# Uso
result = asyncio.run(verify_with_smtp_detail("user@company.com"))
print(result)

Cuándo usarlo

Validación de listas de prospección B2B

Antes de lanzar una secuencia en frío, comprueba que el dominio de la empresa recibe correo y que los contactos no son direcciones de rol ni desechables. La confirmación del buzón por SMTP está en el roadmap.

Validación de correo transaccional crítico

Antes de enviar facturas, contratos o correos de onboarding a cuentas nuevas, verifica la dirección para cazar erratas, dominios muertos y desechables. La verificación SMTP está en el roadmap.

Desambiguar dominios catch-all

La detección de catch-all depende del sondeo SMTP, que está en el roadmap. Cuando llegue, el resultado del sondeo y una puntuación acotada darán el veredicto más útil para direcciones corporativas en dominios catch-all.

Prevención de hard bounces a escala

En campañas donde la reputación de remitente importa, verificar al importar elimina sintaxis rota, dominios muertos y desechables. Cazar buzones inexistentes requiere el sondeo SMTP, que está en el roadmap.

Preguntas frecuentes

¿La verificación SMTP envía un email real?

No. El handshake SMTP comprueba si el servidor aceptaría el correo, pero la conexión se cierra antes de entregar ningún mensaje. El buzón de destino no recibe nada.

¿Por qué bloquea Google los sondeos SMTP?

Los servidores de Gmail y Google Workspace responden 250 (aceptado) a todos los comandos RCPT TO exista o no el buzón: es una contramedida deliberada frente a la recolección de direcciones. Cuando llegue el sondeo SMTP de Mailbeam (está en el roadmap), estas direcciones volverán como `status: unknown` con una puntuación basada en señales de dominio.

¿Qué diferencia hay entre smtp_check y el campo valid?

`smtp_check` te dirá si el handshake SMTP aceptó la dirección cuando llegue el sondeo SMTP (está en el roadmap); hoy no confirma ningún buzón. `valid` es un booleano compuesto que se basa en la sintaxis, el MX, los desechables, el rol y la puntuación.

¿Se puede sondear por SMTP a todos los servidores de correo?

No. Algunos bloquean el puerto 25 por completo, exigen TLS o implementan bloqueo de sondeos. El sondeo SMTP de Mailbeam está en el roadmap; hoy todos los veredictos salen de señales de dominio: sintaxis, MX/DNS, listas de desechables y direcciones de rol.

¿Listo para integrarlo?

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