Mailbeam
API · Rilevamento

API di rilevamento delle email di ruolo

Le caselle condivise come info@ e vendite@ non sono persone. Segnalale alla raccolta per poter limitare le registrazioni, correggere il punteggio del lead o escluderle dagli invii a freddo.

Che cosa controlla Mailbeam

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

Base di prefissi di ruolo curata

Confronta con una lista mantenuta di prefissi di ruolo — info, admin, supporto, vendite, fatturazione, noreply e decine di altri — normalizzata per i sottoindirizzi (info+etichetta@).

Restituisce un booleano e il suo contesto

La risposta segna role: true e continua a eseguire tutti gli altri controlli, così mantieni l'esito completo di recapitabilità invece di un sì/no secco.

Consapevole dei sottoindirizzi

info+newsletter@ viene identificato correttamente come l'account di ruolo info@, non come una casella personale unica.

Prefissi in più lingue

Riconosce i prefissi di ruolo comuni fuori dall'inglese (kontakt@, ventas@, contatti@) perché le liste internazionali non restino senza marcatura.

Applicazione regolabile

Gli account di ruolo vengono segnalati, non rifiutati automaticamente: decidi tu se bloccare, instradare alle vendite o semplicemente abbassarne il punteggio.

Gira in linea in una sola chiamata

Il rilevamento del ruolo fa parte della stessa risposta di /v1/verify, senza aggiungere alcuna richiesta né latenza al tuo flusso.

Come funziona

1

Fai POST dell'indirizzo

Invia l'email a /v1/verify. Il rilevamento del ruolo gira insieme ai controlli di sintassi, MX, SMTP e usa e getta.

2

Si normalizza la parte locale

La parte che precede la chiocciola viene portata in minuscolo e privata dei sottoindirizzi +etichetta prima del confronto.

3

Si confronta il prefisso con il database

La parte locale normalizzata viene controllata contro l'insieme mantenuto di prefissi di ruolo, comprese le varianti localizzate.

4

Si restituisce la marcatura nel risultato

role: true|false torna nel JSON insieme allo stato e al punteggio, così puoi ramificare su di essa nel tuo codice.

Integralo in pochi minuti

Ramificare in base al ruolotypescript
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);      // casella condivisa: non al self-service
} else if (status === "deliverable") {
  allowSelfServeSignup(email);
}

Quando usarlo

Filtro delle registrazioni B2B

Instrada le registrazioni con info@ e admin@ verso un flusso assistito dalle vendite invece del self-service, dove una casella condivisa converte raramente.

Soppressione nel prospecting a freddo

Sopprimi gli account di ruolo prima di un invio a freddo: generano segnalazioni e raramente appartengono a una singola persona con potere decisionale.

Lead scoring

Abbassa il peso degli account di ruolo nel tuo modello di punteggio, dato che indicano una casella condivisa e non un acquirente individuale.

Segmentazione delle liste

Separa gli indirizzi personali da quelli di reparto per poterti rivolgere a ciascuno come si deve.

Domande frequenti

Che cosa conta come indirizzo di ruolo?

Un indirizzo la cui parte locale è una funzione o un reparto invece di una persona: info@, admin@, supporto@, vendite@, fatturazione@, noreply@ e simili. Sono di solito caselle condivise presidiate da più persone, o da nessuna.

Devo bloccare del tutto gli account di ruolo?

Di solito no. Nei prodotti B2B un account di ruolo può essere un contatto legittimo. Mailbeam li segnala perché tu applichi la tua politica — limitare, instradare, abbassare il punteggio o sopprimere — invece di forzare un rifiuto.

Gestisce gli indirizzi con il segno più?

Sì. info+promo@example.com viene normalizzato al ruolo info@ prima del confronto, quindi anche le varianti con sottoindirizzo vengono rilevate.

Vengono rilevati i prefissi di ruolo non in inglese?

Sì. La base include prefissi localizzati comuni come kontakt@, ventas@ e contatti@, perché le liste internazionali vengano segnalate con precisione.

Il rilevamento del ruolo costa una chiamata in più?

No. Fa parte della risposta di verifica standard: una sola richiesta restituisce la marcatura di ruolo insieme all'esito completo di recapitabilità.

Pronto a integrarlo?

Il piano gratuito include 1.000 verifiche al mese. Senza carta di credito.