reCAPTCHA: o que é e como usar no formulário do site
Conheça a caixa Não sou um robô, a versão invisível e a nota da v3, registre as chaves, valide o token pela API siteverify e veja cota, preço e aviso de privacidade.
Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: reCAPTCHA: o que é e como usar no formulário do site Arte: Eleven Host
reCAPTCHA é o serviço do Google que ajuda a proteger sites contra spam, fraude e abuso. No formulário, ele aparece como a caixa "Não sou um robô" ou trabalha em segundo plano, com uma nota de risco que o servidor do site confere.
Pela documentação do Google, o reCAPTCHA usa duas chaves: a chave do site, que vai na página, e a chave secreta, que fica só no servidor. Cada token gerado no formulário vale dois minutos e só pode ser verificado uma vez pela API siteverify.
O que é o reCAPTCHA
Segundo a introdução da documentação para desenvolvedores do Google, existem hoje o reCAPTCHA v3, o reCAPTCHA v2 e o reCAPTCHA Enterprise, todos com a proposta de ajudar a proteger sites de fraude, spam e abuso.
No navegador, um script do Google gera um token, uma espécie de comprovante. No servidor, esse token vai ao Google com a chave secreta, e a resposta diz se a verificação passou.
Em 19/11/2026, a documentação do Google Cloud apresenta o serviço com o nome Google Cloud Fraud Defense. A FAQ do Google Cloud informa que, para quem já usa o reCAPTCHA, as chaves e integrações existentes continuam funcionando sem mudança de código ou de configuração.
Na página, o reCAPTCHA pode aparecer como uma caixa dentro do formulário ou como um selo.
Quem tem um endereço em mente pode buscá-lo entre centenas de extensões na Eleven Host. Pesquisar nome
As versões e quando escolher cada uma
A página de versões do reCAPTCHA descreve três formas principais de uso no site.
v2 com caixa de seleção
É a caixa "Não sou um robô". O visitante marca a caixa e, conforme o risco calculado, passa direto ou recebe um desafio para provar que é uma pessoa. O Google a descreve como a opção mais simples.
v2 invisível
Não mostra caixa. O desafio é chamado quando o visitante clica num botão do site, como o de enviar, ou por uma chamada em JavaScript, e a integração exige uma função de retorno. Pela documentação, por padrão só o tráfego mais suspeito recebe desafio.
v3 com pontuação
A v3 não mostra desafio ao visitante: ela devolve uma nota para cada requisição, e o site decide o que fazer. A nota vai de 0.0 a 1.0. Perto de 1.0, a interação provavelmente é boa; perto de 0.0, provavelmente é um robô. A página de versões cita como usos pedir uma etapa extra de autenticação ou mandar o envio para moderação.
O limiar padrão da v3 é 0.5. A própria documentação sugere começar só observando as notas, sem bloquear nada, e depois definir os limiares olhando o tráfego do próprio site no console de administração.
Como escolher a versão
- v2 caixa de seleção: quando um clique a mais não atrapalha o visitante.
- v2 invisível: quando o desafio deve ficar só para casos suspeitos.
- v3: quando o servidor vai receber a nota e decidir, por exemplo, mandar a mensagem para revisão.
Como colocar o reCAPTCHA no formulário
A introdução da documentação do Google segue esta ordem: registrar o site, receber as chaves, colocar o script e verificar a resposta no servidor.
1. Registrar o site e receber as chaves
O registro é feito na ferramenta de cadastro do reCAPTCHA, no endereço google.com/recaptcha/admin/create. Nela você escolhe o tipo de reCAPTCHA, informa os domínios autorizados, aceita os termos de serviço e registra.
A FAQ do Google Cloud informa que não é mais possível criar chaves clássicas novas e recomenda a migração a quem já tem uma; as telas do registro podem mudar, então confira no painel do Google o que ele oferece hoje.
No fim do registro saem duas chaves. A chave do site vai no HTML da página e chama o serviço. A chave secreta é usada pelo servidor para falar com o reCAPTCHA, e a documentação pede que ela seja mantida em segurança. Recomendamos guardar a chave secreta só no servidor, fora do HTML e fora de repositórios públicos de código.
A FAQ do reCAPTCHA aconselha chaves separadas para desenvolvimento e produção; o localhost não é aceito por padrão e, se precisar, entra só na chave de desenvolvimento.
2. Colocar o script e a caixa (v2)
Pela documentação de exibição da v2, o script do Google entra na página e uma div com a classe g-recaptcha e a chave do site entra dentro do formulário. O script deve ser carregado por HTTPS. Um exemplo, montado a partir desses trechos e não testado, para adaptar ao seu formulário:
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
<form action="/contato.php" method="POST">
<input type="email" name="email">
<div class="g-recaptcha" data-sitekey="SUA_CHAVE_DO_SITE"></div>
<button type="submit">Enviar</button>
</form>
Quando o visitante envia o formulário, o navegador manda ao servidor um campo POST chamado g-recaptcha-response, com o token. Troque /contato.php pelo script que recebe o seu formulário.
3. Gerar o token na v3
Na v3, o token é pedido com grecaptcha.execute, informando o nome da ação. Um exemplo, montado a partir da documentação da v3 e não testado:
<script src="https://www.google.com/recaptcha/api.js?render=SUA_CHAVE_DO_SITE"></script>
grecaptcha.ready(function() {
grecaptcha.execute('SUA_CHAVE_DO_SITE', {action: 'submit'}).then(function(token) {
// envie o token ao servidor junto com o formulário
});
});
Como o token expira em dois minutos, a documentação orienta chamar o execute na hora em que o visitante age, e não ao carregar a página.
4. Verificar o token no servidor
A verificação é um POST para https://www.google.com/recaptcha/api/siteverify. A documentação lista dois parâmetros obrigatórios, secret (a chave secreta) e response (o token recebido do formulário), e um opcional, remoteip, com o IP do visitante. Um exemplo de comando, montado a partir dessa documentação e não testado, com marcadores no lugar dos valores reais:
curl -X POST https://www.google.com/recaptcha/api/siteverify -d "secret=SUA_CHAVE_SECRETA" -d "response=TOKEN_DO_FORMULARIO"
A resposta vem em JSON, com os campos success, challenge_ts, hostname e, quando houver, error-codes. Na v3 chegam também score e action.
Recomendamos que o script do servidor só aceite o envio quando success vier verdadeiro, quando o hostname for o do seu domínio e, na v3, quando a ação for a esperada e a nota passar do limiar escolhido.
reCAPTCHA no WordPress
No diretório oficial de plugins do WordPress, existem plugins de reCAPTCHA. Recomendamos conferir na descrição do plugin qual versão do reCAPTCHA ele aceita e se combina com o formulário do site.
O arquivo de configuração do WordPress é assunto de wp-config.php: o que é e como editar com segurança.
Cota e preço no Google Cloud
Em 19/11/2026, a página de comparação de níveis do Google Cloud lista três níveis: Essentials, Premium e Enterprise. O Essentials é grátis até 10.000 avaliações por mês do calendário, e esse limite é por organização, somando todos os sites e contas.
No Premium, que exige uma forma de pagamento cadastrada no Google Cloud, as primeiras 10.000 avaliações do mês também são grátis. De 10.001 a 100.000, a mesma página informa uma taxa fixa de US$ 8,00 no mês e, acima de 100.000, US$ 1,00 a cada 1.000 avaliações.
Em 19/11/2026, a página de cobrança do Google Cloud informa que um projeto sem cobrança que passa das 10.000 avaliações recebe erro de cota até a cota zerar, no primeiro dia do mês seguinte. Confira a página do Google antes de decidir.
O que o reCAPTCHA não resolve
O reCAPTCHA ajuda com envios automáticos, mas não faz o trabalho do restante do site. Recomendamos manter a validação dos campos no servidor, como tamanho, formato do e-mail e campos obrigatórios, porque o que chega ao servidor pode não ter passado pelo navegador.
Também recomendamos limitar o número de envios por período, manter o site e os plugins atualizados e olhar outras camadas de proteção. Um firewall de aplicação web é tema de WAF: o que é firewall de aplicação web e como usar, e os cabeçalhos que o navegador recebe estão em Cabeçalhos de segurança HTTP: quais usar no site.
Privacidade e aviso no site
A FAQ do Google Cloud informa que, a partir de 2 de abril de 2026, as referências à Política de Privacidade e aos Termos de Uso do Google saem do selo do reCAPTCHA. Segundo a mesma página, a mudança reflete o papel do cliente como controlador dos dados e do Google como operador. A FAQ recomenda que os clientes também retirem essas referências do próprio site e revisem os avisos de privacidade ao usuário, para cobrir a finalidade do tratamento feito pelo serviço.
A FAQ do reCAPTCHA para desenvolvedores permite esconder o selo, desde que a marca reCAPTCHA apareça de forma visível no fluxo do usuário, com o texto em inglês This site is protected by reCAPTCHA. A regra de CSS da página para esconder o selo é esta:
.grecaptcha-badge { visibility: hidden; }
Recomendamos citar na política de privacidade do site o uso do serviço do Google no formulário e a finalidade, e conferir o texto com quem cuida da parte jurídica, à luz da LGPD.
Uma página de contato enxuta
Recomendamos rótulos claros em cada campo e uma mensagem de confirmação depois do envio, para o visitante saber que a mensagem saiu.
Escolher entre os planos de VPS da Eleven Host começa pela loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer VPS
Perguntas frequentes
Qual versão do reCAPTCHA usar no formulário de contato?
A v2 com caixa pede um clique, a v2 invisível chama o desafio no botão de enviar e a v3 devolve uma nota para o servidor decidir, sem desafio na tela.
O que significa a nota da v3?
Pela documentação do Google, quanto mais perto de 1.0, mais provável que a interação seja legítima; perto de 0.0, que seja um robô. O limiar padrão é 0.5, e a documentação sugere ajustar pelo tráfego do site.
Posso esconder o selo do reCAPTCHA?
A FAQ do reCAPTCHA permite, desde que a marca apareça de forma visível no fluxo do usuário, com o texto This site is protected by reCAPTCHA.