BillionVerify agora está listado no Vercel Connect. Abra vercel.com/connect/billionverify ou pesquise por "BillionVerify" em Connect no seu painel da Vercel e adicione sua chave API do BillionVerify a um conector uma única vez. Depois disso, qualquer projeto da Vercel que você vincular poderá verificar endereços de email em tempo de execução: seu código solicita a chave ao Vercel Connect quando precisa dela, para que a chave nunca fique em uma variável de ambiente ou no seu código-fonte.
O conector BillionVerify para Vercel funciona com a mesma REST API, os mesmos créditos e o mesmo histórico de verificações que você já usa. Ele é a contraparte na Vercel do nosso conector Claude: usuários do Claude verificam endereços fazendo perguntas no chat, enquanto desenvolvedores da Vercel os verificam em formulários de cadastro, tarefas em segundo plano e agentes de IA implantados na Vercel.
Por que usar o Vercel Connect para verificação de e-mail
A maioria das equipes adiciona a verificação de e-mail colando uma chave de API nas variáveis de ambiente de cada projeto. Isso funciona até você ter vários projetos, ambientes de preview e produção e algumas pessoas que podem ler essas variáveis. Rotacionar a chave então significa encontrar cada cópia.
O Vercel Connect move a chave para um único lugar no nível da equipe:
- Uma chave, vários projetos. Você armazena sua chave de API do BillionVerify no conector uma única vez. Todos os projetos vinculados a ele podem usá-la, e nenhum mantém sua própria cópia.
- Você escolhe quem pode usá-la. Um conector só responde a solicitações de token dos projetos e ambientes que você vincular a ele. Consulte os vínculos de projeto na documentação do Vercel.
- As solicitações são registradas. Cada conector tem uma aba de Observabilidade que registra as solicitações de token por projeto, ambiente e assunto.
- A rotação exige uma única edição. Crie uma nova chave no BillionVerify, atualize o conector e todos os projetos vinculados a receberão.
Para agentes de IA, isso é mais importante do que para um aplicativo web clássico. Um agente que pode chamar ferramentas não deve conseguir ler credenciais brutas do próprio ambiente. Com o Vercel Connect, o código do agente solicita a chave no momento em que chama o BillionVerify, e a chave nunca faz parte da implantação.
Como encontrar o BillionVerify no Vercel Connect
Há duas maneiras de acessar o conector do BillionVerify para Vercel. Ambas levam à mesma configuração.
Pelo diretório público do Vercel Connect
Abra vercel.com/connect/browse e digite "billionverify" na caixa de pesquisa, ou vá diretamente para vercel.com/connect/billionverify. A listagem mostra o método de conexão (API Key) e uma breve descrição: verificar endereços de email individualmente, em lotes ou por upload de arquivo em massa.
Pelo seu dashboard da Vercel
Se você já estiver conectado à Vercel, abra o Connect no dashboard da sua equipe, digite "billionverify" no campo de pesquisa e selecione BillionVerify em All Connectors. Essa é a maneira mais rápida quando você está configurando um projeto que já publica na Vercel.
Como adicionar o conector BillionVerify ao seu projeto Vercel
O conector usa uma chave API da sua conta BillionVerify. Se ainda não tiver uma conta, cadastre-se em billionverify.com primeiro; o plano gratuito oferece 20 créditos por dia em que você usa sua conta, até 600 por mês, sem cartão de crédito.
Etapa 1: Crie uma chave API BillionVerify
Entre na sua conta e abra a página de chaves API no seu painel BillionVerify. Crie uma chave e dê a ela um nome que indique onde é usada, por exemplo, "vercel-production", para que você possa reconhecê-la mais tarde no seu histórico de uso.
Etapa 2: Configure a conexão no Vercel
Clique em BillionVerify no Vercel Connect para abrir Adicionar conexão e preencha a etapa Configurar:
- Nome. O Vercel sugere um nome aleatório, como
chestnut-fence. Substitua-o por algo que você reconheça, comobillionverify-prod. Junto com o serviço, ele forma o ID do conector usado pelo seu código:billionverify/billionverify-prod. - UID (opcional). Deixe vazio e o Vercel o gerará a partir do serviço e do nome do conector.
- Chaves API compartilhadas ou chaves API por usuário. A opção Compartilhadas armazena uma chave no conector para todos os usuários do seu app. A opção Por usuário solicita que cada usuário forneça sua própria chave BillionVerify ao autorizar. A próxima seção explica quando escolher cada uma.
- Chave. Cole a chave API da etapa 1.
- Escopo e expiração (opcional). Defina uma expiração se sua equipe alterna as chaves de acordo com um cronograma; caso contrário, mantenha os padrões.
Clique em Criar conector para salvá-lo.
Etapa 3: Vincule os projetos que podem usá-lo
Vincule o conector aos projetos e ambientes Vercel que devem ter permissão para verificar e-mails, por exemplo, produção e pré-visualização do seu app web, mas não a uma ferramenta interna que não tenha motivo para chamar o BillionVerify. Um projeto que não esteja vinculado recebe um erro em vez de uma chave.
Prefere o terminal? Use a Vercel CLI
A mesma configuração funciona pela Vercel CLI. Execute-a no projeto que usará o conector:
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull baixa um token de desenvolvimento de curta duração para .env.local, então getToken também funciona quando você executa o app na sua própria máquina. Esse arquivo contém um token Vercel, não sua chave BillionVerify.
Chaves de API compartilhadas ou chaves de API por usuário?
Escolha Chaves de API compartilhadas quando seu próprio produto faz as verificações: um formulário de cadastro que rejeita endereços descartáveis, uma tarefa noturna que limpa novos leads ou um agente interno usado pela sua equipe. Todas as verificações usam sua conta BillionVerify e seus créditos.
Escolha Chaves de API por usuário quando você cria um produto para outras pessoas que têm suas próprias contas BillionVerify, por exemplo, um complemento de CRM, uma ferramenta de cold email ou um modelo de agente. Cada usuário fornece sua própria chave durante a autorização, então suas verificações usam seus próprios créditos e aparecem no próprio histórico do BillionVerify.
Chame o BillionVerify a partir do seu código
Instale o SDK Vercel Connect no seu projeto:
npm install @vercel/connect
Em seguida, solicite a chave com getToken e envie-a no cabeçalho BV-API-KEY. Veja um handler de rota do Next.js que verifica um endereço com uma verificação SMTP em tempo 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);
}
O objeto data da resposta inclui status (válido, inválido, catchall, role, descartável ou desconhecido), is_deliverable, is_disposable, is_catchall, is_role e um reason. Um formulário de cadastro geralmente bloqueia endereços inválidos e descartáveis, aceita os válidos e permite a passagem de endereços catch-all e desconhecidos com uma sinalização, para que você possa acompanhar seu comportamento.
O SDK armazena a chave em cache na memória e a reutiliza, portanto não chama o Vercel Connect novamente para cada endereço verificado.
Verifique um lote ou um arquivo inteiro
A mesma chave funciona para todos os endpoints do BillionVerify:
POST /v1/verify/singleverifica um endereço, como mostrado acima.POST /v1/verify/bulkverifica até 50 endereços em uma única solicitação. Envie{"emails": [...], "check_smtp": true}.POST /v1/verify/fileenvia um CSV para um job em segundo plano. ConsulteGET /v1/verify/file/{id}e baixe os resultados deGET /v1/verify/file/{id}/results.
Um padrão comum na Vercel é um job cron que coleta os novos leads do dia, envia-os para /v1/verify/bulk em grupos de 50 e grava o status de volta no seu banco de dados. Os detalhes das solicitações e respostas estão na referência da API.
Chaves por usuário no código
Com as Per-User API Keys, passe o ID do usuário conectado como subject:
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
Se esse usuário ainda não tiver fornecido uma chave, o SDK gera UserAuthorizationRequiredError. Capture o erro e mostre uma etapa "Conecte sua conta do BillionVerify" na sua interface. As outras classes de erro estão listadas na documentação de tokens da Vercel.
Use o BillionVerify em agentes de IA na Vercel
Se você criar um agente na Vercel, dê a ele uma ferramenta de “verificar e-mail” cujo código chame getToken e, em seguida, o BillionVerify, exatamente como o manipulador de rota acima. O modelo decide quando verificar um endereço; a chave permanece no Vercel Connect e nunca aparece no prompt, na saída da ferramenta ou no ambiente do agente.
A mesma chave de API também alimenta nossas outras integrações de agentes:
- Servidor MCP.
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpexecuta nosso servidor MCP localmente com as mesmas 11 ferramentas da versão hospedada. A configuração para cada cliente está no guia do MCP. - Skill de agente. Agentes de programação podem instalar a skill do BillionVerify com
npx skills add BillionVerify/billionverify-skill. Saiba mais em Skills de agentes.
Como funcionam os créditos
Verificar por meio do conector da Vercel custa o mesmo que verificar em qualquer outro lugar no BillionVerify: um crédito para um resultado definitivo. Endereços desconhecidos, descartáveis e mal formatados são gratuitos, assim como verificar o mesmo endereço novamente dentro de 24 horas. Endereços catch-all são reportados como catch-all, não contabilizados como válidos, para que você decida como tratá-los.
A Vercel cobra separadamente pelas próprias solicitações de token, de acordo com os preços do Vercel Connect. Como o SDK armazena a chave em cache, uma solicitação de token geralmente cobre muitas verificações.
BillionVerify também está no Claude
No início deste mês, BillionVerify foi listado no diretório de conectores do Claude. Se você ou sua equipe trabalham no Claude, podem conectar o BillionVerify à sua conta, sem precisar de uma chave de API, e pedir ao Claude para verificar um endereço ou limpar uma lista de até 50 itens no chat. Leia BillionVerify agora está no diretório de conectores do Claude para configurar.
O Claude serve para verificar endereços enquanto você trabalha. O conector do Vercel serve para as verificações que seus próprios aplicativos e agentes executam por conta própria.
Perguntas frequentes
O que é o conector BillionVerify para Vercel?
É a listagem da BillionVerify no Vercel Connect. Você armazena sua chave API da BillionVerify em um conector, e os projetos da Vercel vinculados a ele podem solicitar essa chave em tempo de execução para chamar a API de verificação de e-mails da BillionVerify.
Ainda preciso colocar minha chave API nas variáveis de ambiente?
Não. A chave fica no conector. Seu código a obtém com getToken de @vercel/connect, que autentica automaticamente sua implantação no Vercel Connect.
Verificar e-mails pela Vercel custa algo a mais?
Não do lado da BillionVerify. As verificações usam os créditos da sua conta BillionVerify à taxa normal. A Vercel cobra por suas próprias solicitações de token de acordo com os preços do Vercel Connect.
Devo escolher Chaves API compartilhadas ou Chaves API por usuário?
Chaves API compartilhadas quando seu próprio aplicativo verifica endereços com sua conta. Chaves API por usuário quando você cria um produto cujos usuários têm suas próprias contas BillionVerify e devem pagar por suas próprias verificações.
Posso usar o conector fora de uma implantação da Vercel?
Sim. Para desenvolvimento local, vercel env pull fornece um token de desenvolvimento. Em outros ambientes, como CI externo, você pode passar um token de acesso da Vercel para getToken com a opção vercelToken. Você também pode chamar diretamente a API da BillionVerify com sua chave, sem o Vercel Connect.
O conector da Vercel funciona com o servidor MCP hospedado?
O servidor MCP hospedado em mcp.billionverify.com autentica você com OAuth, que é o método usado pelo conector do Claude. O conector da Vercel mantém uma chave API, que funciona com a API REST, o pacote npm billionverify-mcp e a habilidade do agente.
Adicione o BillionVerify ao Vercel Connect
Abra vercel.com/connect/billionverify, cole sua chave de API do BillionVerify, vincule seu projeto e verifique o próximo cadastro ou lead antes que ele chegue à sua lista.