Mailbeam
API · Punteggio

API di verifica delle email catch-all

Nella roadmap: il rilevamento del catch-all richiede il sondaggio SMTP, che non è ancora attivo. Oggi l'esito viene da sintassi, MX/DNS, liste di indirizzi usa e getta e indirizzi di ruolo. I domini aziendali accettano spesso tutta la posta; quando arriverà il sondaggio, Mailbeam segnalerà quel comportamento con un punteggio limitato da 0 a 100 invece di una certezza che non può sostenere.

Che cosa controlla Mailbeam

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

Rilevamento dei domini catch-all

Nella roadmap: nella stessa connessione dell'indirizzo reale, Mailbeam sonderà una casella casuale del dominio. Se viene accettata anche quella, il server accetta tutto, quindi l'accettazione dell'indirizzo reale non dimostra nulla, e noi lo diremo.

Punteggio di qualità da 0 a 100

Il punteggio è additivo a partire da un insieme fisso di segnali — sintassi, percorso di posta, usa e getta, ruolo — con pesi e tetti pubblicati. L'esito del sondaggio e il catch-all si aggiungeranno quando arriverà il sondaggio SMTP (è nella roadmap). Nessuna scatola nera: ogni punto è tracciabile.

Campo di motivo spiegabile

Il motivo `catch_all_unverifiable` fa parte del contratto della risposta. Quando arriverà il sondaggio SMTP, questi indirizzi torneranno come `risky` invece di `deliverable`, e la tua applicazione potrà trattare «non siamo riusciti a confermarlo» in modo diverso da «questa casella non esiste».

Soglie configurabili

Il punteggio è tuo da interpretare. Fissa una soglia di 70 o più sui moduli B2B severi, e di 40 o più per accettare liste ampie. L'API restituisce i dati; la tua logica applica la politica.

Precisione sui domini aziendali

I grandi domini aziendali sono spesso catch-all. Quando arriverà il rilevamento del catch-all (è nella roadmap), Mailbeam li riporterà come rischiosi-ma-non-verificabili invece che non recapitabili, e potrai accettarli per soglia.

Si combina con i controlli MX e usa e getta

Il rilevamento del catch-all e l'esito SMTP sono nella roadmap. Oggi ricevi il controllo MX, la marcatura usa e getta, quella di ruolo, il punteggio e il motivo in una sola risposta.

Come funziona

1

Si invia il sondaggio SMTP al server

Nella roadmap: Mailbeam sonderà il server di posta con un comando RCPT TO. Se il server accetta tutti gli indirizzi che la casella esista o no, il dominio verrà segnato come catch-all.

2

I segnali si combinano in un punteggio

Sintassi, percorso di posta e segnali di usa e getta e di ruolo si combinano oggi con pesi pubblicati. Quando arriverà il sondaggio, il catch-all applicherà un tetto, non una penalità, perché il problema è che manca l'evidenza, non che ci sia evidenza di un problema.

3

Si genera il punteggio di confidenza

Torna un punteggio da 0 a 100 insieme all'esito. Quando arriverà il rilevamento del catch-all, un indirizzo catch-all non supererà 70 per quanto tutto il resto sia pulito: il tetto onesto per un indirizzo che nessun sondaggio può confermare.

4

Si restituiscono punteggio e motivo

I campi `score`, `catch_all` e `reason` sono inclusi nella risposta standard di verifica. Usali per applicare la tua logica di soglia nella tua applicazione.

Integralo in pochi minuti

TypeScriptTypeScript
// Non c'è ancora un SDK: il wrapper di 12 righe di /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) {
    // Soglia a scaglioni per gli indirizzi catch-all
    if (result.score >= 70) return "accept";
    if (result.score >= 40) return "review";
    return "reject";
  }

  // Indirizzo normale: controllo binario di valid + soglia minima di punteggio
  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("Non è stato possibile verificare l'indirizzo email.");
  }

  await db.leads.create({
    email,
    score: result.score,
    catchAll: result.catch_all,
    queue: decision === "review" ? "manual_review" : "active",
  });
}

Quando usarlo

Moduli demo e di raccolta B2B

Gli indirizzi aziendali stanno su domini catch-all in misura sproporzionata. Rifiutarli in blocco su un modulo B2B significa rifiutare potenziali clienti reali. Usa il punteggio e il motivo catch_all_unverifiable per fissare la tua soglia.

Import e arricchimento del CRM commerciale

Quando importi liste di potenziali clienti B2B, molti indirizzi vengono da domini aziendali catch-all. Accettare per punteggio invece di rifiutare in binario migliora moltissimo la proporzione di lead utilizzabili.

Preparazione di liste di prospecting a freddo

Nelle sequenze in uscita, usa una soglia di punteggio più alta (70 o più) per includere solo gli indirizzi catch-all ad alta confidenza: proteggi il tuo dominio di invio e massimizzi i contatti raggiungibili.

Registrazioni su un SaaS enterprise

Gli utenti enterprise hanno di solito posta aziendale su domini catch-all. Rifiutare il catch-all in blocco nel tuo modulo di registrazione significa rifiutare clienti enterprise. Accettare per punteggio lo risolve.

Domande frequenti

Che cos'è esattamente un dominio email catch-all?

Un dominio catch-all configura il proprio server di posta per accettare la consegna a qualsiasi indirizzo del dominio, anche a indirizzi che non corrispondono ad alcuna casella reale. Questo rende non conclusiva la verifica SMTP: il server dice «accettato» per qualsiasi indirizzo tu sondi.

Perché non rifiutare semplicemente tutti gli indirizzi catch-all?

Molti grandi domini aziendali sono catch-all. Rifiutarli in blocco in un prodotto B2B significa rifiutare dipendenti legittimi di grandi organizzazioni. Un esito punteggiato più un motivo catch_all_unverifiable esplicito ti permette di fissare la tua soglia invece di applicare una politica unica.

Quanto è preciso il punteggio sui catch-all?

Sull'insieme di validazione di Mailbeam, gli indirizzi con punteggio di 70 o più hanno un tasso di recapitabilità superiore al 90%. Quelli con punteggio sotto 40 restano sotto il 30%. Il modello continua a migliorare man mano che si raccolgono più dati di verifica.

Che soglia dovrei usare nel mio caso?

Per moduli lead B2B in cui un rifiuto sbagliato costa caro: 50 o più. Per sequenze a freddo in cui la recapitabilità è critica: 70 o più. Per marketplace o contesti ad alta sicurezza: 80 o più. Regolala in base a quanto ti costa un falso positivo rispetto a quanto ti costa un bounce.

Pronto a integrarlo?

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