BillionVerify Kini Menjadi Konektor Vercel Connect

BillionVerify kini terdaftar di Vercel Connect. Buka vercel.com/connect/billionverify, atau cari "BillionVerify" di bagian Connect pada dasbor Vercel Anda, lalu tambahkan kunci BillionVerify API Anda ke sebuah konektor sekali saja. Setelah itu, setiap proyek Vercel yang Anda tautkan dapat memverifikasi alamat email saat runtime: kode Anda meminta kunci tersebut kepada Vercel Connect saat diperlukan, sehingga kunci tidak pernah tersimpan dalam variabel lingkungan atau kode sumber Anda.

Konektor BillionVerify Vercel menggunakan REST API, kredit, dan riwayat verifikasi yang sama seperti yang sudah Anda gunakan. Konektor ini merupakan padanan Vercel dari konektor Claude kami: pengguna Claude memverifikasi alamat dengan bertanya di chat, sementara developer Vercel memverifikasinya melalui formulir pendaftaran, pekerjaan latar belakang, dan agen AI yang mereka deploy di Vercel.

Mengapa menggunakan Vercel Connect untuk verifikasi email

Sebagian besar tim menambahkan verifikasi email dengan menempelkan API key ke variabel lingkungan setiap project. Cara ini berfungsi sampai Anda memiliki beberapa project, lingkungan pratinjau dan produksi, serta beberapa orang yang dapat membaca variabel tersebut. Setelah itu, merotasi key berarti mencari setiap salinannya.

Vercel Connect memindahkan key ke satu tempat di tingkat tim:

• Satu key, banyak project. Anda menyimpan API key BillionVerify di connector sekali saja. Setiap project yang Anda tautkan ke connector tersebut dapat menggunakannya, dan tidak ada satu pun yang menyimpan salinannya sendiri.
• Anda memilih siapa yang dapat menggunakannya. Connector hanya menjawab permintaan token dari project dan lingkungan yang Anda tautkan ke connector tersebut. Lihat tautan project di dokumentasi Vercel.
• Permintaan dicatat. Setiap connector memiliki tab Observabilitas yang mencatat permintaan token berdasarkan project, lingkungan, dan subjek.
• Rotasi hanya memerlukan satu perubahan. Buat key baru di BillionVerify, perbarui connector, dan setiap project tertaut akan menggunakannya.

Untuk agen AI, hal ini lebih penting dibandingkan aplikasi web klasik. Agen yang dapat memanggil tools seharusnya tidak dapat membaca kredensial mentah dari lingkungannya. Dengan Vercel Connect, kode agen meminta key saat memanggil BillionVerify, dan key tersebut tidak pernah menjadi bagian dari deployment.

Cara menemukan BillionVerify di Vercel Connect

Ada dua cara untuk mengakses konektor Vercel BillionVerify. Keduanya mengarah ke pengaturan yang sama.

Dari direktori Vercel Connect publik

Buka vercel.com/connect/browse dan ketik "billionverify" di kotak pencarian, atau langsung buka vercel.com/connect/billionverify. Daftar tersebut menampilkan metode koneksi (Kunci API) dan deskripsi singkat: memverifikasi alamat email satu per satu, dalam batch, atau melalui unggahan file massal.

Dari dasbor Vercel Anda

Jika Anda sudah masuk ke Vercel, buka Connect di dasbor tim Anda, ketik "billionverify" di kolom pencarian, lalu pilih BillionVerify dari Semua Konektor. Ini adalah cara tercepat saat Anda menyiapkan proyek yang sudah Anda deploy di Vercel.

Cara menambahkan konektor BillionVerify ke proyek Vercel Anda

Konektor ini menggunakan kunci API dari akun BillionVerify Anda. Jika Anda belum memiliki akun, daftar di billionverify.com terlebih dahulu; paket gratis memberi Anda 20 kredit setiap hari saat menggunakan akun, hingga 600 kredit per bulan, tanpa kartu kredit.

Langkah 1: Buat kunci API BillionVerify

Masuk dan buka halaman Kunci API di dasbor BillionVerify Anda. Buat kunci dan beri nama yang menunjukkan tempat penggunaannya, misalnya vercel-production, agar Anda dapat mengenalinya nanti di riwayat penggunaan.

Langkah 2: Konfigurasikan koneksi di Vercel

Klik BillionVerify di Vercel Connect untuk membuka Tambahkan Koneksi, lalu isi langkah Konfigurasikan:

• Nama. Vercel menyarankan nama acak seperti chestnut-fence. Ganti dengan nama yang mudah Anda kenali, seperti billionverify-prod. Bersama dengan layanan, nama ini membentuk ID konektor yang digunakan kode Anda: billionverify/billionverify-prod.
• UID (opsional). Biarkan kosong dan Vercel akan membuatnya dari nama layanan dan konektor.
• Kunci API Bersama atau Kunci API Per-Pengguna. Kunci Bersama menyimpan satu kunci pada konektor untuk semua pengguna aplikasi Anda. Kunci Per-Pengguna meminta setiap pengguna memberikan kunci BillionVerify mereka sendiri saat melakukan otorisasi. Bagian berikut menjelaskan kapan harus memilih masing-masing opsi.
• Kunci. Tempelkan kunci API dari langkah 1.
• Cakupan dan Kedaluwarsa (opsional). Tetapkan tanggal kedaluwarsa jika tim Anda mengganti kunci sesuai jadwal; jika tidak, biarkan pengaturan default.

Klik Buat Konektor untuk menyimpannya.

Langkah 3: Tautkan proyek yang boleh menggunakannya

Tautkan konektor ke proyek dan lingkungan Vercel yang diizinkan untuk memverifikasi email, misalnya lingkungan production dan preview aplikasi web Anda, tetapi bukan alat internal yang tidak memiliki alasan untuk memanggil BillionVerify. Proyek yang tidak ditautkan akan menerima kesalahan, bukan kunci.

Lebih suka terminal? Gunakan Vercel CLI

Pengaturan yang sama dapat dilakukan melalui Vercel CLI. Jalankan dari proyek yang akan menggunakan konektor:

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

vercel env pull mengunduh token pengembangan berumur pendek ke dalam .env.local, sehingga getToken juga berfungsi saat Anda menjalankan aplikasi di komputer sendiri. File tersebut menyimpan token Vercel, bukan kunci BillionVerify.

API key bersama atau API key per pengguna?

Pilih Shared API Keys saat produk Anda sendiri yang melakukan verifikasi: formulir pendaftaran yang menolak alamat sekali pakai, tugas malam yang membersihkan prospek baru, atau agen internal yang digunakan tim Anda. Semua verifikasi menggunakan akun BillionVerify dan kredit Anda.

Pilih Per-User API Keys saat Anda membuat produk untuk orang lain yang memiliki akun BillionVerify sendiri, misalnya add-on CRM, alat cold email, atau template agen. Setiap pengguna membawa key mereka sendiri saat otorisasi, sehingga verifikasi mereka menggunakan kredit sendiri dan muncul dalam riwayat BillionVerify mereka sendiri.

Panggil BillionVerify dari kode Anda

Instal Vercel Connect SDK di proyek Anda:

npm install @vercel/connect

Kemudian minta kunci dengan getToken dan kirimkan dalam header BV-API-KEY. Berikut adalah route handler Next.js yang memeriksa satu alamat dengan pemeriksaan SMTP secara langsung:

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

Objek data dalam respons mencakup status (valid, invalid, catchall, role, disposable, atau unknown), is_deliverable, is_disposable, is_catchall, is_role, dan sebuah reason. Formulir pendaftaran biasanya memblokir alamat invalid dan disposable, menerima alamat valid, serta mengizinkan alamat catch-all dan unknown dengan sebuah penanda agar Anda dapat memantau perilakunya.

SDK menyimpan kunci dalam memori dan menggunakannya kembali, sehingga tidak memanggil Vercel Connect lagi untuk setiap alamat yang Anda verifikasi.

Verifikasi batch atau seluruh file

Kunci yang sama dapat digunakan untuk setiap endpoint BillionVerify:

• POST /v1/verify/single memeriksa satu alamat, seperti di atas.
• POST /v1/verify/bulk memeriksa hingga 50 alamat dalam satu permintaan. Kirim {"emails": [...], "check_smtp": true}.
• POST /v1/verify/file mengunggah CSV untuk pekerjaan latar belakang. Lakukan polling pada GET /v1/verify/file/{id} dan unduh hasilnya dari GET /v1/verify/file/{id}/results.

Pola umum di Vercel adalah cron job yang mengumpulkan lead baru hari itu, mengirimkannya ke /v1/verify/bulk dalam kelompok berisi 50, lalu menulis statusnya kembali ke database Anda. Detail permintaan dan respons tersedia dalam referensi API.

Kunci per pengguna dalam kode

Dengan Per-User API Keys, teruskan ID pengguna yang telah masuk sebagai subject:

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

Jika pengguna tersebut belum memberikan kunci, SDK akan menampilkan UserAuthorizationRequiredError. Tangkap error tersebut dan tampilkan langkah "Hubungkan akun BillionVerify Anda" di UI Anda. Kelas error lainnya tercantum dalam dokumentasi token Vercel.

Gunakan BillionVerify dalam agen AI di Vercel

Jika Anda membuat agen di Vercel, berikan alat "verifikasi email" yang kodenya memanggil getToken lalu BillionVerify, persis seperti route handler di atas. Model menentukan kapan harus memverifikasi alamat; kuncinya tetap berada di Vercel Connect dan tidak pernah muncul dalam prompt, output alat, atau lingkungan agen.

API key yang sama juga mendukung integrasi agen kami lainnya:

• Server MCP. BILLIONVERIFY_API_KEY=your-key npx billionverify-mcp menjalankan server MCP kami secara lokal dengan 11 alat yang sama seperti versi hosted. Penyiapan untuk setiap klien tersedia di panduan MCP.
• Skill agen. Agen coding dapat memasang skill BillionVerify dengan npx skills add BillionVerify/billionverify-skill. Pelajari selengkapnya di Skill Agen.

Cara kerja kredit

Memverifikasi melalui konektor Vercel dikenai biaya yang sama seperti memverifikasi di tempat lain dalam BillionVerify: satu kredit untuk hasil pasti. Alamat yang tidak diketahui, sekali pakai, dan berformat buruk tidak dikenai biaya, begitu juga pemeriksaan ulang alamat yang sama dalam 24 jam. Alamat catch-all dilaporkan sebagai catch-all, bukan dihitung sebagai valid, sehingga Anda dapat menentukan cara menanganinya.

Vercel menagih permintaan tokennya sendiri secara terpisah, sesuai dengan harga Vercel Connect. Karena SDK menyimpan kunci di cache, satu permintaan token biasanya mencakup banyak verifikasi.

BillionVerify juga tersedia di Claude

Awal bulan ini, BillionVerify terdaftar di direktori konektor Claude. Jika Anda atau tim Anda bekerja di Claude, Anda dapat menghubungkan BillionVerify di sana dengan akun Anda, tanpa memerlukan kunci API, lalu meminta Claude memverifikasi alamat atau membersihkan daftar hingga 50 alamat langsung dalam chat. Baca BillionVerify Kini Ada di Direktori Konektor Claude untuk mengetahui cara menyiapkannya.

Claude digunakan untuk memeriksa alamat saat Anda bekerja. Konektor Vercel digunakan untuk pemeriksaan yang dijalankan oleh aplikasi dan agen Anda sendiri secara mandiri.

FAQ

Apa itu konektor BillionVerify Vercel?

Konektor ini adalah listing BillionVerify di Vercel Connect. Anda menyimpan kunci API BillionVerify di konektor satu kali, lalu proyek Vercel yang ditautkan ke konektor tersebut dapat meminta kunci itu saat runtime untuk memanggil API verifikasi email BillionVerify.

Apakah saya masih perlu memasukkan kunci API ke variabel lingkungan?

Tidak. Kunci tersebut tersimpan di konektor. Kode Anda mendapatkannya dengan getToken dari @vercel/connect, yang secara otomatis mengautentikasi deployment Anda ke Vercel Connect.

Apakah verifikasi email melalui Vercel dikenakan biaya tambahan?

Tidak dari pihak BillionVerify. Verifikasi menggunakan kredit di akun BillionVerify Anda dengan tarif normal. Vercel mengenakan biaya untuk permintaan tokennya sendiri sesuai harga Vercel Connect.

Haruskah saya memilih Shared API Keys atau Per-User API Keys?

Pilih Shared API Keys jika aplikasi Anda sendiri memverifikasi alamat email menggunakan akun Anda. Pilih Per-User API Keys jika Anda membuat produk yang penggunanya masing-masing memiliki akun BillionVerify sendiri dan harus membayar verifikasi mereka sendiri.

Dapatkah saya menggunakan konektor di luar deployment Vercel?

Ya. Untuk pengembangan lokal, vercel env pull memberi Anda token pengembangan. Di lingkungan lain, seperti CI eksternal, Anda dapat meneruskan token akses Vercel ke getToken dengan opsi vercelToken. Anda juga dapat memanggil API BillionVerify secara langsung dengan kunci Anda, tanpa Vercel Connect.

Apakah konektor Vercel berfungsi dengan server MCP yang di-host?

Server MCP yang di-host di mcp.billionverify.com mengautentikasi Anda dengan OAuth, dan itulah yang digunakan konektor Claude. Konektor Vercel menyimpan kunci API, yang berfungsi dengan REST API, paket npm billionverify-mcp, dan keterampilan agen.

Tambahkan BillionVerify di Vercel Connect

Buka vercel.com/connect/billionverify, tempel API key BillionVerify Anda, tautkan project Anda, dan verifikasi pendaftaran atau prospek berikutnya sebelum masuk ke daftar Anda.