Mailbeam
API · Scoring

API de vérification catch-all

Sur la feuille de route : la détection catch-all demande le sondage SMTP, qui n'est pas encore actif. Aujourd'hui, le verdict vient de la syntaxe, de MX/DNS, des listes d'adresses jetables et des adresses de rôle. Les domaines d'entreprise acceptent souvent tout le courrier ; quand le sondage arrivera, Mailbeam signalera ce comportement avec un score plafonné de 0 à 100 plutôt qu'une réussite qu'il ne peut pas étayer.

Ce que Mailbeam contrôle

Chaque vérification lance 7 contrôles en parallèle et renvoie un résultat structuré en moins de 100 ms.

Détection des domaines catch-all

Sur la feuille de route : dans la même connexion que l'adresse réelle, Mailbeam sondera une boîte aléatoire du domaine. Si elle est acceptée elle aussi, le serveur accepte tout — l'acceptation de l'adresse réelle ne prouve donc rien, et nous le dirons.

Un score de qualité de 0 à 100

Le score est additif, à partir d'un ensemble fixe de signaux — syntaxe, route de courrier, jetables, rôle — avec des poids et des plafonds publiés. Le résultat du sondage et le catch-all s'y ajouteront quand le sondage SMTP arrivera (il est sur la feuille de route). Pas de boîte noire, et chaque point est traçable.

Un champ de motif explicable

Le motif `catch_all_unverifiable` fait partie du contrat de la réponse. Quand le sondage SMTP arrivera, ces adresses reviendront en `risky` plutôt qu'en `deliverable`, et votre application pourra traiter « nous n'avons pas pu confirmer » autrement que « cette boîte n'existe pas ».

Des seuils configurables

Le score vous appartient. Fixez un seuil de 70 pour des formulaires B2B stricts, de 40 pour une acceptation large. L'API renvoie la donnée ; votre logique applique la politique.

Précision sur les domaines d'entreprise

Les grands domaines d'entreprise sont fréquemment catch-all. Quand la détection catch-all arrivera (elle est sur la feuille de route), Mailbeam les signalera comme à risque mais invérifiables plutôt que non délivrables, et vous pourrez les accepter sur un seuil.

Se combine aux contrôles MX et jetables

La détection catch-all et le résultat SMTP sont sur la feuille de route. Aujourd'hui, vous obtenez le contrôle MX, l'indicateur jetable, celui de rôle, le score et le motif dans une seule réponse.

Comment ça marche

1

Sondage SMTP envoyé au serveur

Sur la feuille de route : Mailbeam sondera le serveur avec une commande RCPT TO. Si le serveur accepte toutes les adresses quelle que soit l'existence de la boîte, le domaine sera signalé catch-all.

2

Les signaux sont combinés en un score

Syntaxe, route de courrier, jetables et rôle sont combinés aujourd'hui avec des poids publiés. Quand le sondage arrivera, le catch-all appliquera un plafond plutôt qu'une pénalité, parce que le problème est l'absence de preuve, pas la preuve d'un problème.

3

Génération du score de confiance

Un score de 0 à 100 accompagne le verdict. Quand la détection catch-all arrivera, une adresse catch-all ne dépassera pas 70, aussi propre que soit le reste : le plafond honnête pour une adresse qu'aucun sondage ne peut confirmer.

4

Score et motif renvoyés

Les champs `score`, `catch_all` et `reason` figurent dans la réponse verify standard. Servez-vous-en pour appliquer votre propre logique de seuil.

Intégrez-le en quelques minutes

TypeScriptTypeScript
// Pas encore de SDK — le wrapper de 12 lignes 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) {
    // Seuil par paliers pour les adresses catch-all
    if (result.score >= 70) return "accept";
    if (result.score >= 40) return "review";
    return "reject";
  }
  // Adresse standard : contrôle binaire valid + plancher de score
  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("L'adresse e-mail n'a pas pu être vérifiée.");
  }
  await db.leads.create({
    email,
    score: result.score,
    catchAll: result.catch_all,
    queue: decision === "review" ? "manual_review" : "active",
  });
}

Quand l'utiliser

Formulaires de démo et de capture de leads B2B

Les adresses professionnelles sont surreprésentées sur les domaines catch-all. Les rejeter en bloc sur un formulaire B2B écarte de vrais leads grands comptes. Servez-vous du score et du motif catch_all_unverifiable pour fixer votre propre seuil.

Import et enrichissement du CRM commercial

À l'import de listes de prospects B2B, beaucoup d'adresses viennent de domaines d'entreprise catch-all. Une acceptation fondée sur le score, plutôt qu'un rejet binaire, améliore nettement le taux de leads exploitables.

Préparation d'une liste de prospection à froid

Pour des séquences sortantes, utilisez un seuil plus élevé (70 ou plus) pour ne garder que les adresses catch-all à forte confiance — vous protégez votre domaine d'envoi tout en maximisant les prospects joignables.

Inscriptions à un SaaS pour entreprises

Les utilisateurs grands comptes ont souvent une adresse professionnelle sur un domaine catch-all. Un rejet en bloc sur votre formulaire écarte des clients entreprise. L'acceptation par score corrige cela.

Questions fréquentes

Qu'est-ce qu'un domaine e-mail catch-all, précisément ?

Un domaine catch-all configure son serveur pour accepter la livraison vers n'importe quelle adresse du domaine — même celles qui ne correspondent à aucune boîte réelle. La vérification SMTP devient donc non concluante : le serveur répond « accepté » à toute adresse sondée.

Pourquoi ne pas simplement rejeter toutes les adresses catch-all ?

Beaucoup de grands domaines d'entreprise sont catch-all. Un rejet en bloc sur un produit B2B revient à écarter de vrais salariés de grandes organisations. Un verdict scoré, plus un motif catch_all_unverifiable explicite, vous laisse fixer votre propre seuil au lieu d'appliquer une politique unique.

Quelle est la précision du score catch-all ?

Sur le jeu de validation de Mailbeam, les adresses au score de 70 ou plus affichent un taux de délivrabilité supérieur à 90 %. Celles sous 40 restent sous 30 %. Le modèle continue de s'améliorer à mesure que les données de vérification s'accumulent.

Quel seuil choisir pour mon cas d'usage ?

Pour des formulaires de leads B2B où les faux rejets coûtent cher : 50. Pour des séquences à froid où la délivrabilité est critique : 70. Pour des places de marché ou des contextes sensibles : 80. Ajustez selon l'arbitrage entre le coût d'un faux positif et celui d'un bounce.

Prêt à l'intégrer ?

Choisissez l'offre adaptée à votre volume. Chaque compte inclut des clés de test pour votre CI.