BillionVerify अब Vercel Connect Connector है

BillionVerify अब Vercel Connect में सूचीबद्ध है। vercel.com/connect/billionverify खोलें, या अपने Vercel डैशबोर्ड में Connect के अंतर्गत "BillionVerify" खोजें और अपनी BillionVerify API कुंजी को किसी कनेक्टर में एक बार जोड़ें। इसके बाद, आपके द्वारा लिंक किया गया कोई भी Vercel प्रोजेक्ट रनटाइम पर ईमेल पतों का सत्यापन कर सकता है: आवश्यकता होने पर आपका कोड कुंजी के लिए Vercel Connect से अनुरोध करता है, इसलिए कुंजी कभी भी environment variable या आपके source code में नहीं रहती।

BillionVerify Vercel कनेक्टर उसी REST API, क्रेडिट और सत्यापन इतिहास के साथ काम करता है, जिनका आप पहले से उपयोग करते हैं। यह हमारे Claude कनेक्टर का Vercel समकक्ष है: Claude उपयोगकर्ता चैट में पूछकर पतों का सत्यापन करते हैं, जबकि Vercel डेवलपर Vercel पर deploy किए गए signup forms, background jobs और AI agents से उनका सत्यापन करते हैं।

ईमेल सत्यापन के लिए Vercel Connect का उपयोग क्यों करें

अधिकांश टीमें प्रत्येक प्रोजेक्ट के environment variables में API key डालकर ईमेल सत्यापन जोड़ती हैं। यह तब तक काम करता है जब तक आपके पास कई प्रोजेक्ट, preview और production environments, और उन variables को पढ़ सकने वाले कुछ लोग न हों। इसके बाद key को बदलने का मतलब हर कॉपी ढूँढना होता है।

Vercel Connect key को team level पर एक ही स्थान पर ले जाता है:

• एक key, कई प्रोजेक्ट। आप अपनी BillionVerify API key को connector पर एक बार संग्रहीत करते हैं। इससे लिंक किया गया हर प्रोजेक्ट इसका उपयोग कर सकता है, और किसी के पास अपनी अलग कॉपी नहीं रहती।
• आप चुनते हैं कि इसका उपयोग कौन कर सकता है। Connector केवल उन प्रोजेक्ट और environments से token requests का उत्तर देता है जिन्हें आप उससे लिंक करते हैं। Vercel docs में प्रोजेक्ट लिंक देखें।
• Requests लॉग होती हैं। प्रत्येक connector में एक Observability tab होता है, जो project, environment और subject के अनुसार token requests दर्ज करता है।
• Rotation केवल एक edit है। BillionVerify में नई key बनाएँ, connector को update करें, और हर linked project उसे अपना लेगा।

AI agents के लिए यह एक classic web app की तुलना में अधिक महत्वपूर्ण है। ऐसा agent जो tools को call कर सकता है, उसे अपने environment से raw credentials पढ़ने में सक्षम नहीं होना चाहिए। Vercel Connect के साथ agent का code, BillionVerify को call करते समय key का अनुरोध करता है, और key deployment का कभी हिस्सा नहीं बनती।

Vercel Connect में BillionVerify कैसे खोजें

BillionVerify Vercel कनेक्टर तक पहुँचने के दो तरीके हैं। दोनों एक ही सेटअप पर ले जाते हैं।

सार्वजनिक Vercel Connect डायरेक्टरी से

vercel.com/connect/browse खोलें और खोज बॉक्स में "billionverify" टाइप करें, या सीधे vercel.com/connect/billionverify पर जाएँ। लिस्टिंग में कनेक्शन विधि (API कुंजी) और संक्षिप्त विवरण दिखाई देता है: ईमेल पतों को एक-एक करके, बैच में या बल्क फ़ाइल अपलोड द्वारा सत्यापित करें।

अपने Vercel डैशबोर्ड से

यदि आपने पहले से Vercel में साइन इन किया हुआ है, तो अपनी टीम के डैशबोर्ड में Connect खोलें, खोज फ़ील्ड में "billionverify" टाइप करें और सभी कनेक्टर में से BillionVerify चुनें। जब आप किसी ऐसे प्रोजेक्ट का सेटअप कर रहे हों जिसे पहले से Vercel पर डिप्लॉय किया गया है, तो यह सबसे तेज़ तरीका है।

अपने Vercel प्रोजेक्ट में BillionVerify कनेक्टर कैसे जोड़ें

कनेक्टर आपके BillionVerify खाते की API key का उपयोग करता है। यदि आपका अभी तक खाता नहीं है, तो पहले billionverify.com पर साइन अप करें; निःशुल्क प्लान में बिना क्रेडिट कार्ड के, खाते का उपयोग करने वाले हर दिन 20 क्रेडिट मिलते हैं, अधिकतम 600 प्रति माह।

चरण 1: BillionVerify API key बनाएँ

साइन इन करें और अपने BillionVerify डैशबोर्ड में API Keys पेज खोलें। एक key बनाएँ और उसका नाम उस स्थान के अनुसार रखें जहाँ इसका उपयोग होगा, जैसे "vercel-production", ताकि बाद में आप इसे अपने उपयोग इतिहास में पहचान सकें।

चरण 2: Vercel में कनेक्शन कॉन्फ़िगर करें

Vercel Connect में BillionVerify पर क्लिक करके Add Connection खोलें, फिर Configure चरण पूरा करें:

• नाम। Vercel एक यादृच्छिक नाम सुझाता है, जैसे chestnut-fence। इसे ऐसे नाम से बदलें जिसे आप पहचान सकें, जैसे billionverify-prod। सेवा के साथ मिलकर यह वह कनेक्टर ID बनाता है जिसका आपका कोड उपयोग करता है: billionverify/billionverify-prod.
• UID (वैकल्पिक)। इसे खाली छोड़ दें; Vercel इसे सेवा और कनेक्टर नाम से बना देगा।
• Shared API Keys या Per-User API Keys। Shared आपके ऐप के सभी उपयोगकर्ताओं के लिए कनेक्टर पर एक key रखता है। Per-User आपके प्रत्येक उपयोगकर्ता से authorization के समय अपनी BillionVerify key देने को कहता है। अगला अनुभाग बताता है कि किसे कब चुनना चाहिए।
• Key। चरण 1 की API key पेस्ट करें।
• Scope and Expiration (वैकल्पिक)। यदि आपकी टीम निर्धारित समय पर keys बदलती है, तो expiration सेट करें; अन्यथा डिफ़ॉल्ट मान रहने दें।

इसे सहेजने के लिए Create Connector पर क्लिक करें।

चरण 3: उन प्रोजेक्ट्स को लिंक करें जो इसका उपयोग कर सकते हैं

कनेक्टर को उन Vercel प्रोजेक्ट्स और environments से लिंक करें जिन्हें emails verify करने की अनुमति होनी चाहिए, जैसे आपके वेब ऐप का production और preview, लेकिन ऐसा आंतरिक टूल नहीं जिसे BillionVerify को कॉल करने की आवश्यकता नहीं है। जो प्रोजेक्ट लिंक नहीं है, उसे key के बजाय एक error मिलता है।

टर्मिनल पसंद है? Vercel CLI का उपयोग करें

यही सेटअप Vercel CLI से भी काम करता है। इसे उस प्रोजेक्ट से चलाएँ जो कनेक्टर का उपयोग करेगा:

vercel link
vercel connect create billionverify --name billionverify-prod
vercel env pull

vercel env pull एक अल्पकालिक development token को .env.local में डाउनलोड करता है, इसलिए getToken तब भी काम करता है जब आप ऐप अपने कंप्यूटर पर चलाते हैं। इस फ़ाइल में Vercel token होता है, आपकी BillionVerify key नहीं।

साझा API कुंजियाँ या प्रति-उपयोगकर्ता API कुंजियाँ?

साझा API कुंजियाँ चुनें जब आपका अपना उत्पाद सत्यापन करता है: ऐसा signup form जो disposable addresses को अस्वीकार करता है, ऐसा nightly job जो नए leads को साफ़ करता है, या ऐसा internal agent जिसे आपकी team इस्तेमाल करती है। सभी verifications आपके BillionVerify account और credits का उपयोग करते हैं।

प्रति-उपयोगकर्ता API कुंजियाँ चुनें जब आप ऐसे लोगों के लिए उत्पाद बनाते हैं जिनके अपने BillionVerify accounts हैं, जैसे CRM add-on, cold email tool या agent template। Authorization के दौरान प्रत्येक user अपनी key लाता है, इसलिए उनके verifications उनके अपने credits का उपयोग करते हैं और उनके अपने BillionVerify history में दिखाई देते हैं।

अपने कोड से BillionVerify को कॉल करें

अपने प्रोजेक्ट में Vercel Connect SDK इंस्टॉल करें:

npm install @vercel/connect

फिर getToken से key माँगें और उसे BV-API-KEY header में भेजें। यहाँ एक Next.js route handler है, जो live SMTP check के साथ एक address की जाँच करता है:

// 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);
}

Response के data object में status (valid, invalid, catchall, role, disposable या unknown), is_deliverable, is_disposable, is_catchall, is_role और एक reason शामिल होते हैं। Signup form आमतौर पर invalid और disposable addresses को रोकता है, valid addresses स्वीकार करता है, और catch-all तथा unknown addresses को एक flag के साथ आगे बढ़ने देता है, ताकि आप देख सकें कि वे कैसे व्यवहार करते हैं।

SDK key को memory में cache करके उसका पुनः उपयोग करता है, इसलिए आपके द्वारा verify किए जाने वाले हर address के लिए यह Vercel Connect को दोबारा कॉल नहीं करता।

किसी batch या पूरी file को verify करें

वही key हर BillionVerify endpoint के लिए काम करती है:

• POST /v1/verify/single ऊपर बताए अनुसार एक address की जाँच करता है।
• POST /v1/verify/bulk एक request में अधिकतम 50 addresses की जाँच करता है। {"emails": [...], "check_smtp": true} भेजें।
• POST /v1/verify/file background job के लिए CSV upload करता है। GET /v1/verify/file/{id} को poll करें और परिणाम GET /v1/verify/file/{id}/results से डाउनलोड करें।

Vercel पर एक सामान्य तरीका यह है कि cron job दिन के नए leads इकट्ठा करे, उन्हें 50 के समूहों में /v1/verify/bulk पर भेजे और status को आपके database में वापस लिखे। Request और response का विवरण API reference में है।

कोड में Per-User keys

Per-User API Keys के साथ, signed-in user की ID को subject के रूप में भेजें:

const apiKey = await getToken('billionverify/billionverify-prod', {
  subject: { type: 'user', id: session.user.id },
});

यदि उस user ने अभी तक key प्रदान नहीं की है, तो SDK UserAuthorizationRequiredError throw करता है। इसे catch करें और अपने UI में "अपने BillionVerify account को connect करें" चरण दिखाएँ। अन्य error classes Vercel के token documentation में सूचीबद्ध हैं।

Vercel पर AI एजेंट्स में BillionVerify का उपयोग करें

यदि आप Vercel पर कोई एजेंट बनाते हैं, तो उसे "ईमेल सत्यापित करें" टूल दें, जिसका कोड getToken और फिर BillionVerify को कॉल करे, बिल्कुल ऊपर दिए गए रूट हैंडलर की तरह। मॉडल तय करता है कि किसी पते को कब सत्यापित करना है; कुंजी Vercel Connect में रहती है और प्रॉम्प्ट, टूल आउटपुट या एजेंट के वातावरण में कभी दिखाई नहीं देती।

वही API key हमारे अन्य एजेंट इंटीग्रेशन को भी शक्ति देती है:

• MCP सर्वर। BILLIONVERIFY_API_KEY=your-key npx billionverify-mcp हमारे MCP सर्वर को स्थानीय रूप से चलाता है, जिसमें होस्टेड संस्करण के समान 11 टूल्स हैं। प्रत्येक क्लाइंट का सेटअप MCP गाइड में है।
• एजेंट स्किल। कोडिंग एजेंट npx skills add BillionVerify/billionverify-skill के साथ BillionVerify स्किल इंस्टॉल कर सकते हैं। अधिक जानकारी एजेंट स्किल्स में है।

क्रेडिट कैसे काम करते हैं

Vercel कनेक्टर के माध्यम से सत्यापन की लागत BillionVerify में कहीं और सत्यापन जैसी ही है: निश्चित परिणाम के लिए एक क्रेडिट। अज्ञात, डिस्पोज़ेबल और खराब प्रारूप वाले पते निःशुल्क हैं, और 24 घंटे के भीतर उसी पते को दोबारा जाँचना भी निःशुल्क है। कैच-ऑल पतों की रिपोर्ट कैच-ऑल के रूप में की जाती है, उन्हें मान्य नहीं गिना जाता, इसलिए आप तय करते हैं कि उनके साथ कैसे व्यवहार करना है।

Vercel अपने टोकन अनुरोधों के लिए Vercel Connect pricing के अनुसार अलग से शुल्क लेता है। SDK कुंजी को कैश करता है, इसलिए एक टोकन अनुरोध आमतौर पर कई सत्यापनों के लिए पर्याप्त होता है।

BillionVerify अब Claude में भी है

इस महीने की शुरुआत में BillionVerify को Claude की कनेक्टर डायरेक्टरी में सूचीबद्ध किया गया। अगर आप या आपकी टीम Claude में काम करते हैं, तो आप बिना API key के अपने अकाउंट से वहां BillionVerify कनेक्ट कर सकते हैं और Claude से चैट में किसी पते को सत्यापित करने या अधिकतम 50 पतों की सूची साफ़ करने के लिए कह सकते हैं। सेटअप के लिए BillionVerify अब Claude की कनेक्टर डायरेक्टरी में है पढ़ें।

Claude आपके काम करते समय पतों की जांच के लिए है। Vercel कनेक्टर उन जांचों के लिए है जिन्हें आपके अपने ऐप्स और एजेंट खुद चलाते हैं।

अक्सर पूछे जाने वाले प्रश्न

BillionVerify Vercel कनेक्टर क्या है?

यह Vercel Connect में BillionVerify की लिस्टिंग है। आप एक बार कनेक्टर पर अपनी BillionVerify API key संग्रहीत करते हैं, और इससे लिंक किए गए Vercel प्रोजेक्ट रनटाइम पर उस key का अनुरोध करके BillionVerify ईमेल सत्यापन API को कॉल कर सकते हैं।

क्या मुझे अभी भी अपनी API key को environment variables में रखना होगा?

नहीं। key कनेक्टर पर रहती है। आपका कोड @vercel/connect से getToken का उपयोग करके इसे प्राप्त करता है, जो आपकी deployment को Vercel Connect में स्वचालित रूप से प्रमाणित करता है।

क्या Vercel के माध्यम से ईमेल सत्यापित करने पर अतिरिक्त शुल्क लगता है?

BillionVerify की ओर से नहीं। सत्यापन आपके BillionVerify खाते के credits का उपयोग सामान्य दर पर करते हैं। Vercel अपने Vercel Connect pricing के तहत स्वयं के token requests के लिए शुल्क लेता है।

मुझे Shared API Keys या Per-User API Keys में से क्या चुनना चाहिए?

जब आपका अपना app आपके खाते से addresses सत्यापित करता है, तब Shared API Keys चुनें। जब आप ऐसा product बनाते हैं जिसके प्रत्येक user का अपना BillionVerify खाता हो और उसे अपने सत्यापनों का भुगतान स्वयं करना हो, तब Per-User API Keys चुनें।

क्या मैं Vercel deployment के बाहर कनेक्टर का उपयोग कर सकता हूँ?

हाँ। स्थानीय development के लिए, vercel env pull आपको एक development token देता है। अन्य environments, जैसे external CI, में आप vercelToken option के साथ getToken को Vercel access token दे सकते हैं। आप Vercel Connect के बिना भी अपनी key से सीधे BillionVerify API को कॉल कर सकते हैं।

क्या Vercel कनेक्टर hosted MCP server के साथ काम करता है?

mcp.billionverify.com पर hosted MCP server आपको OAuth से sign in कराता है, जिसका उपयोग Claude कनेक्टर करता है। Vercel कनेक्टर एक API key रखता है, जो REST API, billionverify-mcp npm package और agent skill के साथ काम करती है।

Vercel Connect में BillionVerify जोड़ें

vercel.com/connect/billionverify खोलें, अपनी BillionVerify API key पेस्ट करें, अपना प्रोजेक्ट लिंक करें और अपनी सूची में पहुँचने से पहले अगले साइनअप या लीड को सत्यापित करें।