Como resolver reCAPTCHA v2 no Relevance AI com integração da CapSolver

A Relevance AI é uma plataforma para criar agentes de IA que automatizam fluxos de trabalho reais, como geração de leads, extração de dados, envio de formulários e enriquecimento de CRM.

Na prática, esses agentes frequentemente precisam interagir com sites protegidos por CAPTCHA. É aí que a automação costuma falhar - é necessário intervenção manual e os fluxos de trabalho param de escalar.

O CapSolver resolve esse problema permitindo que as ferramentas da Relevance AI resolvam desafios de CAPTCHA de forma programática e enviem os tokens necessários como parte de um fluxo automatizado.

Neste guia, vamos mostrar como criar uma ferramenta da Relevance AI que resolva o reCAPTCHA v2 e envie o token para um formulário protegido - sem depender de automação de navegador.

O que é a Relevance AI?

Relevance AI é uma plataforma para criar e implantar agentes de IA que automatizam tarefas empresariais. Com seu poderoso Tool Builder, equipes podem criar ferramentas de automação personalizadas usando JavaScript, Python ou chamadas de API - sem necessidade de infraestrutura complexa.

Principais Funcionalidades

O que é o CapSolver?

CapSolver é um serviço líder de resolução de CAPTCHA que fornece soluções baseadas em IA para contornar vários desafios de CAPTCHA. Com suporte para vários tipos de CAPTCHA e tempos de resposta rápidos, o CapSolver se integra perfeitamente em fluxos automatizados.

Tipos de CAPTCHA Suportados

• reCAPTCHA v2 (baseado em imagem & invisível)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• Outros mecanismos de anti-bot e CAPTCHA amplamente utilizados

Por que Integrar o CapSolver com a Relevance AI?

Ao construir agentes da Relevance AI que interagem com sites protegidos, os desafios de CAPTCHA bloqueiam sua automação. Aqui está o porquê dessa integração ser importante:

1. Automação Completa de Formulários: Resolva CAPTCHAs e envie formulários em uma única ferramenta
2. Nenhum Navegador Necessário: Funciona por meio de chamadas de API - sem Selenium, Playwright ou automação de navegador
3. Operações Escaláveis: Trate fluxos de trabalho protegidos por CAPTCHA em larga escala
4. Custo-Efetivo: Pague apenas pelos CAPTCHAs resolvidos com sucesso
5. Altas Taxas de Sucesso: Precisão líder do setor para o reCAPTCHA v2

Guia de Configuração

Etapa 1: Obtenha Sua Chave de API do CapSolver

1. Registre-se em capsolver.com
2. Use o código de bônus RELEVANCEAI para obter 6% a mais em cada recarga

3. Copie sua chave de API do painel (começa com CAP-)

Etapa 2: Adicione a Chave de API na Relevance AI

1. Faça login em Relevance AI

2. Vá para Configurações (ícone de engrenagem) → Procure a seção Chaves de API
   
   

3. Adicione um novo segredo:

   • Nome: capsolver_api_key (ou qualquer nome que preferir)
   • Valor: Sua chave de API do CapSolver
     

4. Salve o segredo

Etapa 3: Crie uma Nova Ferramenta

1. Vá para Ferramentas na barra lateral esquerda
2. Clique em Criar Ferramenta
3. Dê um nome à sua ferramenta: "Resolver reCAPTCHA v2"
4. Adicione uma breve descrição

Criando a Ferramenta do Resolver reCAPTCHA v2

Adicione Parâmetros de Entrada

Clique em Texto para adicionar duas entradas de texto:

Entrada 1:

• Nome: website_url
• Descrição: URL da página com CAPTCHA
• Obrigatório: Sim

Entrada 2:

• Nome: website_key
• Descrição: A chave do site reCAPTCHA (40 caracteres)
• Obrigatório: Sim

Adicione um Passo em JavaScript

Clique em JavaScript na seção Passos e cole este código:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveRecaptchaV2(websiteUrl, websiteKey) {
    // Etapa 1: Criar tarefa de resolução de CAPTCHA
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();

    if (createData.errorId !== 0) {
        return {
            success: false,
            error: createData.errorDescription,
            token: null
        };
    }

    const taskId = createData.taskId;

    // Etapa 2: Verificar solução (verifica a cada 2 segundos)
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            return {
                success: true,
                token: pollData.solution.gRecaptchaResponse,
                error: null
            };
        }

        if (pollData.status === 'failed') {
            return {
                success: false,
                error: pollData.errorDescription,
                token: null
            };
        }
    }

    return {
        success: false,
        error: 'Tempo esgotado ao esperar pela solução',
        token: null
    };
}

return await solveRecaptchaV2(params.website_url, params.website_key);

Nota: Substitua {{secrets.capsolver_api_key}} pelo nome real do seu segredo se for diferente (por exemplo, {{secrets.chains_cap}}).

Teste a Ferramenta

Use a página de demonstração do reCAPTCHA da Google para testar:

• website_url: https://www.google.com/recaptcha/api2/demo
• website_key: 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-

Clique em Executar ferramenta e espere 10-30 segundos. Você deverá ver:

{
  "success": true,
  "token": "03AGdBq24PBCbwiDRaS_MJ7Z...",
  "error": null
}

Exemplo Completo: Resolver + Enviar Formulário

Aqui está uma ferramenta mais avançada que resolve o CAPTCHA E o envia para verificar:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveAndSubmit(websiteUrl, websiteKey) {
    // Etapa 1: Criar tarefa de resolução de CAPTCHA
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();
    if (createData.errorId !== 0) {
        return { success: false, step: 'create', error: createData.errorDescription };
    }

    const taskId = createData.taskId;
    let token = null;

    // Etapa 2: Verificar solução
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            token = pollData.solution.gRecaptchaResponse;
            break;
        }
        if (pollData.status === 'failed') {
            return { success: false, step: 'poll', error: pollData.errorDescription };
        }
    }

    if (!token) {
        return { success: false, step: 'timeout', error: 'Tempo esgotado' };
    }

    // Etapa 3: Enviar formulário com token
    const submitRes = await fetch(websiteUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: 'g-recaptcha-response=' + token
    });

    const html = await submitRes.text();
    const verified = html.includes('Success') || html.includes('verificado');

    return {
        success: verified,
        token_length: token.length,
        message: verified ? 'CAPTCHA verificado com sucesso!' : 'Verifique a resposta',
        response_preview: html.substring(0, 300)
    };
}

return await solveAndSubmit(params.website_url, params.website_key);

Essa ferramenta:

1. ✅ Resolve o reCAPTCHA v2
2. ✅ Envia o token por meio de uma solicitação POST
3. ✅ Retorna o status de verificação

Boas Práticas

1. Tratamento de Erros

Sempre verifique erros em cada etapa:

if (createData.errorId !== 0) {
    return { success: false, error: createData.errorDescription };
}

2. Verifique o Saldo

Crie uma ferramenta separada para monitorar seu saldo do CapSolver:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function checkBalance() {
    const response = await fetch('https://api.capsolver.com/getBalance', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ clientKey: CAPSOLVER_API_KEY })
    });

    const data = await response.json();

    return {
        balance: data.balance,
        formatted: '$' + data.balance.toFixed(4)
    };
}

return await checkBalance();

3. Configuração de Tempo Limite

O tempo limite padrão de 60 tentativas × 2 segundos = 2 minutos. Ajuste se necessário:

// Para um tempo limite mais rápido (30 segundos)
for (let i = 0; i < 15; i++) {
    await new Promise(function(resolve) { setTimeout(resolve, 2000); });
    // ...
}

Conclusão

A integração do CapSolver com a Relevance AI permite fluxos de trabalho de automação poderosos que podem lidar com formulários protegidos por CAPTCHA. Os principais benefícios:

• Nenhuma automação de navegador é necessária - Funciona por meio de chamadas puras de API
• Rápido e confiável - A IA do CapSolver resolve CAPTCHAs em segundos
• Fácil de implementar - Apenas JavaScript no Construtor de Ferramentas da Relevance AI
• Escalável - Trate várias solicitações sem preocupações com infraestrutura

Ao combinar as capacidades dos agentes da Relevance AI com a resolução de CAPTCHA do CapSolver, você pode construir fluxos de automação completos que lidam até mesmo com os formulários mais protegidos.

Pronto para começar? Registre-se no CapSolver e use o código de bônus RELEVANCE para obter mais 6% de bônus em sua primeira recarga!

Perguntas Frequentes

O que é a Relevance AI?

A Relevance AI é uma plataforma para criar agentes de IA que automatizam tarefas empresariais. Ela oferece um Construtor de Ferramentas onde você pode criar ferramentas de automação personalizadas usando JavaScript, Python ou chamadas de API.

A Relevance AI realiza automação de navegador?

Não. A Relevance AI funciona por meio de chamadas de API, não por automação de navegador. Ela não consegue abrir navegadores, clicar em botões ou injetar JavaScript em páginas. No entanto, ela pode fazer solicitações HTTP para enviar formulários com tokens de CAPTCHA.

Como o CapSolver se integra à Relevance AI?

Você cria uma ferramenta JavaScript na Relevance AI que chama a API do CapSolver. A ferramenta envia os detalhes do CAPTCHA para o CapSolver, recebe um token resolvido e pode enviar esse token para o formulário de destino por meio de POST HTTP.

Quais tipos de CAPTCHAs o CapSolver pode resolver?

O CapSolver suporta reCAPTCHA v2, reCAPTCHA v3, Cloudflare Turnstile, AWS WAF e muitos outros.

Quanto custa o CapSolver?

O CapSolver oferece preços competitivos por resolução. Visite capsolver.com para ver os preços atuais.

Como encontrar a chave do site reCAPTCHA?

Procure o atributo data-sitekey no elemento reCAPTCHA no HTML da página. É uma string de 40 caracteres que começa com 6L. Confira este guia

Quanto tempo leva para resolver um CAPTCHA?

Normalmente 10-30 segundos para o reCAPTCHA v2. A ferramenta verifica a cada 2 segundos até que a solução esteja pronta.