Configurando o Cloudflare Turnstile

Gostaria de usar o Cloudflare Turnstile para ajudar a prevenir envios de spam em seus formulários do WordPress? O Cloudflare Turnstile é uma alternativa gratuita, semelhante a um CAPTCHA, que oferece uma experiência amigável ao confirmar que os visitantes são humanos reais, sem mostrar nenhum quebra-cabeça.

Este tutorial mostrará como configurar e usar o Cloudflare Turnstile com o WPForms.


Antes de começar, certifique-se de que o WPForms esteja instalado e ativado em seu site WordPress.

Gerando Chaves de API do Cloudflare Turnstile

Para começar, faça login na sua área de administração do WordPress e vá para WPForms » Configurações. Em seguida, clique na guia CAPTCHA.

Configurações de CAPTCHA do WPForms

Para configurar o Cloudflare Turnstile, selecione a opção Turnstile.

Selecionar opção Turnstile

Uma vez selecionado, configurações adicionais aparecerão. Você precisará gerar um conjunto de chaves de API da sua conta Cloudflare para conectá-la ao WPForms. Deixe esta aba do navegador aberta e prossiga para a próxima etapa.

Adicionando Seu Site no Cloudflare

Para começar, você precisará fazer login na sua conta Cloudflare. Depois de fazer login, selecione o menu Turnstile e clique em Adicionar widget.

Clicar no botão adicionar site

Em seguida, você verá uma opção para inserir o nome do seu site no campo Nome do widget. Este nome é apenas para uso interno para ajudá-lo a identificar widgets em sua conta Cloudflare.

Em seguida, em Gerenciamento de Hostnames, clique no botão + Adicionar Hostnames.

Uma barra lateral aparecerá onde você pode adicionar seu site. No campo Adicionar um hostname personalizado, digite o nome do seu domínio (por exemplo, exemplo.com) e clique no botão Adicionar ao lado dele.

Assim que ele aparecer na lista, clique no botão Adicionar na parte inferior do painel para confirmar.

Você pode adicionar vários sites na seção Gerenciamento de Hostnames. Isso permite que você use um conjunto de chaves de API em vários sites.

Depois disso, role para baixo até a seção Modo do Widget. Recomendamos mantê-lo definido como Gerenciado, que é a opção padrão.

Selecionar tipo de widget
  • Gerenciado: Esta opção permite que o Cloudflare decida se deve mostrar um desafio interativo ou verificar automaticamente o usuário com base nos dados e interações do navegador dele.
  • Não interativo: Esta opção mostrará o widget CAPTCHA no frontend do seu site. No entanto, não requer interação do usuário. O Cloudflare executará automaticamente o desafio e verificará o usuário.
  • Invisível: Esta opção é executada em segundo plano e não requer interação do usuário.

Após escolher o tipo de widget, clique no botão Criar para adicionar seu site.

Clicar no botão criar

Isso geraria um conjunto exclusivo de chaves de API para o seu site.

Você precisará copiar a Chave do Site e a Chave Secreta do Cloudflare. Em seguida, volte para a página de configurações do WPForms e cole cada chave em seu campo correspondente.

Cole os valores da chave do site e da chave secreta nas configurações do WPForms

Depois de adicionar ambas as chaves, prossiga para configurar configurações adicionais para o Cloudflare Turnstile CAPTCHA.

Configurando Configurações Adicionais

Abaixo da Chave Secreta, você encontrará a opção para atualizar a Mensagem de Falha. Esta é a mensagem exibida quando um usuário tenta enviar um formulário sem completar o desafio de verificação do Cloudflare Turnstile.

Configurar mensagem de falha

Em seguida, escolha o estilo que você gostaria que o widget usasse no menu suspenso Tipo. As opções disponíveis são: Automático, Claro e Escuro.

Selecionar tipo de Captcha

Usar o modo padrão Automático para o seu widget alternará entre os modos Claro e Escuro, dependendo das configurações do dispositivo do usuário.

Após escolher o tipo de CAPTCHA, você encontrará as configurações do Modo Sem Conflito. Se o Cloudflare Turnstile estiver sendo carregado mais de uma vez em seu site (por exemplo, tanto pelo WPForms quanto pelo seu tema do WordPress), isso pode impedir que o Turnstile CAPTCHA funcione corretamente.

Modo de visualização e sem conflitos

O Modo Sem Conflito removerá qualquer código do Cloudflare Turnstile que não seja carregado pelo WPForms. No entanto, recomendamos fortemente entrar em contato com nossa equipe de suporte se você tiver alguma dúvida sobre o uso desta opção.

Em seguida, você verá a seção Visualizar. Isso mostra como o widget CAPTCHA aparecerá no frontend do seu site.

Observação: Você precisará salvar suas configurações antes de poder ver uma visualização do widget.

Quando estiver pronto, clique no botão Salvar Configurações.

Clique no botão Salvar configurações

Após salvar suas configurações, você deverá ver uma prévia do widget Cloudflare Turnstile.

Visualização do Captcha da Cloudflare

Adicionando o Cloudflare Turnstile a um Formulário

Agora que você configurou suas chaves, poderá ativar o Cloudflare Turnstile em qualquer um dos seus formulários.

Para isso, crie um novo formulário ou edite um existente para acessar o construtor de formulários. Em seguida, procure em Campos Padrão e selecione o campo Turnstile.

Adicionando Turnstile a um formulário

Alternativamente, você sempre pode ativar ou desativar o Cloudflare Turnstile para um formulário indo em Configurações » Proteção contra Spam e Segurança no construtor de formulários.

Configurações de proteção contra spam e segurança

Na seção Proteção, você pode ativar a opção Armazenar entradas de spam no banco de dados se desejar revisar as entradas de spam antes de excluí-las da página de entradas.

Opção Armazenar entradas de spam no banco de dados

Ativar esta opção permite todas as submissões, incluindo aquelas sinalizadas como spam pelo Cloudflare Turnstile.

A opção Ativar tempo mínimo para enviar ajuda a prevenir submissões de bots, definindo um tempo mínimo antes que as submissões sejam permitidas no formulário. Veja nosso guia de prevenção de spam para mais detalhes.

Em seguida, role para baixo até a seção CAPTCHA e ative a opção Ativar Cloudflare Turnstile para a posição ligada.

Ativando o Cloudflare Turnstile nas configurações de proteção contra spam

Para confirmar que o Cloudflare Turnstile está ativado, procure pelo selo Turnstile no canto superior direito do construtor de formulários.

Selo Turnstile no construtor de formulários

Observação: Se nenhum selo aparecer no seu construtor de formulários, certifique-se de ter configurado corretamente suas chaves de API do Cloudflare Turnstile.

Testando o Cloudflare Turnstile

O último passo é executar um teste rápido para garantir que o Cloudflare Turnstile pareça e funcione como você espera.

Para testar, você só precisa enviar uma entrada para o seu formulário. Para mais detalhes sobre como testar seus formulários, consulte nossa lista completa de verificação de testes de formulários.

Visualizando Entradas de Spam

Se você ativou a opção de armazenamento de entradas de spam, poderá visualizar as entradas identificadas como spam na página de Entradas.

Há também uma opção para recuperar entradas que podem ter sido erroneamente sinalizadas como spam pelo Cloudflare Turnstile.

Spam detectado pelo Cloudflare Turnstile

Para um guia detalhado, por favor, veja nosso tutorial sobre visualizar e gerenciar entradas de spam.

Perguntas Frequentes

Estas são respostas para algumas perguntas frequentes sobre a configuração do Cloudflare Turnstile com WPForms.

Posso ver os dados de análise do CAPTCHA Turnstile da minha conta Cloudflare?

O Cloudflare inclui um painel de análise que mostra uma visão geral dos desafios do CAPTCHA Turnstile para cada formulário ao qual você adicionou o Turnstile.

Para visualizar as análises do Turnstile para seus formulários WordPress, faça login na sua conta Cloudflare e selecione o menu lateral Turnstile. Em seguida, selecione o nome do seu site para abrir o painel de análise.

Selecionar nome do site

Isso mostrará relatórios contendo todos os formulários aos quais você adicionou o Cloudflare Turnstile. Você pode filtrar os dados para mostrar relatórios de um formulário específico.

Para usar a opção de filtro, clique no botão Adicionar filtro.

Clique no botão Adicionar filtro

Em seguida, você precisará inserir o ID do formulário na condição Novo filtro usando a sintaxe FormID-XX. Onde XX é o ID do formulário do qual você deseja ver os dados do Cloudflare Turnstile.

Você sempre pode encontrar o ID do seu formulário no seu painel WordPress indo em WPForms » Todos os Formulários e verificando na coluna Shortcode.

ID do WPForms

Para nosso exemplo, definimos o filtro para: Ação é igual a FormID-43. Clique no botão Aplicar para adicionar o filtro.

Aplicar filtro

Depois de aplicar o filtro, ele mostrará os dados de análise para o formulário específico que você selecionou.

Análise de CAPTCHA do formulário

É isso! Agora você sabe como configurar e usar o Cloudflare Turnstile com WPForms.

Em seguida, você gostaria de aprender mais maneiras de prevenir spam no WPForms? Certifique-se de conferir nosso tutorial completo sobre prevenção de envios de spam para saber mais.

O Melhor Plugin Construtor de Formulários de Arrastar e Soltar para WordPress

Fácil, Rápido e Seguro. Junte-se a mais de 6 milhões de proprietários de sites que confiam no WPForms.