FunCaptcha
e CapMonster Cloud

Solução de captcha, instalação no site e testes.

Preços da solução FunCaptcha

CAPTCHA
Preço (USD)
$ 1.10
1000 tokens
Você herdou um site com captcha ou outra camada de proteção, mas não tem acesso ao código-fonte? Então é normal querer saber qual solução está instalada, se a configuração está correta e como testar tudo.

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 FunCaptcha (Arkose Labs CAPTCHA), 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 FunCaptcha (Arkose Labs CAPTCHA), 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.

O que é FunCaptcha
O que é FunCaptcha
FunCaptcha é um sistema interativo de proteção contra bots desenvolvido pela Arkose Labs. Ele verifica se o usuário é humano através de desafios visuais e jogáveis, fáceis para pessoas, mas difíceis de automatizar. FunCaptcha é usado para proteger registros, logins, pagamentos online, campanhas de marketing e prevenir fraudes, spam e ações automatizadas em massa.
Background
Exemplos de FunCaptcha
Rotação de objeto 3D
Rotação de objeto 3D
O usuário gira um modelo 3D ou figura para colocá-lo na posição correta.
Selecionar objetos conforme a regra
Selecionar objetos conforme a regra
É necessário selecionar imagens ou elementos que correspondam a uma regra (por exemplo, 'selecione todas as maçãs').
Tarefas interativas (arrastar e soltar / seguir caminho)
Tarefas interativas (arrastar e soltar / seguir caminho)
O usuário realiza ações com elementos, como arrastá-los por um caminho específico.
Perguntas de áudio
Perguntas de áudio
O usuário ouve o áudio e escolhe a resposta correta (usado menos frequentemente como alternativa aos desafios visuais).

Como resolver FunCaptcha via CapMonster Cloud

Ao testar formulários com FunCaptcha, muitas vezes é necessário verificar se o captcha está funcionando corretamente e integrado.
Você pode testar manualmente o captcha adicionado ao seu site.
  • Abra a página com o formulário e verifique se o captcha está visível.
  • Tente enviar o formulário sem resolver o captcha — o servidor deve retornar um erro.
  • Após resolver o captcha com sucesso — o formulário deve ser enviado sem erros.
Para reconhecimento automático de captcha, você pode usar serviços especializados como o CapMonster Cloud — uma ferramenta que recebe os parâmetros do captcha, processa-os em seus servidores e retorna um token pronto. Esse token pode ser inserido no formulário para passar na verificação sem a intervenção do usuário.

Trabalhar com o CapMonster Cloud via API normalmente envolve as etapas abaixo:

Criação da tarefaCriação da tarefa
arrow
Envio da requisição APIEnvio da requisição API
arrow
Recebimento do resultadoRecebimento do resultado
arrow
Aplicação do token na páginaAplicação do token na página
arrow
Como conectar FunCaptcha ao seu site
Para entender bem o funcionamento do captcha no seu site, compreender a lógica de verificação e reconectar ou reconfigurar, recomendamos estudar esta seção. Ela descreve o processo de conexão da proteção e ajuda a entender rapidamente todos os detalhes.
  1. Registre-se na Arkose Labs e obtenha acesso ao Arkose Command Center (você pode enviar um chat com seus dados no formulário — por exemplo, aqui ou aqui).
  2. Após o acesso, obtenha duas chaves (Public / Private) na seção Settings → Keys.

    HowTo Connect image 1

  3. Se necessário, contate o Customer Success Manager (CSM) para:

    • obter domínios API personalizados;
    • verificar esquemas de requisições e respostas API.

Recomendações Arkose

  • Use a Development Key para testes.
  • Use uma Production Key separada para cada workflow (login, registro, compra etc.).
  • Use chaves diferentes para sites diferentes.

Processo geral de funcionamento

  • O cliente coleta dados e, se necessário, exibe um desafio.
  • O cliente recebe um token de sessão único.
  • O servidor verifica o token via Arkose Verify API.

Passo 1. Integração do lado do cliente

No navegador (Arkose Bot Manager):

  • analisa o comportamento do usuário;
  • exibe, se necessário, Enforcement Challenge;
  • retorna um token de sessão.

Client API:

  • Para testes pode-se usar:
    client-api.arkoselabs.com
  • Para produção, recomenda-se indicar um domínio personalizado:
    <company>-api.arkoselabs.com

Principais requisitos

Resultado do cliente — token a ser enviado ao servidor.

Passo 2. Verificação no servidor

No servidor, o token é verificado via Arkose Verify API.

Verify API endpoint

Parâmetros obrigatórios do pedido

Exemplo de corpo POST

A resposta da API contém informações da sessão e o resultado da verificação.

Pontos-chave

Como funciona:

Background
Possíveis erros e depuração
Bug Icon
Parâmetros de pedido incorretos
Certifique-se de fornecer a Public Key correta para o cliente e a Private Key para o servidor, e enviar o session_token correto para a Verify API.
Bug Icon
session_token vazio ou incorreto
O servidor receberá resultado vazio ou erro de verificação. Verifique se o cliente envia corretamente o token após resolver o captcha.
Bug Icon
Tempo de resolução esgotado
Se o usuário não completar a verificação a tempo, o servidor Arkose pode retornar erro ou rejeitar a verificação. Aumente o tempo de espera permitido no servidor.
Verificação da robustez
Recomendações de segurança e otimização
<span class="font-bold">Armazene a Private Key apenas no servidor</span>, não inclua no código JS do cliente.
Registre respostas completas da Arkose Verify API, incluindo status, código de erro e parâmetros enviados — isso ajuda na rápida resolução de problemas.
Use <span class="font-bold">HTTPS</span> para todas as requisições (cliente → servidor → Verify API) para evitar manipulação de dados.
Coloque links para a <span class="font-bold">Política de Privacidade</span> e os <span class="font-bold">Termos de Uso Arkose Labs</span> no site, conforme exigido pela licença.
Conclusão

Se 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 FunCaptcha, basta identificar o sistema, analisar o comportamento dele e se certificar de que a proteção está funcionando corretamente. No artigo, mostramos como identificar FunCaptcha 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.

Conclusion

Perguntas frequentes sobre FunCaptcha

Sim — o Arkose pode operar em modo invisível, analisar o comportamento em segundo plano e só exibir um challenge visível quando detecta risco. Em sessões de baixo risco, o script do cliente coleta sinais e retorna um session token via callback sem exibir UI.

Sua integração deve sempre tratar o callback — o caminho de processamento do token é o mesmo nos dois casos.

Um indicador confiável são requisições de rede a domínios arkoselabs.com. Abra o DevTools, aba Network, recarregue a página — requisições a client-api.arkoselabs.com ou subdomínio semelhante indicam FunCaptcha ativo.

A chave privada pertence à verificação no servidor e nunca deve aparecer no código do cliente. A chave pública serve para a inicialização client-side do Arkose FunCaptcha.

Se um desenvolvedor trocar as chaves, a integração normalmente falha.

Para garantir que o backend processe verificações Arkose de forma estável e segura, recomendamos testar três cenários críticos:

  • requisição sem session_token — deve ser rejeitada;
  • token expirado — o servidor deve retornar erro;
  • reutilização do mesmo token — a segunda verificação deve ser negada, os tokens são de uso único.

Quando o CapMonster Cloud retorna um token FunCaptcha, ele deve ser passado à página pelo callback registrado pelo Arkose na inicialização.

No exemplo Playwright da seção "Colocar o token na página", isso acontece automaticamente:

  • O script se conecta ao contexto de execução JavaScript da página.
  • Verifica se o objeto global Arkose está exposto como FunCaptcha ou ArkoseEnforcement.
  • Aplica patch no método render() para capturar o callback original.
  • Após resolver, chama esse callback com o token.

O token resolvido é injetado na página como esperado, sem ação manual no cliente.