Neste artigo, procuramos responder a todas as principais dúvidas. Para começar a resolver o problema, o primeiro passo é identificar qual sistema de proteção está sendo utilizado. Para isso, você pode consultar a lista de captchas e sistemas de proteção antibot mais populares, onde há exemplos visuais e sinais principais que ajudam a identificar rapidamente com o que você está lidando.
Se você notar que o seu site utiliza reCAPTCHA v3, o passo seguinte é estudar com mais detalhes as suas características e o seu funcionamento. Neste mesmo artigo, você também pode conferir o guia de integração do reCAPTCHA v3, para entender por completo como o sistema opera no seu site. Isso permitirá não apenas compreender a proteção atual, mas também planejar adequadamente a sua manutenção.
Como resolver o reCAPTCHA v3 usando o CapMonster Cloud
Ao testar formulários com reCAPTCHA v3, é comum precisar confirmar se a captcha está funcionando e integrada corretamente.
Você pode testar manualmente a captcha incorporada no site.
- Abra a página do formulário e veja se a captcha é exibida.
- Tente enviar sem resolver — o servidor deve retornar erro.
- Depois de resolver corretamente, o envio precisa ocorrer sem falhas.
Para resolver automaticamente use ferramentas como o CapMonster Cloud, que recebe os parâmetros da captcha, processa em seus servidores e devolve um token pronto. Basta inseri-lo no formulário para passar na verificação sem interação humana.
Trabalhar com o CapMonster Cloud via API normalmente envolve as etapas abaixo:
Criação da tarefa
Envio da requisição APINa solicitação para resolver o reCAPTCHA v3 é necessário informar os seguintes parâmetros:
type - RecaptchaV3TaskProxyless;
websiteURL - o endereço da página em que o captcha é resolvido;
websiteKey - a chave identificadora (sitekey) informada na página do seu site com o captcha;
minScore - pode ter um valor de 0.1 a 0.9;
pageAction - o valor do parâmetro action que é enviado pelo widget ReCaptcha no Google. Valor padrão: verify.
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.7,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
Recebimento do resultadohttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
Aplicação do token na páginaconst { chromium } = require('playwright');
const {
CapMonsterCloudClientFactory,
ClientOptions,
RecaptchaV3ProxylessRequest
} = require('@zennolab_com/capmonstercloud-client');
(async () => {
const TARGET_URL = 'https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta'; // URL da sua página com o captcha
const SITE_KEY = '6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob';
const API_KEY = 'your_capmonster_cloud_api_key'; // Informe sua chave de API do CapMonster Cloud
// Criando o cliente do CapMonster
const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: API_KEY }));
// Abrindo o navegador
const browser = await chromium.launch({ headless: false });
const page = await browser.newPage();
await page.goto(TARGET_URL, { waitUntil: 'domcontentloaded' });
// Configuração da tarefa do reCAPTCHA v3
const recaptchaRequest = new RecaptchaV3ProxylessRequest({
websiteURL: TARGET_URL,
websiteKey: SITE_KEY,
minScore: 0.6,
pageAction: 'myverify', // correspondência com o action na página
});
// Resolvendo o captcha
const solution = await cmcClient.Solve(recaptchaRequest);
const token = solution.solution?.gRecaptchaResponse;
if (!token) {
console.error('O token está vazio, verifique a sitekey e a URL');
await browser.close();
return;
}
console.log('Token recebido:', token);
// Inserindo o token em um campo oculto e simulando o clique no botão
// Substitua pelos seletores necessários
await page.evaluate((t) => {
const input = document.querySelector('#v3_token');
if (input) input.value = t;
const form = document.querySelector('#v3_form');
if (form) form.submit();
}, token);
console.log('Token inserido e formulário enviado');
await page.waitForTimeout(5000);
await browser.close();
})();1. Acesse a página do painel de administração do reCAPTCHA.
2. Registre um novo site e escolha o tipo de captcha — reCAPTCHA v3
3. Obtenha duas chaves:
- Site key — chave pública (usada no frontend);
- Secret key — chave privada (usada no servidor para verificação)
Você pode abrir as configurações, onde é possível, por exemplo, especificar os domínios nos quais o reCAPTCHA será utilizado ou configurar alertas sobre problemas no site ou aumento de tráfego suspeito.
4. Exemplos de código para o lado do cliente
A maneira mais simples de usar o reCAPTCHA v3 é conectar a API JavaScript e adicionar atributos a um botão.
Conectando a API:
<script src="https://www.google.com/recaptcha/api.js"></script>Função de callback para o formulário:
<script>
function onSubmit(token) {
document.getElementById("form").submit();
}
</script>
Botão com atributos do reCAPTCHA:
<button class="g-recaptcha"
data-sitekey="reCAPTCHA_sitekey"
data-callback='onSubmit'
data-action='submit'>Submit</button>
Para controle total, use grecaptcha.execute com o parâmetro render:
Conectando a API com a chave:
<script src="https://www.google.com/recaptcha/api.js?render=reCAPTCHA_site_key"></script>Chamada programática:
<script>
function onClick(e) {
e.preventDefault();
grecaptcha.ready(function() {
grecaptcha.execute('reCAPTCHA_sitekey', {action: 'submit'}).then(function(token) {
// Envie o token para o servidor para verificação
});
});
}
</script>
O token deve ser enviado imediatamente ao servidor para verificação.
Observações importantes:
- Validade do token: o token recebido do reCAPTCHA v3 é válido por 2 minutos. Certifique-se de enviá-lo ao servidor dentro desse período.
- Verificação no servidor: após receber o token no servidor, envie uma requisição POST para https://www.google.com/recaptcha/api/siteverify com os parâmetros:
– secret: sua chave secreta
– response: o token recebido do cliente– remoteip (opcional): endereço IP do usuário - O servidor do Google retornará uma resposta JSON contendo informações sobre o resultado da verificação.
5. Agora, no lado do servidor, faça a validação da resposta
Exemplo em PHP<?php
// Sua chave secreta (Secret Key) do reCAPTCHA v3
$secret = 'YOUR_SECRET_KEY';
// Obtendo o token do formulário
$token = $_POST['recaptcha-token'] ?? '';
// Enviando a requisição ao Google para verificar o token
$response = file_get_contents(
"https://www.google.com/recaptcha/api/siteverify?secret={$secret}&response={$token}"
);
$result = json_decode($response, true);
// Verificando o sucesso e a pontuação de confiança
if ($result['success'] && $result['score'] >= 0.5 && $result['action'] === 'submit') {
echo "Verificação aprovada";
} else {
http_response_code(403);
echo "Verificação reprovada";
}
?>
Observações:
- Certifique-se de que, no cliente, o token seja enviado em um campo oculto do formulário com o nome recaptcha-token:
- O limite do score pode ser ajustado de acordo com o nível de rigor desejado (por exemplo, 0,3–0,7).
- A validação de action === 'submit' aumenta a segurança, garantindo que o token foi gerado para a ação correta na página.
<input type="hidden" name="recaptcha-token" id="recaptcha-token">
Captchas suportados
reCAPTCHA v2reCAPTCHA v3reCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
FriendlySe você herdou um site que já tem um captcha ou outro sistema de proteção instalado e não tem acesso ao código, não tem problema! É bem fácil identificar qual tecnologia está sendo usada. Para verificar se tudo está funcionando corretamente, você pode usar o serviço de reconhecimento CapMonster Cloud em um ambiente de testes isolado, para garantir que o mecanismo de processamento de tokens e a lógica de verificação estejam funcionando corretamente.
No caso de reCAPTCHA v3, basta identificar o sistema, analisar o comportamento dele e se certificar de que a proteção está funcionando corretamente. No artigo, mostramos como identificar reCAPTCHA v3 e onde encontrar instruções para a integração ou reconfiguração, para que você consiga manter a proteção com segurança e controlar o funcionamento dela.
Documentação do reCAPTCHA v3 →Documentação do CapMonster Cloud (trabalho com reCAPTCHA v3) →Como resolver o ReCaptcha v3 em Python usando Selenium & CapMonster Cloud →Como resolver o ReCaptcha v3 em JavaScript usando Selenium & CapMonster Cloud →Como resolver o ReCaptcha v3 em C# usando Selenium & CapMonster Cloud →
Perguntas frequentes sobre reCAPTCHA v3
