Mailbeam
API · SMTP

API di verifica email via SMTP

Nella roadmap: il sondaggio SMTP a livello di casella non è ancora attivo. Oggi l'esito viene da sintassi, MX/DNS, liste di indirizzi usa e getta e indirizzi di ruolo. Un record MX conferma che il dominio può ricevere posta; la verifica SMTP confermerà che quella specifica casella esiste.

Che cosa controlla Mailbeam

Ogni verifica esegue 7 controlli in parallelo e restituisce un risultato strutturato in meno di 100 ms.

Handshake SMTP diretto

Nella roadmap: Mailbeam si collegherà al server di posta di destinazione ed eseguirà EHLO + MAIL FROM + RCPT TO per controllare se quella specifica casella viene accettata, senza consegnare alcun messaggio. È il sondaggio che si chiama informalmente ping di un'email.

Gestione di MX multipli

I domini con più record MX vengono risolti oggi in ordine di priorità. Quando arriverà il sondaggio SMTP, se il server principale non risponde si passerà automaticamente ai record MX secondari.

Esito del controllo SMTP nella risposta

Il campo `smtp_check` fa già parte del contratto della risposta. Finché non arriva il sondaggio SMTP (è nella roadmap), non conferma alcuna casella e l'esito viene dagli altri controlli.

Gestione elegante dei server che bloccano i sondaggi

Google, Microsoft e alcuni server aziendali bloccano i sondaggi SMTP diretti. Quando arriverà il sondaggio, un sondaggio bloccato restituirà `status: unknown` invece di un falso negativo. Oggi l'esito viene da sintassi, MX/DNS, liste di indirizzi usa e getta e indirizzi di ruolo.

Diversa da un controllo solo MX

La validazione MX conferma che il dominio ha infrastruttura di posta e oggi gira a ogni richiesta. La verifica SMTP della singola casella (il nome prima della chiocciola) è nella roadmap.

Esecuzione in parallelo con gli altri controlli

Sintassi, usa e getta e ruolo non costano quasi nulla, e la query MX è di solito in cache, quindi oggi le risposte sono rapide. Quando arriverà il sondaggio SMTP (è nella roadmap), sarà la parte lenta a decidere il tempo di risposta.

Come funziona

1

Si ottengono i record MX

Mailbeam risolve i record MX del dominio per identificare il server di posta responsabile. I record dei domini più comuni vengono messi in cache per ridurre la latenza della query DNS.

2

Si apre la connessione SMTP

Nella roadmap: si aprirà una connessione TCP verso il server MX a priorità più alta sulla porta 25 (o la 587 sui server di solo invio) e Mailbeam manderà EHLO per presentarsi.

3

Si invia il comando RCPT TO

Mailbeam emetterà MAIL FROM con un indirizzo di sondaggio e RCPT TO con l'indirizzo di destinazione. Il codice di risposta del server (250 = accettato, 550 = rifiutato) determinerà se la casella esiste.

4

Si chiude la connessione e si restituisce l'esito

Mailbeam invierà QUIT e chiuderà la connessione senza consegnare alcuna posta. Fino ad allora, l'esito viene da sintassi, MX/DNS, liste di indirizzi usa e getta e indirizzi di ruolo.

Integralo in pochi minuti

PythonPython
import asyncio
import os

import httpx

# Non c'è ancora un SDK: Mailbeam è un unico 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"Controllo SMTP:  {result['checks']['smtp']}")
    print(f"Controllo MX:    {result['checks']['mx']}")
    print(f"Stato:           {result['status']}")
    print(f"Punteggio:       {result['score']}")

    if result["status"] == "unknown":
        # Il sondaggio non è arrivato a un verdetto: Google e Microsoft non si
        # sondano mai, e alcuni server applicano il greylisting. Usa il punteggio.
        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)

Quando usarlo

Validazione di liste di prospecting B2B

Prima di lanciare una sequenza a freddo, controlla che il dominio dell'azienda riceva posta e che i contatti non siano indirizzi di ruolo né usa e getta. La conferma della casella via SMTP è nella roadmap.

Validazione di posta transazionale critica

Prima di inviare fatture, contratti o email di onboarding a nuovi account, verifica l'indirizzo per intercettare refusi, domini morti e usa e getta. La verifica SMTP è nella roadmap.

Disambiguare i domini catch-all

Il rilevamento del catch-all dipende dal sondaggio SMTP, che è nella roadmap. Quando arriverà, l'esito del sondaggio e un punteggio limitato daranno il verdetto più utile per gli indirizzi aziendali su domini catch-all.

Prevenzione degli hard bounce su larga scala

Nelle campagne in cui la reputazione da mittente conta, verificare al momento dell'import elimina sintassi errata, domini morti e usa e getta. Intercettare le caselle inesistenti richiede il sondaggio SMTP, che è nella roadmap.

Domande frequenti

La verifica SMTP invia un'email vera?

No. L'handshake SMTP controlla se il server accetterebbe la posta, ma la connessione viene chiusa prima di consegnare alcun messaggio. La casella di destinazione non riceve nulla.

Perché Google blocca i sondaggi SMTP?

I server di Gmail e Google Workspace rispondono 250 (accettato) a tutti i comandi RCPT TO, che la casella esista o no: è una contromisura deliberata contro la raccolta di indirizzi. Quando arriverà il sondaggio SMTP di Mailbeam (è nella roadmap), questi indirizzi torneranno come `status: unknown` con un punteggio basato sui segnali di dominio.

Che differenza c'è tra smtp_check e il campo valid?

`smtp_check` ti dirà se l'handshake SMTP ha accettato l'indirizzo quando arriverà il sondaggio SMTP (è nella roadmap); oggi non conferma alcuna casella. `valid` è un booleano composto basato su sintassi, MX, usa e getta, ruolo e punteggio.

Si può sondare via SMTP tutti i server di posta?

No. Alcuni bloccano del tutto la porta 25, richiedono TLS o implementano il blocco dei sondaggi. Il sondaggio SMTP di Mailbeam è nella roadmap; oggi tutti gli esiti vengono da segnali di dominio: sintassi, MX/DNS, liste di indirizzi usa e getta e indirizzi di ruolo.

Pronto a integrarlo?

Scegli il piano adatto al tuo volume. Ogni account include chiavi di test per la tua CI.