API de détection des adresses de rôle
Une boîte partagée comme info@ ou sales@ n'est pas une personne. Signalez-la à la collecte pour filtrer les inscriptions, ajuster vos scores de leads ou l'exclure des envois à froid.
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.
Base de préfixes de rôle curée
Comparaison à une liste tenue à jour de préfixes — info, admin, support, sales, billing, noreply et des dizaines d'autres — normalisés pour l'adressage avec + (info+tag@).
Un booléen, plus le contexte
La réponse porte role: true et exécute quand même tous les autres contrôles : vous gardez le verdict de délivrabilité complet plutôt qu'un simple oui/non.
Consciente de l'adressage avec +
info+newsletter@ est correctement identifiée comme l'adresse de rôle info@, et non traitée comme une boîte personnelle unique.
Préfixes localisés
Reconnaît les préfixes de rôle courants hors anglais (kontakt@, ventas@, contato@) pour que les listes internationales ne soient pas sous-signalées.
Application réglable
Les adresses de rôle sont signalées, pas rejetées d'office — à vous de décider de bloquer, de router vers le commercial, ou simplement de baisser le score.
Un seul appel, en ligne
La détection fait partie de la même réponse /v1/verify : aucune requête ni latence supplémentaire dans votre flux.
Comment ça marche
POSTez l'adresse
Envoyez l'e-mail à /v1/verify. La détection de rôle tourne aux côtés des contrôles de syntaxe, MX, SMTP et jetables.
La partie locale est normalisée
Ce qui précède le @ est mis en minuscules et débarrassé de l'adressage +tag avant comparaison.
Comparaison à la base de préfixes
La partie locale normalisée est confrontée à l'ensemble de préfixes de rôle tenu à jour, variantes localisées comprises.
L'indicateur revient dans le résultat
role: true|false figure dans le JSON, à côté du statut et du score, pour que vous branchiez dessus dans votre code.
Intégrez-le en quelques minutes
const res = await fetch("https://api.mailbeam.dev/v1/verify", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` },
body: JSON.stringify({ email }),
});
const { role, status } = await res.json();
if (role) {
routeToSalesAssist(email); // boîte partagée — pas de libre-service
} else if (status === "deliverable") {
allowSelfServeSignup(email);
}Quand l'utiliser
Filtrage des inscriptions B2B
Routez les inscriptions info@ et admin@ vers un parcours accompagné plutôt qu'en libre-service, où une boîte partagée convertit rarement.
Exclusion en prospection à froid
Supprimez les adresses de rôle avant un envoi à froid : elles génèrent des plaintes et appartiennent rarement à un décideur unique.
Scoring des leads
Pondérez à la baisse les adresses de rôle dans votre modèle, puisqu'elles signalent une boîte partagée et non un acheteur identifié.
Segmentation de liste
Séparez les adresses personnelles des adresses de service pour adresser à chacune le bon message.
Questions fréquentes
Qu'est-ce qui compte comme adresse de rôle ?
Une adresse dont la partie locale désigne une fonction ou un service plutôt qu'une personne : info@, admin@, support@, sales@, billing@, noreply@ et similaires. Ce sont en général des boîtes partagées surveillées par plusieurs personnes, ou par personne.
Faut-il bloquer les adresses de rôle d'office ?
En général non. Pour un produit B2B, une adresse de rôle peut être un contact légitime. Mailbeam les signale pour que vous appliquiez votre propre politique — filtrer, router, baisser le score ou exclure — plutôt que d'imposer un rejet.
L'adressage avec + est-il géré ?
Oui. info+promo@example.com est normalisée en rôle info@ avant comparaison : les variantes sous-adressées sont donc bien détectées.
Les préfixes de rôle non anglais sont-ils détectés ?
Oui. La base contient les préfixes localisés courants comme kontakt@, ventas@ et contato@, pour que les listes internationales soient signalées correctement.
La détection de rôle coûte-t-elle un appel supplémentaire ?
Non. Elle fait partie de la réponse de vérification standard — une seule requête renvoie l'indicateur de rôle et le verdict de délivrabilité complet.
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.