BillionVerify staat nu vermeld in Vercel Connect. Open vercel.com/connect/billionverify of zoek naar "BillionVerify" onder Connect in je Vercel-dashboard en voeg je BillionVerify API-sleutel één keer toe aan een connector. Daarna kan elk Vercel-project dat je koppelt e-mailadressen tijdens runtime verifiëren: je code vraagt de sleutel op bij Vercel Connect wanneer dat nodig is, zodat de sleutel nooit in een omgevingsvariabele of in je broncode staat.
De BillionVerify Vercel-connector werkt met dezelfde REST API, tegoeden en verificatiegeschiedenis die je al gebruikt. Het is de Vercel-tegenhanger van onze Claude-connector: Claude-gebruikers verifiëren adressen door ernaar te vragen in de chat, en Vercel-ontwikkelaars verifiëren ze vanuit registratieformulieren, achtergrondtaken en AI-agents die ze op Vercel implementeren.
Waarom Vercel Connect gebruiken voor e-mailverificatie
De meeste teams voegen e-mailverificatie toe door een API key in de omgevingsvariabelen van elk project te plakken. Dat werkt totdat je meerdere projecten, preview- en productieomgevingen en een paar mensen hebt die deze variabelen kunnen lezen. De key roteren betekent dan dat je elke kopie moet vinden.
Vercel Connect verplaatst de key naar één plek op teamniveau:
- Eén key, veel projecten. Je slaat je BillionVerify API key één keer op de connector op. Elk project dat je eraan koppelt kan deze gebruiken, en geen enkel project bewaart een eigen kopie.
- Jij bepaalt wie deze kan gebruiken. Een connector beantwoordt alleen tokenaanvragen van de projecten en omgevingen die je eraan koppelt. Bekijk projectkoppelingen in de Vercel-documentatie.
- Aanvragen worden gelogd. Elke connector heeft een tabblad Observability waarin tokenaanvragen worden vastgelegd per project, omgeving en onderwerp.
- Rotatie vereist één bewerking. Maak een nieuwe key aan in BillionVerify, werk de connector bij en elk gekoppeld project neemt deze over.
Voor AI-agents is dit belangrijker dan voor een klassieke webapp. Een agent die tools kan aanroepen, mag geen onbewerkte inloggegevens uit zijn omgeving kunnen lezen. Met Vercel Connect vraagt de code van de agent de key op op het moment dat deze BillionVerify aanroept, en maakt de key nooit deel uit van de deployment.
Zo vind je BillionVerify in Vercel Connect
Er zijn twee manieren om de BillionVerify Vercel-connector te openen. Beide leiden naar dezelfde configuratie.
Vanuit de openbare Vercel Connect-directory
Open vercel.com/connect/browse en typ "billionverify" in het zoekvak, of ga rechtstreeks naar vercel.com/connect/billionverify. De vermelding toont de verbindingsmethode (API Key) en een korte beschrijving: e-mailadressen één voor één, in batches of via een bulkbestand uploaden en verifiëren.
Vanuit je Vercel-dashboard
Als je al bent ingelogd bij Vercel, open je Connect in het dashboard van je team, typ je "billionverify" in het zoekveld en selecteer je BillionVerify bij All Connectors. Dit is de snelste route wanneer je een project instelt dat je al op Vercel uitrolt.
Een BillionVerify-connector toevoegen aan je Vercel-project
De connector gebruikt een API key uit je BillionVerify-account. Als je nog geen account hebt, meld je eerst aan bij billionverify.com; het gratis plan geeft je elke dag dat je je account gebruikt 20 credits, tot 600 per maand, zonder creditcard.
Stap 1: Maak een BillionVerify API key aan
Meld je aan en open de pagina API Keys in je BillionVerify-dashboard. Maak een key aan en geef deze een naam die aangeeft waar de key wordt gebruikt, bijvoorbeeld "vercel-production", zodat je deze later in je gebruiksgeschiedenis kunt herkennen.
Stap 2: Configureer de verbinding in Vercel
Klik op BillionVerify in Vercel Connect om Add Connection te openen en vul vervolgens de stap Configure in:
- Name. Vercel stelt een willekeurige naam voor, zoals
chestnut-fence. Vervang deze door iets dat je herkent, zoalsbillionverify-prod. Samen met de service vormt dit de connector-ID die je code gebruikt:billionverify/billionverify-prod. - UID (optional). Laat dit leeg; Vercel genereert de UID op basis van de service- en connectornaam.
- Shared API Keys or Per-User API Keys. Shared slaat één key op de connector op voor alle gebruikers van je app. Per-User vraagt elke gebruiker om zijn of haar eigen BillionVerify-key wanneer die autorisatie verleent. In de volgende sectie lees je wanneer je welke optie kiest.
- Key. Plak de API key uit stap 1.
- Scope and Expiration (optional). Stel een vervaldatum in als je team keys volgens een schema rouleert; laat anders de standaardwaarden staan.
Klik op Create Connector om de connector op te slaan.
Stap 3: Koppel de projecten die de connector mogen gebruiken
Koppel de connector aan de Vercel-projecten en -omgevingen die e-mailverificatie mogen uitvoeren, bijvoorbeeld de productie- en previewomgeving van je webapp, maar niet aan een interne tool die geen reden heeft om BillionVerify aan te roepen. Een project dat niet is gekoppeld, krijgt een foutmelding in plaats van een key.
Liever de terminal? Gebruik de Vercel CLI
Dezelfde configuratie werkt vanuit de Vercel CLI. Voer deze uit vanuit het project dat de connector gaat gebruiken:
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull downloadt een development-token met een korte geldigheidsduur naar .env.local, zodat getToken ook werkt wanneer je de app op je eigen machine uitvoert. Dat bestand bevat een Vercel-token, niet je BillionVerify-key.
Gedeelde API-sleutels of API-sleutels per gebruiker?
Kies Gedeelde API-sleutels wanneer je eigen product de verificatie uitvoert: een registratieformulier dat wegwerpadressen weigert, een nachtelijke taak die nieuwe leads opschoont, of een interne agent die je team gebruikt. Alle verificaties gebruiken je BillionVerify-account en je credits.
Kies API-sleutels per gebruiker wanneer je een product bouwt voor andere mensen die hun eigen BillionVerify-accounts hebben, bijvoorbeeld een CRM-add-on, een tool voor koude e-mail of een agenttemplate. Elke gebruiker voert tijdens de autorisatie zijn eigen sleutel in, zodat hun verificaties hun eigen credits gebruiken en in hun eigen BillionVerify-geschiedenis verschijnen.
BillionVerify vanuit je code aanroepen
Installeer de Vercel Connect SDK in je project:
npm install @vercel/connect
Vraag vervolgens de sleutel op met getToken en stuur deze mee in de BV-API-KEY-header. Hieronder staat een Next.js-routehandler die één adres controleert met een live SMTP-controle:
// 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);
}
Het data-object in de response bevat status (valid, invalid, catchall, role, disposable of unknown), is_deliverable, is_disposable, is_catchall, is_role en een reason. Een registratieformulier blokkeert meestal ongeldige en wegwerpadressen, accepteert geldige adressen en laat catch-all- en onbekende adressen door met een markering, zodat je kunt volgen hoe ze zich gedragen.
De SDK slaat de sleutel op in het geheugen en gebruikt deze opnieuw. Daarom wordt Vercel Connect niet opnieuw aangeroepen voor elk adres dat je verifieert.
Een batch of een volledig bestand verifiëren
Dezelfde sleutel werkt voor elk BillionVerify-eindpunt:
POST /v1/verify/singlecontroleert één adres, zoals hierboven.POST /v1/verify/bulkcontroleert maximaal 50 adressen in één request. Stuur{"emails": [...], "check_smtp": true}.POST /v1/verify/fileuploadt een CSV voor een achtergrondtaak. PollGET /v1/verify/file/{id}en download de resultaten viaGET /v1/verify/file/{id}/results.
Een veelgebruikt patroon op Vercel is een cronjob die de nieuwe leads van die dag verzamelt, ze in groepen van 50 naar /v1/verify/bulk stuurt en de status terugschrijft naar je database. Details over requests en responses staan in de API-referentie.
Per-user-sleutels in code
Gebruik bij Per-User API Keys de ID van de aangemelde gebruiker als subject:
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Als die gebruiker nog geen sleutel heeft verstrekt, genereert de SDK een UserAuthorizationRequiredError. Vang deze fout op en toon een stap "Verbind je BillionVerify-account" in je UI. De andere foutklassen staan vermeld in Vercels token documentatie.
Gebruik BillionVerify in AI-agents op Vercel
Als je een agent op Vercel bouwt, geef deze dan een tool voor ‘e-mail verifiëren’ waarvan de code getToken en vervolgens BillionVerify aanroept, precies zoals de routehandler hierboven. Het model bepaalt wanneer een adres moet worden geverifieerd; de sleutel blijft in Vercel Connect en verschijnt nooit in de prompt, de uitvoer van de tool of de omgeving van de agent.
Dezelfde API-sleutel ondersteunt ook onze andere agentintegraties:
- MCP-server.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpvoert onze MCP-server lokaal uit met dezelfde 11 tools als de gehoste versie. De installatie voor elke client staat in de MCP-handleiding. - Agentvaardigheid. Programmeeragents kunnen de BillionVerify-vaardigheid installeren met
npx skills add BillionVerify/billionverify-skill. Meer informatie vind je bij Agentvaardigheden.
Hoe credits werken
Verifiëren via de Vercel-connector kost hetzelfde als overal elders in BillionVerify: één credit voor een definitief resultaat. Onbekende, wegwerp- en slecht opgemaakte adressen zijn gratis, net als het opnieuw controleren van hetzelfde adres binnen 24 uur. Catch-all-adressen worden als catch-all gerapporteerd en niet als geldig geteld, zodat jij bepaalt hoe je ermee omgaat.
Vercel brengt kosten voor de eigen tokenaanvragen afzonderlijk in rekening, volgens de prijzen van Vercel Connect. Omdat de SDK de sleutel in de cache opslaat, dekt één tokenaanvraag doorgaans veel verificaties.
BillionVerify is ook beschikbaar in Claude
Eerder deze maand werd BillionVerify opgenomen in Claude's connectorgids. Als jij of je team in Claude werkt, kun je BillionVerify daar met je account koppelen zonder API-sleutel en Claude in de chat vragen een adres te verifiëren of een lijst van maximaal 50 adressen op te schonen. Lees BillionVerify staat nu in Claude's connectorgids voor de installatie.
Claude is bedoeld om adressen te controleren terwijl je werkt. De Vercel-connector is bedoeld voor de controles die je eigen apps en agents zelfstandig uitvoeren.
Veelgestelde vragen
Wat is de BillionVerify Vercel-connector?
Het is de vermelding van BillionVerify in Vercel Connect. Je slaat je BillionVerify API-sleutel één keer op in een connector, waarna de Vercel-projecten die je eraan koppelt deze sleutel tijdens runtime kunnen opvragen om de e-mailverificatie-API van BillionVerify aan te roepen.
Moet ik mijn API-sleutel nog steeds in omgevingsvariabelen zetten?
Nee. De sleutel staat in de connector. Je code verkrijgt deze met getToken uit @vercel/connect, waarmee je implementatie automatisch wordt geverifieerd bij Vercel Connect.
Kost het extra om e-mails via Vercel te verifiëren?
Niet aan de kant van BillionVerify. Voor verificaties worden de credits in je BillionVerify-account gebruikt tegen het normale tarief. Vercel brengt kosten in rekening voor de eigen tokenaanvragen volgens de prijsstelling van Vercel Connect.
Moet ik kiezen voor gedeelde API-sleutels of API-sleutels per gebruiker?
Gedeelde API-sleutels wanneer je eigen app adressen verifieert met jouw account. API-sleutels per gebruiker wanneer je een product bouwt waarvan elke gebruiker een eigen BillionVerify-account heeft en voor zijn eigen verificaties moet betalen.
Kan ik de connector buiten een Vercel-implementatie gebruiken?
Ja. Voor lokale ontwikkeling geeft vercel env pull je een ontwikkelingstoken. In andere omgevingen, zoals externe CI, kun je met de optie vercelToken een Vercel-toegangstoken doorgeven aan getToken. Je kunt de BillionVerify API ook rechtstreeks met je sleutel aanroepen, zonder Vercel Connect.
Werkt de Vercel-connector met de gehoste MCP-server?
De gehoste MCP-server op mcp.billionverify.com meldt je aan met OAuth; dat is wat de Claude-connector gebruikt. De Vercel-connector bevat een API-sleutel, die werkt met de REST API, het npm-pakket billionverify-mcp en de agentvaardigheid.
Voeg BillionVerify toe aan Vercel Connect
Open vercel.com/connect/billionverify, plak je BillionVerify API-sleutel, koppel je project en verifieer de volgende registratie of lead voordat deze je lijst bereikt.