BillionVerify ahora aparece en Vercel Connect. Abre vercel.com/connect/billionverify o busca «BillionVerify» en Connect dentro de tu panel de Vercel y añade tu clave de BillionVerify API a un conector una sola vez. Después, cualquier proyecto de Vercel que vincules podrá verificar direcciones de correo electrónico en tiempo de ejecución: tu código solicita la clave a Vercel Connect cuando la necesita, por lo que la clave nunca se almacena en una variable de entorno ni en tu código fuente.
El conector de BillionVerify para Vercel funciona con la misma REST API, los mismos créditos y el mismo historial de verificación que ya utilizas. Es la versión para Vercel de nuestro conector de Claude: los usuarios de Claude verifican direcciones solicitándolo en el chat, y los desarrolladores de Vercel las verifican desde formularios de registro, tareas en segundo plano y agentes de IA que implementan en Vercel.
Por qué usar Vercel Connect para la verificación de correo electrónico
La mayoría de los equipos añade la verificación de correo electrónico pegando una clave API en las variables de entorno de cada proyecto. Esto funciona hasta que tienes varios proyectos, entornos de vista previa y producción, y varias personas que pueden leer esas variables. Rotar la clave entonces implica encontrar cada copia.
Vercel Connect mueve la clave a un único lugar a nivel del equipo:
- Una clave, muchos proyectos. Almacenas tu clave API de BillionVerify en el conector una sola vez. Todos los proyectos que vincules a él pueden usarla, y ninguno conserva su propia copia.
- Tú eliges quién puede usarla. Un conector solo responde a solicitudes de tokens de los proyectos y entornos que vincules a él. Consulta los vínculos de proyectos en la documentación de Vercel.
- Las solicitudes se registran. Cada conector tiene una pestaña de Observabilidad que registra las solicitudes de tokens por proyecto, entorno y sujeto.
- La rotación requiere una sola edición. Crea una nueva clave en BillionVerify, actualiza el conector y todos los proyectos vinculados la adoptarán.
Para los agentes de IA, esto es más importante que en una aplicación web clásica. Un agente que puede llamar a herramientas no debería poder leer credenciales sin procesar desde su entorno. Con Vercel Connect, el código del agente solicita la clave en el momento en que llama a BillionVerify, y la clave nunca forma parte del despliegue.
Cómo encontrar BillionVerify en Vercel Connect
Hay dos formas de acceder al conector de BillionVerify para Vercel. Ambas llevan a la misma configuración.
Desde el directorio público de Vercel Connect
Abre vercel.com/connect/browse y escribe "billionverify" en el cuadro de búsqueda, o ve directamente a vercel.com/connect/billionverify. El listado muestra el método de conexión (API Key) y una breve descripción: verificar direcciones de correo electrónico una por una, en lotes o mediante la carga masiva de archivos.
Desde tu panel de control de Vercel
Si ya has iniciado sesión en Vercel, abre Connect en el panel de control de tu equipo, escribe "billionverify" en el campo de búsqueda y selecciona BillionVerify en Todos los conectores. Esta es la ruta más rápida cuando estás configurando un proyecto que ya implementas en Vercel.
Cómo añadir el conector de BillionVerify a tu proyecto de Vercel
El conector utiliza una clave API de tu cuenta de BillionVerify. Si aún no tienes una cuenta, regístrate en billionverify.com primero; el plan gratuito te proporciona 20 créditos por cada día que uses tu cuenta, hasta 600 al mes, sin tarjeta de crédito.
Paso 1: Crea una clave API de BillionVerify
Inicia sesión y abre la página de claves API en tu panel de BillionVerify. Crea una clave y asígnale un nombre que indique dónde se utiliza, por ejemplo, "vercel-production", para que puedas reconocerla más adelante en tu historial de uso.
Paso 2: Configura la conexión en Vercel
Haz clic en BillionVerify en Vercel Connect para abrir Add Connection y, a continuación, completa el paso Configure:
- Name. Vercel sugiere un nombre aleatorio como
chestnut-fence. Sustitúyelo por algo que puedas reconocer, comobillionverify-prod. Junto con el servicio, forma el ID del conector que utiliza tu código:billionverify/billionverify-prod. - UID (optional). Déjalo vacío y Vercel lo generará a partir del servicio y el nombre del conector.
- Shared API Keys or Per-User API Keys. Shared almacena una clave en el conector para todos los usuarios de tu aplicación. Per-User solicita a cada uno de tus usuarios que proporcione su propia clave de BillionVerify cuando autorice. La siguiente sección explica cuándo elegir cada opción.
- Key. Pega la clave API del paso 1.
- Scope and Expiration (optional). Establece una fecha de expiración si tu equipo rota las claves según un calendario; de lo contrario, deja los valores predeterminados.
Haz clic en Create Connector para guardarlo.
Paso 3: Vincula los proyectos que pueden utilizarlo
Vincula el conector a los proyectos y entornos de Vercel que deban tener permiso para verificar correos electrónicos, por ejemplo, los entornos de producción y vista previa de tu aplicación web, pero no una herramienta interna que no tenga motivos para llamar a BillionVerify. Un proyecto que no esté vinculado recibe un error en lugar de una clave.
¿Prefieres la terminal? Usa Vercel CLI
La misma configuración funciona desde Vercel CLI. Ejecútala desde el proyecto que utilizará el conector:
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull descarga un token de desarrollo de corta duración en .env.local, por lo que getToken también funciona cuando ejecutas la aplicación en tu propio equipo. Ese archivo contiene un token de Vercel, no tu clave de BillionVerify.
¿Claves de API compartidas o claves de API por usuario?
Elige Claves de API compartidas cuando tu propio producto realiza la verificación: un formulario de registro que rechaza direcciones desechables, un proceso nocturno que limpia nuevos contactos o un agente interno que utiliza tu equipo. Todas las verificaciones utilizan tu cuenta de BillionVerify y tus créditos.
Elige Claves de API por usuario cuando creas un producto para otras personas que tienen sus propias cuentas de BillionVerify, por ejemplo, un complemento de CRM, una herramienta de correo electrónico en frío o una plantilla de agente. Cada usuario aporta su propia clave durante la autorización, por lo que sus verificaciones utilizan sus propios créditos y aparecen en su propio historial de BillionVerify.
Llama a BillionVerify desde tu código
Instala el SDK de Vercel Connect en tu proyecto:
npm install @vercel/connect
Luego solicita la clave con getToken y envíala en el encabezado BV-API-KEY. Este es un controlador de rutas de Next.js que comprueba una dirección con una verificación SMTP en tiempo real:
// 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);
}
El objeto data de la respuesta incluye status (válido, no válido, catchall, rol, desechable o desconocido), is_deliverable, is_disposable, is_catchall, is_role y un reason. Un formulario de registro normalmente bloquea las direcciones no válidas y desechables, acepta las válidas y permite pasar las direcciones catch-all y desconocidas con una marca para que puedas observar cómo se comportan.
El SDK almacena la clave en memoria y la reutiliza, por lo que no vuelve a llamar a Vercel Connect por cada dirección que verificas.
Verifica un lote o un archivo completo
La misma clave funciona para cada endpoint de BillionVerify:
POST /v1/verify/singlecomprueba una dirección, como se indicó anteriormente.POST /v1/verify/bulkcomprueba hasta 50 direcciones en una sola solicitud. Envía{"emails": [...], "check_smtp": true}.POST /v1/verify/filecarga un CSV para un trabajo en segundo plano. Consulta periódicamenteGET /v1/verify/file/{id}y descarga los resultados desdeGET /v1/verify/file/{id}/results.
Un patrón común en Vercel es un trabajo cron que recopila los nuevos clientes potenciales del día, los envía a /v1/verify/bulk en grupos de 50 y escribe el estado en tu base de datos. Los detalles de la solicitud y la respuesta están en la referencia de la API.
Claves por usuario en el código
Con las claves de API por usuario, pasa el ID del usuario que ha iniciado sesión como asunto:
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Si ese usuario aún no ha proporcionado una clave, el SDK lanza UserAuthorizationRequiredError. Captúralo y muestra un paso de «Conecta tu cuenta de BillionVerify» en tu interfaz. Las demás clases de error aparecen en la documentación de tokens de Vercel.
Usa BillionVerify en agentes de IA en Vercel
Si creas un agente en Vercel, dale una herramienta de «verificar correo electrónico» cuyo código llame a getToken y luego a BillionVerify, exactamente igual que el controlador de rutas anterior. El modelo decide cuándo verificar una dirección; la clave permanece en Vercel Connect y nunca aparece en el prompt, la salida de la herramienta ni el entorno del agente.
La misma clave de API también impulsa nuestras otras integraciones de agentes:
- Servidor MCP.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpejecuta nuestro servidor MCP localmente con las mismas 11 herramientas que la versión alojada. La configuración para cada cliente está en la guía de MCP. - Habilidad para agentes. Los agentes de programación pueden instalar la habilidad de BillionVerify con
npx skills add BillionVerify/billionverify-skill. Más información en Habilidades para agentes.
Cómo funcionan los créditos
Verificar mediante el conector de Vercel cuesta lo mismo que verificar en cualquier otro lugar de BillionVerify: un crédito para obtener un resultado definitivo. Las direcciones desconocidas, desechables y con un formato incorrecto son gratuitas, al igual que volver a comprobar la misma dirección en un plazo de 24 horas. Las direcciones catch-all se indican como catch-all y no se cuentan como válidas, por lo que tú decides cómo tratarlas.
Vercel factura sus propias solicitudes de tokens por separado, según los precios de Vercel Connect. Como el SDK almacena en caché la clave, una solicitud de token suele cubrir muchas verificaciones.
BillionVerify también está en Claude
A principios de este mes, BillionVerify apareció en el directorio de conectores de Claude. Si tú o tu equipo trabajan en Claude, pueden conectar BillionVerify allí con su cuenta, sin necesidad de una clave de API, y pedirle a Claude que verifique una dirección o limpie una lista de hasta 50 elementos en el chat. Lee BillionVerify ya está en el directorio de conectores de Claude para consultar la configuración.
Claude sirve para comprobar direcciones mientras trabajas. El conector de Vercel es para las comprobaciones que tus propias aplicaciones y agentes ejecutan por su cuenta.
Preguntas frecuentes
¿Qué es el conector de BillionVerify para Vercel?
Es la integración de BillionVerify en Vercel Connect. Almacenas tu clave API de BillionVerify en un conector, y los proyectos de Vercel que vincules a él pueden solicitar esa clave en tiempo de ejecución para llamar a la API de verificación de correo electrónico de BillionVerify.
¿Todavía tengo que poner mi clave API en las variables de entorno?
No. La clave vive en el conector. Tu código la obtiene con getToken de @vercel/connect, que autentica automáticamente tu implementación en Vercel Connect.
¿Verificar correos electrónicos a través de Vercel tiene un coste adicional?
No por parte de BillionVerify. Las verificaciones utilizan los créditos de tu cuenta de BillionVerify a la tarifa normal. Vercel cobra por sus propias solicitudes de tokens según sus precios de Vercel Connect.
¿Debo elegir claves API compartidas o claves API por usuario?
Claves API compartidas cuando tu propia aplicación verifica direcciones con tu cuenta. Claves API por usuario cuando creas un producto cuyos usuarios tienen cada uno su propia cuenta de BillionVerify y deben pagar sus propias verificaciones.
¿Puedo usar el conector fuera de una implementación de Vercel?
Sí. Para el desarrollo local, vercel env pull te proporciona un token de desarrollo. En otros entornos, como CI externo, puedes pasar un token de acceso de Vercel a getToken con la opción vercelToken. También puedes llamar directamente a la API de BillionVerify con tu clave, sin Vercel Connect.
¿El conector de Vercel funciona con el servidor MCP alojado?
El servidor MCP alojado en mcp.billionverify.com inicia sesión contigo mediante OAuth, que es lo que utiliza el conector de Claude. El conector de Vercel contiene una clave API, que funciona con la API REST, el paquete npm billionverify-mcp y la habilidad del agente.
Añade BillionVerify en Vercel Connect
Abre vercel.com/connect/billionverify, pega tu clave de API de BillionVerify, vincula tu proyecto y verifica el próximo registro o prospecto antes de que llegue a tu lista.