BillionVerify est désormais disponible dans Vercel Connect. Ouvrez vercel.com/connect/billionverify, ou recherchez « BillionVerify » sous Connect dans votre tableau de bord Vercel, puis ajoutez une fois votre clé API BillionVerify à un connecteur. Ensuite, tout projet Vercel que vous liez peut effectuer la vérification d'adresses email à l'exécution : votre code demande la clé à Vercel Connect lorsqu'il en a besoin, afin qu'elle ne soit jamais stockée dans une variable d'environnement ni dans votre code source.
Le connecteur Vercel BillionVerify fonctionne avec la même REST API, les mêmes crédits et le même historique de vérification que ceux que vous utilisez déjà. Il constitue l'équivalent Vercel de notre connecteur Claude : les utilisateurs de Claude vérifient les adresses en les demandant dans le chat, tandis que les développeurs Vercel les vérifient depuis les formulaires d'inscription, les tâches en arrière-plan et les agents d'IA qu'ils déploient sur Vercel.
Pourquoi utiliser Vercel Connect pour la vérification d'email
La plupart des équipes ajoutent la vérification d'email en collant une clé API dans les variables d'environnement de chaque projet. Cela fonctionne jusqu'à ce que vous ayez plusieurs projets, des environnements de prévisualisation et de production, ainsi que quelques personnes capables de lire ces variables. La rotation de la clé implique alors de retrouver chaque copie.
Vercel Connect regroupe la clé en un seul endroit au niveau de l'équipe :
- Une clé, plusieurs projets. Vous stockez votre clé API BillionVerify sur le connecteur une seule fois. Chaque projet que vous lui associez peut l'utiliser, et aucun ne conserve sa propre copie.
- Vous choisissez qui peut l'utiliser. Un connecteur ne répond qu'aux demandes de jetons provenant des projets et des environnements que vous lui associez. Consultez les liaisons de projets dans la documentation de Vercel.
- Les demandes sont journalisées. Chaque connecteur dispose d'un onglet Observabilité qui enregistre les demandes de jetons par projet, environnement et sujet.
- La rotation se fait en une seule modification. Créez une nouvelle clé dans BillionVerify, mettez à jour le connecteur, et chaque projet associé la récupère.
Pour les agents IA, cela est encore plus important que pour une application web classique. Un agent capable d'appeler des outils ne devrait pas pouvoir lire les identifiants bruts depuis son environnement. Avec Vercel Connect, le code de l'agent demande la clé au moment où il appelle BillionVerify, et la clé ne fait jamais partie du déploiement.
Comment trouver BillionVerify dans Vercel Connect
Il existe deux façons d'accéder au connecteur Vercel de BillionVerify. Les deux mènent à la même configuration.
Depuis l'annuaire public Vercel Connect
Ouvrez vercel.com/connect/browse et saisissez « billionverify » dans le champ de recherche, ou accédez directement à vercel.com/connect/billionverify. La fiche indique la méthode de connexion (clé API) et une courte description : vérifier des adresses e-mail une par une, par lots ou en important un fichier en masse.
Depuis votre tableau de bord Vercel
Si vous êtes déjà connecté à Vercel, ouvrez Connect dans le tableau de bord de votre équipe, saisissez « billionverify » dans le champ de recherche et sélectionnez BillionVerify dans Tous les connecteurs. C'est le moyen le plus rapide lorsque vous configurez un projet que vous déployez déjà sur Vercel.
Comment ajouter le connecteur BillionVerify à votre projet Vercel
Le connecteur utilise une clé API de votre compte BillionVerify. Si vous n'avez pas encore de compte, inscrivez-vous sur billionverify.com d'abord ; le forfait gratuit vous donne 20 crédits chaque jour où vous utilisez votre compte, jusqu'à 600 par mois, sans carte bancaire.
Étape 1 : Créer une clé API BillionVerify
Connectez-vous et ouvrez la page des clés API dans votre tableau de bord BillionVerify. Créez une clé et donnez-lui un nom indiquant où elle est utilisée, par exemple « vercel-production », afin de pouvoir la reconnaître plus tard dans votre historique d'utilisation.
Étape 2 : Configurer la connexion dans Vercel
Cliquez sur BillionVerify dans Vercel Connect pour ouvrir Ajouter une connexion, puis remplissez l'étape Configurer :
- Nom. Vercel suggère un nom aléatoire tel que
chestnut-fence. Remplacez-le par un nom reconnaissable, commebillionverify-prod. Avec le service, il forme l'identifiant du connecteur utilisé par votre code :billionverify/billionverify-prod. - UID (facultatif). Laissez ce champ vide et Vercel le génère à partir du service et du nom du connecteur.
- Clés API partagées ou clés API par utilisateur. L'option Partagées stocke une clé sur le connecteur pour tous les utilisateurs de votre application. L'option Par utilisateur demande à chacun de vos utilisateurs de fournir sa propre clé BillionVerify lors de l'autorisation. La section suivante explique quand choisir l'une ou l'autre.
- Clé. Collez la clé API de l'étape 1.
- Portée et expiration (facultatif). Définissez une expiration si votre équipe renouvelle les clés selon un calendrier ; sinon, conservez les valeurs par défaut.
Cliquez sur Créer le connecteur pour l'enregistrer.
Étape 3 : Lier les projets susceptibles de l'utiliser
Liez le connecteur aux projets et environnements Vercel qui doivent être autorisés à effectuer la vérification d'email, par exemple les environnements de production et de prévisualisation de votre application web, mais pas un outil interne qui n'a aucune raison d'appeler BillionVerify. Un projet qui n'est pas lié reçoit une erreur au lieu d'une clé.
Vous préférez le terminal ? Utilisez la Vercel CLI
La même configuration fonctionne depuis la Vercel CLI. Exécutez-la depuis le projet qui utilisera le connecteur :
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull télécharge un jeton de développement à courte durée de vie dans .env.local, afin que getToken fonctionne également lorsque vous exécutez l'application sur votre propre machine. Ce fichier contient un jeton Vercel, et non votre clé BillionVerify.
Clés API partagées ou clés API par utilisateur ?
Choisissez les clés API partagées lorsque votre propre produit effectue la vérification : un formulaire d’inscription qui rejette les adresses jetables, une tâche nocturne qui nettoie les nouveaux prospects, ou un agent interne utilisé par votre équipe. Toutes les vérifications utilisent votre compte BillionVerify et vos crédits.
Choisissez les clés API par utilisateur lorsque vous créez un produit destiné à d’autres personnes qui possèdent leurs propres comptes BillionVerify, par exemple un module complémentaire de CRM, un outil d’emailing à froid ou un modèle d’agent. Chaque utilisateur fournit sa propre clé lors de l’autorisation ; ses vérifications utilisent donc ses propres crédits et apparaissent dans son propre historique BillionVerify.
Appelez BillionVerify depuis votre code
Installez le SDK Vercel Connect dans votre projet :
npm install @vercel/connect
Demandez ensuite la clé avec getToken et envoyez-la dans l'en-tête BV-API-KEY. Voici un gestionnaire de route Next.js qui vérifie une adresse avec une vérification SMTP en direct :
// 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'objet data de la réponse comprend status (valid, invalid, catchall, role, disposable ou unknown), is_deliverable, is_disposable, is_catchall, is_role ainsi qu'une reason. Un formulaire d'inscription bloque généralement les adresses invalides et jetables, accepte les adresses valides et laisse passer les adresses catch-all et inconnues avec un indicateur afin que vous puissiez observer leur comportement.
Le SDK met la clé en cache en mémoire et la réutilise ; il n'appelle donc pas Vercel Connect à nouveau pour chaque adresse que vous vérifiez.
Vérifiez un lot ou un fichier entier
La même clé fonctionne pour chaque endpoint BillionVerify :
POST /v1/verify/singlevérifie une adresse, comme indiqué ci-dessus.POST /v1/verify/bulkvérifie jusqu'à 50 adresses dans une seule requête. Envoyez{"emails": [...], "check_smtp": true}.POST /v1/verify/filetélécharge un CSV pour une tâche en arrière-plan. InterrogezGET /v1/verify/file/{id}et téléchargez les résultats depuisGET /v1/verify/file/{id}/results.
Une approche courante sur Vercel consiste à utiliser une tâche cron qui rassemble les nouveaux prospects du jour, les envoie à /v1/verify/bulk par groupes de 50, puis écrit le statut dans votre base de données. Les détails des requêtes et des réponses figurent dans la référence de l'API.
Clés par utilisateur dans le code
Avec les clés API par utilisateur, transmettez l'ID de l'utilisateur connecté comme sujet :
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Si cet utilisateur n'a pas encore fourni de clé, le SDK lève UserAuthorizationRequiredError. Interceptez cette erreur et affichez une étape « Connectez votre compte BillionVerify » dans votre interface. Les autres classes d'erreurs sont répertoriées dans la documentation des tokens de Vercel.
Utiliser BillionVerify dans les agents IA sur Vercel
Si vous créez un agent sur Vercel, donnez-lui un outil « vérifier l'email » dont le code appelle getToken, puis BillionVerify, exactement comme le gestionnaire de route ci-dessus. Le modèle décide quand vérifier une adresse ; la clé reste dans Vercel Connect et n'apparaît jamais dans le prompt, la sortie de l'outil ou l'environnement de l'agent.
La même clé API alimente également nos autres intégrations d'agents :
- Serveur MCP.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpexécute notre serveur MCP localement avec les mêmes 11 outils que la version hébergée. La configuration pour chaque client se trouve dans le guide MCP. - Compétence d'agent. Les agents de codage peuvent installer la compétence BillionVerify avec
npx skills add BillionVerify/billionverify-skill. Plus d'informations dans Compétences d'agent.
Comment fonctionnent les crédits
La vérification via le connecteur Vercel coûte le même prix qu'une vérification effectuée ailleurs dans BillionVerify : un crédit pour un résultat définitif. Les adresses inconnues, jetables et mal formatées sont gratuites, tout comme la vérification de la même adresse à nouveau dans les 24 heures. Les adresses catch-all sont signalées comme catch-all et ne sont pas comptabilisées comme valides, afin que vous décidiez comment les traiter.
Vercel facture séparément ses propres requêtes de jeton, conformément à la tarification de Vercel Connect. Comme le SDK met la clé en cache, une requête de jeton couvre généralement de nombreuses vérifications.
BillionVerify est également disponible dans Claude
Plus tôt ce mois-ci, BillionVerify a été ajouté au répertoire des connecteurs de Claude. Si vous ou votre équipe travaillez dans Claude, vous pouvez y connecter BillionVerify à votre compte sans clé API et demander à Claude de vérifier une adresse ou de nettoyer une liste de 50 adresses maximum directement dans le chat. Consultez BillionVerify est désormais dans le répertoire des connecteurs de Claude pour découvrir la procédure de configuration.
Claude sert à vérifier les adresses pendant que vous travaillez. Le connecteur Vercel est destiné aux vérifications exécutées de manière autonome par vos propres applications et agents.
FAQ
Qu'est-ce que le connecteur BillionVerify pour Vercel ?
Il s'agit de la fiche de BillionVerify dans Vercel Connect. Vous stockez votre clé API BillionVerify sur un connecteur, puis les projets Vercel que vous y associez peuvent demander cette clé au moment de l'exécution pour appeler l'API de vérification d'email BillionVerify.
Dois-je toujours placer ma clé API dans les variables d'environnement ?
Non. La clé se trouve sur le connecteur. Votre code l'obtient avec getToken depuis @vercel/connect, qui authentifie automatiquement votre déploiement auprès de Vercel Connect.
La vérification d'emails via Vercel entraîne-t-elle des frais supplémentaires ?
Pas du côté de BillionVerify. Les vérifications utilisent les crédits de votre compte BillionVerify au tarif habituel. Vercel facture ses propres demandes de jetons selon sa tarification Vercel Connect.
Dois-je choisir des clés API partagées ou des clés API par utilisateur ?
Les clés API partagées lorsque votre propre application vérifie des adresses avec votre compte. Les clés API par utilisateur lorsque vous développez un produit dont chaque utilisateur possède son propre compte BillionVerify et doit payer ses propres vérifications.
Puis-je utiliser le connecteur en dehors d'un déploiement Vercel ?
Oui. Pour le développement local, vercel env pull vous fournit un jeton de développement. Dans d'autres environnements, comme une CI externe, vous pouvez transmettre un jeton d'accès Vercel à getToken avec l'option vercelToken. Vous pouvez également appeler directement l'API BillionVerify avec votre clé, sans Vercel Connect.
Le connecteur Vercel fonctionne-t-il avec le serveur MCP hébergé ?
Le serveur MCP hébergé à mcp.billionverify.com vous connecte avec OAuth, comme le fait le connecteur Claude. Le connecteur Vercel contient une clé API, qui fonctionne avec l'API REST, le package npm billionverify-mcp et la compétence d'agent.
Ajouter BillionVerify dans Vercel Connect
Ouvrez vercel.com/connect/billionverify, collez votre clé API BillionVerify, associez votre projet et vérifiez la prochaine inscription ou le prochain prospect avant qu’il n’atteigne votre liste.