CaptchaNo
[ INTEGRAÇÃO ]

Solucionador de captcha para
n8n

Resolva o desafio dentro da execução em vez de deixar o job falhar. Um exemplo funcional em JSON e os três fatores que decidem se o seu token é aceito.

n8n · JSON
HTTP Request node
  Method:          POST
  URL:             https://api.captchano.com/v1/solve?wait=60
  Authentication:  Header Auth
                   Name:  Authorization
                   Value: Bearer cn-YOUR_API_KEY
  Send Body:       JSON
  Body:
  {
    "type": "turnstile",
    "sitekey": "{{ $json.sitekey }}",
    "url": "{{ $json.pageUrl }}"
  }

The node outputs { status, solution: { token, userAgent }, cost } —
pass {{ $json.solution.token }} to the next step.

O que decide se o token é aceito

  1. Repasse seu proxy. O token deve ser gerado por trás do mesmo IP de saída que o envia. Em sistemas que avaliam a sessão, isso é obrigatório, não uma otimização.
  2. Use o mesmo user agent. O Turnstile e vários sistemas anti-bot vinculam o token a um user agent. Retornamos o que foi usado para que você possa reutilizá-lo exatamente.
  3. Solicite no último momento. Os tokens expiram em cerca de 120 segundos. Peça um quando estiver pronto para enviar.

Bloqueante ou polling

O exemplo usa ?wait=60, então a chamada retorna a resolução pronta e a sua etapa no n8n continua linear. Se você preferir não manter uma conexão aberta, remova o parâmetro, guarde o id retornado e faça polling em GET /v1/task/{id} a cada cinco segundos. Um token pelo qual você já pagou continua disponível por dez minutos, então uma conexão perdida não faz você perder a resolução.

Custo

$0.00598 por resolução bem-sucedida de reCAPTCHA v2, e resoluções que falham nunca são cobradas. Veja os preços de todos os tipos de desafio ou a referência da API para o formato completo da requisição.

[ COMO SE ENCAIXA ]

Como a resolução se encaixa no n8n

No n8n, a resolução é um único nó HTTP Request entre a etapa que carrega a página e a etapa que a envia.

  1. 01
    Adicione credenciais

    Crie uma credencial Header Auth com Authorization: Bearer cn-…

  2. 02
    Adicione um nó HTTP Request

    Faça POST para a API com ?wait=60 e um corpo JSON montado a partir dos nós anteriores.

  3. 03
    Mapeie o token

    Use uma expressão para passar solution.token ao próximo nó.

  4. 04
    Trate falhas

    Crie um desvio pelo status para que uma resolução com falha tente novamente ou gere um alerta, em vez de enviar nada.

Colocando o token na página

Mapeie o token da saída do nó HTTP Request para o campo da requisição ou do nó de navegador que envia o formulário.

[ ARMADILHAS ]

Onde as integrações costumam dar errado

Timeout do nó

Aumente o timeout do nó HTTP Request para acima do valor de wait, ou ele vai interromper a chamada.

Chaves fixas no código

Guarde a chave nas credenciais do n8n, não no corpo do nó, para que ela não seja exportada junto com o workflow.

[ FAQ ]

Perguntas frequentes sobre captcha no n8n

Existe um community node da CaptchaNo?

Não, e você não precisa de um. O nó HTTP Request nativo cobre toda a API com uma única chamada.

Um agente de IA do n8n pode chamar o solucionador?

Sim. Exponha o HTTP Request como ferramenta para o nó AI Agent, como mostrado no nosso guia de agentes no n8n.

Funciona no n8n cloud e self-hosted?

Sim. É uma chamada HTTPS de saída, que ambos permitem.

Como manter os custos previsíveis em um workflow?

Toda resposta inclui o custo da resolução. Some esse valor no workflow e pare quando atingir um orçamento.

[ LEIA A SEGUIR ]

Guias que ajudam

Pronto para começar?

Comece com um teste grátis de 3 dias e depois pague por resolução bem-sucedida conforme seu tráfego cresce. Não é preciso cartão para o teste.

Ver nossos planos
Você é um agente de IA? Veja as opções de configuração →