Captcha: Contorno Automático
Como configurar o agente para resolver reCAPTCHA e hCaptcha automaticamente durante a automação, usando provedores especializados.
Como funciona
Ao ativar Quebrar mecanismo de Captcha? numa etapa, o runtime varre a página inteira procurando qualquer desafio de reCAPTCHA/hCaptcha ativo, envia o que encontrar ao provedor de resolução configurado (um serviço especializado com resolvedores humanos/IA), recebe a resposta e a aplica na página, sem que você precise dizer qual tipo de captcha é ou onde ele está. O processo é registrado nos logs da execução.
Configuração em 2 níveis
- Agente: nas Configurações Gerais, habilite o componente Contorno de Captcha em Quais componentes deseja habilitar? e escolha o provedor em Selecione um provedor de Captcha.
- Etapa: na etapa que encontra o CAPTCHA, ative Quebrar mecanismo de Captcha? (Etapas e Ações). O campo só existe em etapas de navegador (Navegar em Tela, Preencher Dados e Obter Informação), porque o captcha aparece na página. Nas etapas de Chamar API Rest, Conectores, Regra Customizada e Decisão ele não aparece.
Provedores e tipos suportados
2CAPTCHA e CAPMONSTER são só os provedores de resolução, o serviço pago que efetivamente resolve o desafio. A ponte que detecta o captcha na página, extrai sua configuração e envia ao provedor certo é a mesma nos dois casos:
| Provedor | Como se conecta |
|---|---|
| 2CAPTCHA | Provedor embutido na ponte de detecção, sem precisar de nenhum adaptador adicional. |
| CAPMONSTER | Plugado na mesma ponte de detecção através de um adaptador dedicado ao CapMonster. |
Como os dois provedores passam pela mesma ponte de detecção, o conjunto de captchas resolvidos automaticamente é idêntico nos dois:
| Suportado | Não suportado |
|---|---|
|
reCAPTCHA v2 reCAPTCHA v3 (baseado em score) reCAPTCHA invisível hCaptcha hCaptcha invisível |
Captcha de imagem comum (dígitos ou letras distorcidas). |
2CAPTCHA e CAPMONSTER, como serviços, resolvem bem mais tipos de desafio do que isso hoje. A lista abaixo é o que os dois provedores já oferecem e que está no roadmap para os próximos releases do Contorno de Captcha:
| Tipo | Já suportado por |
|---|---|
| FunCaptcha (Arkose Labs) | 2CAPTCHA e CAPMONSTER |
| GeeTest (v3/v4) | 2CAPTCHA e CAPMONSTER |
| Cloudflare Turnstile | 2CAPTCHA e CAPMONSTER |
| Amazon WAF | 2CAPTCHA e CAPMONSTER |
| reCAPTCHA Enterprise (v2/v3) | 2CAPTCHA e CAPMONSTER |
| DataDome | 2CAPTCHA |
| Text Captcha (pergunta/resposta) | 2CAPTCHA e CAPMONSTER |
Acompanhando nos logs
Durante a execução, o contorno aparece na Trilha de Auditoria com mensagens próprias:
- "Validando reCaptcha...": a varredura começou, procurando qualquer desafio ativo na página.
- "reCaptcha foi contornada com sucesso": a resposta foi aplicada e o fluxo seguiu.
Quando o contorno falha
Resolução de CAPTCHA depende de um serviço externo, então trate a possibilidade de falha:
- Configure a Gestão de Erros e Exceções da etapa para tentar de novo ou desviar para uma rota de recuperação (Gestão de Erros e Exceções), por exemplo tentando novamente com o padrão de retry.
- Ative Gerar Evidência? na etapa para registrar a tela do desafio (Screenshot).
- Se a falha persistir em várias execuções/agentes ao mesmo tempo, pode ser instabilidade do provedor escolhido. Troque de 2CAPTCHA para CAPMONSTER (ou vice-versa) nas Configurações Gerais do agente para testar.