Como Encontrar a Função de Callback do reCAPTCHA em Diferentes Versões

Descobrir a função de callback do reCAPTCHA é crucial para automatizar a interação com este sistema de segurança. Este guia detalha métodos práticos para localizar e executar callbacks em diversas versões do reCAPTCHA, permitindo a integração eficaz com ferramentas de automação como Selenium ou Puppeteer. Compreender a estrutura do reCAPTCHA e suas funções de retorno é essencial para desenvolvedores e especialistas em automação que buscam otimizar processos e garantir a fluidez da navegação em sites protegidos.

⚠️ Cada site possui uma implementação única. Se os métodos a seguir não resolverem o problema, uma pesquisa mais aprofundada pode ser necessária.

Após obter o valor gRecaptchaResponse através da API, é fundamental executar uma função de callback para informar à página web que o reCAPTCHA foi resolvido com sucesso, especialmente ao usar softwares de simulação como Selenium. Este artigo explora diversas abordagens para identificar essa função essencial.

Nota: Em alguns casos, a função de callback pode não existir. Nesses cenários, é possível atribuir diretamente o valor ao contêiner g-recaptcha-response e submeter o formulário.

Método 1: Busca via Elementos do Console

Abra a página desejada, pressione F12 para acessar o console do navegador. Na aba 'Elements', utilize Ctrl+F para buscar o termo data-callback.

Frequentemente, a função de callback será revelada, como onSuccess. Para executá-la no Selenium, utilize o seguinte comando:

driver.execute_script(f'onSuccess("{gRecaptchaResponse}")')

Se a busca não retornar resultados ou apresentar nomes ofuscados, explore os métodos alternativos.

Método 2: Específico para reCAPTCHA v3

Para a série reCAPTCHA v3, procure pelo termo grecaptcha.render no console. Você encontrará um código similar a este, onde callback indica a função de retorno:

grecaptcha.render('example', {
  'sitekey': 'someSitekey',
  'callback': myCallbackFunction,
  'theme': 'dark'
});

Método 3: Inspeção Direta do Objeto ___grecaptcha_cfg.clients

Pressione F12 para abrir o console e digite ___grecaptcha_cfg.clients. Se um erro for reportado, o reCAPTCHA pode não ter sido carregado na página. Este objeto geralmente contém múltiplos nós; identifique o onSuccess ou similar como a função de callback.

Método 4: Função de Busca Automática Personalizada

Quando os métodos anteriores se mostram complexos, uma função JavaScript personalizada pode simplificar a busca. No console, defina e execute a função findRecaptchaClients():

function findRecaptchaClients() {
  if (typeof (___grecaptcha_cfg) !== 'undefined') {
    return Object.entries(___grecaptcha_cfg.clients).map(([cid, client]) => {
      const data = { id: cid, version: cid >= 10000 ? 'V3' : 'V2' }
      const objects = Object.entries(client).filter(([_, value]) => value && typeof value === 'object')

      objects.forEach(([toplevelKey, toplevel]) => {
        const found = Object.entries(toplevel).find(([_, value]) => (
          value && typeof value === 'object' && 'sitekey' in value && 'size' in value
        ))

        if (typeof toplevel === 'object' && toplevel instanceof HTMLElement && toplevel['tagName'] === 'DIV') {
          data.pageurl = toplevel.baseURI
        }

        if (found) {
          const [sublevelKey, sublevel] = found

          data.sitekey = sublevel.sitekey
          const callbackKey = data.version === 'V2' ? 'callback' : 'promise-callback'
          const callback = sublevel[callbackKey]
          if (!callback) {
            data.callback = null
            data.function = null
          } else {
            data.function = callback
            const keys = [cid, toplevelKey, sublevelKey, callbackKey].map((key) => `['${key}']`).join('')
            data.callback = `___grecaptcha_cfg.clients${keys}`
          }
        }
      })
      return data
    })
  }
  return []
}

findRecaptchaClients && findRecaptchaClients()

Execute findRecaptchaClients() no console para obter um resultado estruturado, como:

[
  {
    "id": "0",
    "version": "V2",
    "sitekey": "site key-",
    "function": "onSuccess",
    "callback": "___grecaptcha_cfg.clients['0']['l']['l']['callback']",
    "pageurl": "site url"
  }
]

Resgaste seu Código Bônus para as melhores soluções de captcha; CapSolver: CAP25. Após resgatá-lo, você receberá um bônus extra de 5% a cada recarga, ilimitado.

Como Chamar Funções Anônimas do reCAPTCHA

Em alguns casos, a função de callback pode ser anônima, sem um nome explícito. Nesses cenários, o caminho completo do objeto, como ___grecaptcha_cfg.clients.xxxxxxxxx.xxxxx.xxxxx.callback(gRecaptchaResponse), deve ser utilizado para a execução.

Por exemplo, ao inspecionar ___grecaptcha_cfg.clients, você pode encontrar um promise-callback que é uma função anônima f(token).

Para obter o caminho, clique com o botão direito e selecione 'Copy property path'. Adicione ___grecaptcha_cfg.clients ao início do caminho copiado para formar a chamada completa:

___grecaptcha_cfg.clients[100000].l.l["promise-callback"](gRecaptchaResponse)

Para mais informações sobre a integração de soluções de CAPTCHA, confira nosso artigo sobre Como Integrar CapSolver com Selenium. Para entender melhor o que é o reCAPTCHA e como ele funciona, veja O Que É Reconhecimento de reCAPTCHA?.

Para detalhes técnicos e documentação oficial, consulte a página de desenvolvedores do Google reCAPTCHA v2: Documentação Google reCAPTCHA v2.

Perguntas Frequentes (FAQs)

O que é uma função de callback do reCAPTCHA?

Uma função de callback do reCAPTCHA é um trecho de código JavaScript que é executado após o reCAPTCHA ser resolvido com sucesso. Ela serve para notificar a aplicação web de que a verificação humana foi concluída, permitindo que o processo de submissão do formulário ou outra ação continue.

Por que preciso encontrar a função de callback?

Encontrar a função de callback é essencial para a automação de tarefas que envolvem reCAPTCHAs. Ao simular a resolução do CAPTCHA (por exemplo, usando uma API de solução), você precisa chamar essa função para que a página web reconheça a solução e permita o avanço, evitando bloqueios ou erros.

Posso sempre encontrar uma função de callback?

Não, nem sempre. Em alguns casos, a implementação do reCAPTCHA pode não utilizar uma função de callback explícita. Nesses cenários, a solução pode envolver a injeção direta do token gRecaptchaResponse no campo textarea correspondente e a submissão manual do formulário.

Qual a diferença entre reCAPTCHA v2 e v3 na busca por callbacks?

No reCAPTCHA v2, a função de callback é frequentemente associada ao atributo data-callback ou ao parâmetro callback no grecaptcha.render. Já no reCAPTCHA v3, que opera de forma mais invisível, a função pode ser encontrada como promise-callback dentro da estrutura ___grecaptcha_cfg.clients, refletindo sua natureza assíncrona e baseada em pontuação.

O que fazer se a função de callback for anônima?

Se a função de callback for anônima, você precisará identificar o caminho completo do objeto JavaScript que a contém. Ferramentas de desenvolvedor do navegador permitem copiar o

caminho da propriedade (Copy property path) no console, e então você pode usar esse caminho para chamar a função diretamente, como ___grecaptcha_cfg.clients[ID].caminho.para.callback(gRecaptchaResponse).

Resumo

Este artigo forneceu um guia abrangente sobre como localizar e interagir com as funções de callback do reCAPTCHA em diversas versões. Desde a busca por atributos data-callback no console até a inspeção de objetos JavaScript como ___grecaptcha_cfg.clients e a utilização de funções de busca personalizadas, as técnicas apresentadas visam capacitar desenvolvedores e automatizadores a integrar soluções de CAPTCHA de forma mais eficiente. A compreensão da natureza das funções de callback, sejam elas nomeadas ou anônimas, é fundamental para garantir a fluidez da automação e a superação de desafios impostos por sistemas anti-bot. Com as informações e os links fornecidos, é possível aprofundar o conhecimento e otimizar ainda mais os processos de automação que dependem da resolução de reCAPTCHAs.