Como corrigir o erro de reCAPTCHA no WPForms
Perguntas frequentes
Por que o WPForms mostra 'Error for site owner: Invalid site key'?
Porque a Site Key colada no WPForms não corresponde a uma chave válida para o seu site no Google. Geralmente é chave copiada com espaço extra, chave de outro tipo de reCAPTCHA, ou chave apagada da conta do Google. Confira em WPForms -> Settings -> CAPTCHA se a chave bate com a do painel do Google e, se preciso, gere um par novo.
O que significa 'Invalid domain for site key' no formulário?
Significa que o domínio onde o formulário está rodando não está cadastrado na chave do Google reCAPTCHA. Abra a chave no painel do Google e adicione o domínio na lista de domínios. Use o domínio puro, sem o protocolo nem o www: seusite.com.br é aceito, mas https://www.seusite.com.br não.
Posso usar reCAPTCHA v2 e v3 no mesmo site com WPForms?
Cada tipo de reCAPTCHA usa um par de chaves próprio e a aba CAPTCHA do WPForms guarda um tipo por vez. Se você trocar de v2 para v3, ou vice-versa, precisa gerar chaves novas do tipo escolhido no Google e atualizar as chaves no WPForms, senão o desafio falha com chave inválida.
O reCAPTCHA não aparece no meu formulário. O que fazer?
No v2 Checkbox o campo precisa ser adicionado no construtor, em Standard Fields. No v2 Invisible e no v3 não existe campo visível: a proteção é ligada nas configurações do formulário e roda em segundo plano. Se nem assim funciona, confirme que as chaves estão salvas em WPForms -> Settings -> CAPTCHA e teste em janela anônima.
Por que aparece 'verification failed' só depois que liguei o cache?
Porque o plugin de cache minificou, combinou ou adiou o JavaScript e quebrou o api.js do reCAPTCHA. Desligue a otimização de JavaScript no WP Rocket ou Autoptimize, limpe os caches e teste. Quando voltar a funcionar, exclua o api.js do Google da minificação para manter o cache ligado sem quebrar o reCAPTCHA.
O formulário diz que o campo do reCAPTCHA é obrigatório mesmo eu marcando. Por quê?
Quase sempre há dois scripts de reCAPTCHA carregando na mesma página, um do WPForms e outro de um plugin antispam ou do tema. O conflito impede a validação de concluir. Abra o console do navegador para confirmar o script duplicado e ative o No-Conflict Mode em WPForms -> Settings -> CAPTCHA.
Minhas chaves antigas pararam de funcionar. É problema do WPForms?
Não. O Google migrou o reCAPTCHA para o Google Cloud e chaves do painel legado podem deixar de validar, com 'Invalid key type' ou aviso de que a chave não protege o site. Gere um par novo no painel atual do Google, cole no WPForms selecionando o tipo correspondente e salve.
No reCAPTCHA v3 alguns visitantes legítimos não conseguem enviar. Como ajustar?
O v3 dá uma nota de 0.0 (provável bot) a 1.0 (provável humano) e barra quem fica abaixo do Score Threshold. Se visitantes reais estão sendo bloqueados, reduza o Score Threshold em WPForms -> Settings -> CAPTCHA para um valor mais permissivo e acompanhe os envios antes de subir de novo.














