ProdutosIntegraçõesRecursosDocumentaçãoPreços
Começar agora

© 2026 CapSolver. All rights reserved.

Contacte-nos

Slack: lola@capsolver.com

Produtos

  • reCAPTCHA v2
  • reCAPTCHA v3
  • Cloudflare Turnstile
  • Cloudflare Challenge
  • AWS WAF
  • Extensão de Navegador
  • Mais tipos de CAPTCHA

Integrações

  • Selenium
  • Playwright
  • Puppeteer
  • n8n
  • Parceiros
  • Ver todas as integrações

Recursos

  • Programa de Referenciação
  • Documentação
  • Referência da API
  • Blog
  • FAQ
  • Glossário
  • Estado

Legal

  • Termos de Serviço
  • Política de Privacidade
  • Política de Reembolso
  • Não vender os meus dados pessoais
Blog/reCAPTCHA/Como Encontrar a Função de Callback do reCAPTCHA em Diferentes Versões
Sep15, 2025

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

Adélia Cruz

Adélia Cruz

Neural Network Developer

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.

Imagem ilustrativa do reCAPTCHA

⚠️ 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:

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

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

Exemplo de busca por data-callback

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:

js Copy
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.

Estrutura de ___grecaptcha_cfg.clients

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():

js Copy
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:

js Copy
[
  {
    "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).

Exemplo de função anônima

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:

js Copy
___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.

Ver mais

reCAPTCHAApr 16, 2026

reCAPTCHA Chave de Site Inválida ou Token Inválido? Causas & Guia de Solução

Enfrentando "Chave de Site Inválida do reCAPTCHA" ou "token do reCAPTCHA inválido"? Descubra causas comuns, soluções passo a passo e dicas de solução de problemas para resolver problemas de verificação do reCAPTCHA. Aprenda como corrigir o erro de verificação do reCAPTCHA, por favor tente novamente.

Aloísio Vítor
Aloísio Vítor
reCAPTCHAFeb 12, 2026

Como corrigir problemas comuns de reCAPTCHA em raspagem de web

Aprenda como corrigir problemas comuns do reCAPTCHA na raspagem da web. Descubra soluções práticas para o reCAPTCHA v2 e v3 para manter fluxos de coleta de dados sem interrupções.

Índice

Sora Fujimoto
Sora Fujimoto
reCAPTCHAFeb 27, 2026

Como automatizar a resolução de reCAPTCHA para plataformas de benchmarking de IA

Aprenda como automatizar o reCAPTCHA v2 e v3 para benchmarking de IA. Use o CapSolver para otimizar a coleta de dados e manter pipelines de IA de alto desempenho.

Emma Foster
Emma Foster
reCAPTCHAJul 16, 2024

Resolva Captchas Ilimitados com o Melhor Solucionador de Captcha

Aprenda a resolver sem problemas captchas ilimitados com o melhor solver de captchas, um guia detalhado sobre como configurar e automatizar soluções de captchas de forma eficaz

Sora Fujimoto
Sora Fujimoto