BillionVerify è ora disponibile in Vercel Connect. Apri vercel.com/connect/billionverify, oppure cerca “BillionVerify” nella sezione Connect della dashboard Vercel e aggiungi una volta la tua chiave API BillionVerify a un connettore. Dopodiché, qualsiasi progetto Vercel colleghi potrà verificare gli indirizzi email in fase di esecuzione: il tuo codice chiede la chiave a Vercel Connect quando ne ha bisogno, così la chiave non rimane mai in una variabile d’ambiente né nel codice sorgente.
Il connettore BillionVerify per Vercel funziona con la stessa REST API, gli stessi crediti e la stessa cronologia delle verifiche che già utilizzi. È l’equivalente Vercel del nostro connettore Claude: gli utenti Claude verificano gli indirizzi chiedendolo in chat, mentre gli sviluppatori Vercel li verificano tramite moduli di registrazione, processi in background e agenti AI che distribuiscono su Vercel.
Perché usare Vercel Connect per la verifica delle email
La maggior parte dei team aggiunge la verifica delle email incollando una chiave API nelle variabili d’ambiente di ogni progetto. Funziona finché non hai diversi progetti, ambienti di anteprima e produzione e alcune persone che possono leggere tali variabili. Ruotare la chiave significa quindi trovare ogni copia.
Vercel Connect sposta la chiave in un unico punto a livello di team:
- Una chiave, molti progetti. Memorizzi la tua chiave API di BillionVerify nel connettore una sola volta. Ogni progetto che colleghi può utilizzarla e nessuno conserva una propria copia.
- Scegli tu chi può usarla. Un connettore risponde alle richieste di token solo dai progetti e dagli ambienti che colleghi. Consulta i collegamenti ai progetti nella documentazione di Vercel.
- Le richieste vengono registrate. Ogni connettore dispone di una scheda Osservabilità che registra le richieste di token per progetto, ambiente e soggetto.
- La rotazione richiede una sola modifica. Crea una nuova chiave in BillionVerify, aggiorna il connettore e ogni progetto collegato la utilizzerà.
Per gli agenti IA questo è più importante che per una classica applicazione web. Un agente in grado di chiamare strumenti non dovrebbe poter leggere credenziali grezze dal proprio ambiente. Con Vercel Connect, il codice dell’agente richiede la chiave nel momento in cui chiama BillionVerify, e la chiave non fa mai parte del deployment.
Come trovare BillionVerify in Vercel Connect
Esistono due modi per raggiungere il connettore BillionVerify per Vercel. Entrambi portano alla stessa configurazione.
Dalla directory pubblica di Vercel Connect
Apri vercel.com/connect/browse e digita "billionverify" nella casella di ricerca, oppure vai direttamente a vercel.com/connect/billionverify. La scheda mostra il metodo di connessione (API Key) e una breve descrizione: verifica gli indirizzi email uno alla volta, in batch o tramite caricamento di file in blocco.
Dalla dashboard Vercel
Se hai già effettuato l’accesso a Vercel, apri Connect nella dashboard del tuo team, digita "billionverify" nel campo di ricerca e seleziona BillionVerify da All Connectors. Questo è il percorso più rapido quando configuri un progetto che già distribuisci su Vercel.
Come aggiungere il connettore BillionVerify al tuo progetto Vercel
Il connettore utilizza una chiave API del tuo account BillionVerify. Se non hai ancora un account, registrati su billionverify.com prima; il piano gratuito offre 20 crediti ogni giorno in cui utilizzi il tuo account, fino a 600 al mese, senza carta di credito.
Passaggio 1: crea una chiave API BillionVerify
Accedi e apri la pagina delle chiavi API nella dashboard BillionVerify. Crea una chiave e assegnale un nome che indichi dove viene utilizzata, ad esempio "vercel-production", così potrai riconoscerla in seguito nella cronologia di utilizzo.
Passaggio 2: configura la connessione in Vercel
Fai clic su BillionVerify in Vercel Connect per aprire Add Connection, quindi completa il passaggio Configure:
- Name. Vercel suggerisce un nome casuale come
chestnut-fence. Sostituiscilo con qualcosa che riconoscerai, comebillionverify-prod. Insieme al servizio, forma l'ID del connettore utilizzato dal tuo codice:billionverify/billionverify-prod. - UID (optional). Lascialo vuoto e Vercel lo genererà dal servizio e dal nome del connettore.
- Shared API Keys or Per-User API Keys. Shared memorizza una chiave nel connettore per tutti gli utenti della tua app. Per-User chiede a ciascuno dei tuoi utenti di fornire la propria chiave BillionVerify al momento dell'autorizzazione. La sezione successiva spiega quando scegliere l'una o l'altra opzione.
- Key. Incolla la chiave API del passaggio 1.
- Scope and Expiration (optional). Imposta una scadenza se il tuo team ruota le chiavi secondo una pianificazione; altrimenti lascia i valori predefiniti.
Fai clic su Create Connector per salvarlo.
Passaggio 3: collega i progetti che possono utilizzarlo
Collega il connettore ai progetti e agli ambienti Vercel autorizzati a verificare le email, ad esempio la produzione e l'anteprima della tua app web, ma non uno strumento interno che non ha motivo di chiamare BillionVerify. Un progetto non collegato riceve un errore invece di una chiave.
Preferisci il terminale? Usa la Vercel CLI
La stessa configurazione funziona dalla Vercel CLI. Eseguila dal progetto che utilizzerà il connettore:
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull scarica un token di sviluppo con validità breve in .env.local, quindi getToken funziona anche quando esegui l'app sul tuo computer. Quel file contiene un token Vercel, non la tua chiave BillionVerify.
Chiavi API condivise o chiavi API per utente?
Scegli Chiavi API condivise quando è il tuo prodotto a eseguire le verifiche: un modulo di registrazione che rifiuta gli indirizzi usa e getta, un processo notturno che pulisce i nuovi lead, un agente interno utilizzato dal tuo team. Tutte le verifiche utilizzano il tuo account BillionVerify e i tuoi crediti.
Scegli Chiavi API per utente quando crei un prodotto per altre persone che hanno i propri account BillionVerify, ad esempio un’estensione per CRM, uno strumento per email a freddo o un template di agente. Ogni utente fornisce la propria chiave durante l’autorizzazione, quindi le verifiche utilizzano i propri crediti e compaiono nella propria cronologia BillionVerify.
Chiama BillionVerify dal tuo codice
Installa l’SDK Vercel Connect nel tuo progetto:
npm install @vercel/connect
Quindi richiedi la chiave con getToken e inviala nell’header BV-API-KEY. Ecco un gestore di route Next.js che verifica un indirizzo con un controllo SMTP in tempo reale:
// app/api/verify-email/route.ts
import { getToken } from '@vercel/connect';
export async function POST(req: Request) {
const { email } = await req.json();
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'app' },
});
const res = await fetch('https://api.billionverify.com/v1/verify/single', {
method: 'POST',
headers: { 'BV-API-KEY': apiKey, 'Content-Type': 'application/json' },
body: JSON.stringify({ email, check_smtp: true }),
});
const body = await res.json();
return Response.json(body.data);
}
L’oggetto data della risposta include status (valid, invalid, catchall, role, disposable o unknown), is_deliverable, is_disposable, is_catchall, is_role e un reason. Un modulo di registrazione solitamente blocca gli indirizzi invalidi e usa e accetta quelli validi, mentre lascia passare gli indirizzi catch-all e unknown con un flag, così puoi monitorarne il comportamento.
L’SDK memorizza la chiave in memoria e la riutilizza, quindi non chiama nuovamente Vercel Connect per ogni indirizzo verificato.
Verifica un gruppo o un intero file
La stessa chiave funziona con ogni endpoint BillionVerify:
POST /v1/verify/singleverifica un indirizzo, come sopra.POST /v1/verify/bulkverifica fino a 50 indirizzi in un’unica richiesta. Invia{"emails": [...], "check_smtp": true}.POST /v1/verify/filecarica un CSV per un processo in background. Controlla lo stato conGET /v1/verify/file/{id}e scarica i risultati daGET /v1/verify/file/{id}/results.
Un modello comune su Vercel consiste nell’utilizzare un processo cron che raccoglie i nuovi lead della giornata, li invia a /v1/verify/bulk in gruppi di 50 e salva lo stato nel database. I dettagli delle richieste e delle risposte sono disponibili nel riferimento API.
Chiavi per utente nel codice
Con le chiavi API per utente, passa l’ID dell’utente autenticato come subject:
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Se l’utente non ha ancora fornito una chiave, l’SDK genera UserAuthorizationRequiredError. Intercetta l’errore e mostra nella tua interfaccia il passaggio “Collega il tuo account BillionVerify”. Le altre classi di errore sono elencate nella documentazione dei token di Vercel.
Usa BillionVerify negli agenti AI su Vercel
Se crei un agente su Vercel, assegnagli uno strumento “verifica email” il cui codice chiama getToken e poi BillionVerify, esattamente come il gestore della route precedente. Il modello decide quando verificare un indirizzo; la chiave rimane in Vercel Connect e non appare mai nel prompt, nell'output dello strumento o nell'ambiente dell'agente.
La stessa chiave API alimenta anche le nostre altre integrazioni con gli agenti:
- Server MCP.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpesegue localmente il nostro server MCP con gli stessi 11 strumenti della versione ospitata. La configurazione per ogni client è nella guida MCP. - Skill per agenti. Gli agenti di coding possono installare la skill BillionVerify con
npx skills add BillionVerify/billionverify-skill. Maggiori informazioni nelle Skill per agenti.
Come funzionano i crediti
La verifica tramite il connettore Vercel costa quanto una verifica effettuata altrove in BillionVerify: un credito per un risultato definitivo. Gli indirizzi sconosciuti, usa e getta e formattati male sono gratuiti, così come controllare nuovamente lo stesso indirizzo entro 24 ore. Gli indirizzi catch-all vengono segnalati come catch-all e non conteggiati come validi, quindi decidi tu come gestirli.
Vercel fattura separatamente le proprie richieste di token, secondo i prezzi di Vercel Connect. Poiché l’SDK memorizza nella cache la chiave, una richiesta di token copre solitamente molte verifiche.
BillionVerify è anche in Claude
All'inizio di questo mese BillionVerify è stato inserito nella directory dei connettori di Claude. Se tu o il tuo team lavorate in Claude, potete collegare BillionVerify lì con il vostro account, senza bisogno di una chiave API, e chiedere a Claude di verificare un indirizzo o pulire un elenco fino a 50 elementi direttamente in chat. Leggi BillionVerify è ora nella directory dei connettori di Claude per la configurazione.
Claude serve per controllare gli indirizzi mentre lavori. Il connettore Vercel serve per i controlli eseguiti autonomamente dalle tue app e dai tuoi agenti.
Domande frequenti
Che cos'è il connettore BillionVerify per Vercel?
È l'integrazione di BillionVerify in Vercel Connect. Memorizzi la tua chiave API BillionVerify una volta nel connettore, quindi i progetti Vercel collegati possono richiedere quella chiave in fase di esecuzione per chiamare l'API di verifica delle email di BillionVerify.
Devo ancora inserire la mia chiave API nelle variabili d'ambiente?
No. La chiave risiede nel connettore. Il tuo codice la ottiene con getToken da @vercel/connect, che autentica automaticamente il tuo deployment in Vercel Connect.
Verificare le email tramite Vercel ha costi aggiuntivi?
Non da parte di BillionVerify. Le verifiche utilizzano i crediti del tuo account BillionVerify alla tariffa normale. Vercel applica costi per le proprie richieste di token secondo i prezzi di Vercel Connect.
Devo scegliere Shared API Keys o Per-User API Keys?
Shared API Keys quando la tua app verifica indirizzi usando il tuo account. Per-User API Keys quando sviluppi un prodotto i cui utenti hanno ciascuno il proprio account BillionVerify e devono pagare le proprie verifiche.
Posso usare il connettore al di fuori di un deployment Vercel?
Sì. Per lo sviluppo locale, vercel env pull ti fornisce un token di sviluppo. In altri ambienti, come una CI esterna, puoi passare un token di accesso Vercel a getToken con l'opzione vercelToken. Puoi anche chiamare direttamente l'API BillionVerify con la tua chiave, senza Vercel Connect.
Il connettore Vercel funziona con il server MCP ospitato?
Il server MCP ospitato all'indirizzo mcp.billionverify.com effettua l'accesso tramite OAuth, come fa il connettore Claude. Il connettore Vercel contiene una chiave API, che funziona con l'API REST, il pacchetto npm billionverify-mcp e la skill dell'agente.
Aggiungi BillionVerify in Vercel Connect
Apri vercel.com/connect/billionverify, incolla la tua chiave API di BillionVerify, collega il tuo progetto e verifica la prossima registrazione o il prossimo lead prima che raggiunga la tua lista.