> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ativar o Cloudflare Turnstile para proteger formulários

> Ative o Cloudflare Turnstile para proteger os formulários das suas landing pages contra bots sem CAPTCHA, melhorando a segurança e a experiência dos visitantes.

> Adicione o Cloudflare Turnstile às suas landing pages no LanderLab para proteger seus formulários contra bots e envios de spam, sem pedir que os visitantes resolvam um desafio de CAPTCHA.

## O que é o Cloudflare Turnstile?

O Cloudflare Turnstile é uma ferramenta gratuita de proteção contra bots que substitui os desafios tradicionais de CAPTCHA. Em vez de pedir que os visitantes identifiquem semáforos ou digitem textos distorcidos, o Turnstile verifica os visitantes silenciosamente em segundo plano, usando sinais do navegador e análise de comportamento.

Para a maioria dos visitantes legítimos, o Turnstile é totalmente invisível. Só o tráfego suspeito recebe um desafio, o que significa que seus formulários continuam protegidos sem criar atrito para os usuários reais.

O LanderLab cuida da instalação do script do Turnstile para você. Depois que a integração é adicionada com a sua Site Key, o Turnstile fica ativo automaticamente nos formulários da sua landing page.

<Note>
  Depois que você adiciona uma integração com o Turnstile, ela fica salva **globalmente** na sua conta. Você pode reutilizá-la em várias landing pages sem precisar informar os dados novamente.
</Note>

***

## Antes de começar

Antes de adicionar o Turnstile no LanderLab, você precisa criar um widget do Turnstile na sua conta da Cloudflare e obter a sua **Site Key**. Isso leva cerca de 2 minutos.

<Steps>
  <Step title="Faça login na Cloudflare">
    Acesse [dash.cloudflare.com](https://dash.cloudflare.com) e faça login. Se você não tiver uma conta da Cloudflare, pode se cadastrar gratuitamente em [cloudflare.com](https://www.cloudflare.com).
  </Step>

  <Step title="Abra o Turnstile">
    Na barra lateral esquerda do seu painel da Cloudflare, clique em **Turnstile**. Isso leva você à página de gerenciamento de widgets do Turnstile.
  </Step>

  <Step title="Crie um novo widget">
    Clique em **Add Widget** e preencha o seguinte:

    | Campo           | O que informar                                                                                                        |
    | :-------------- | :-------------------------------------------------------------------------------------------------------------------- |
    | **Widget name** | Um nome descritivo para este widget (ex.: "Formulários do LanderLab").                                                |
    | **Hostname**    | Clique em **Add Hostname** e informe o domínio da sua landing page (ex.: `yourdomain.com`, sem `https://` nem `www`). |
    | **Widget mode** | Escolha o modo mais adequado à sua configuração. Veja a explicação dos modos de widget abaixo.                        |

    Clique em **Create** para salvar o widget.
  </Step>

  <Step title="Copie a sua Site Key">
    Depois de criar o widget, a Cloudflare exibirá a sua **Site Key** e a Secret Key. Copie a **Site Key** (ela é parecida com `0x4AAAAAAA...`). Para o LanderLab, você só precisa da Site Key.

    <Note>
      Mantenha a sua **Secret Key** em sigilo e não a compartilhe. O LanderLab só precisa da Site Key.
    </Note>
  </Step>
</Steps>

***

## Entenda os modos de widget

O Cloudflare Turnstile oferece três modos de widget. Escolha o que atende às suas necessidades ao criar o widget no seu painel da Cloudflare.

| Modo                | Como funciona                                                                                                                                                                      |
| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Managed**         | A Cloudflare decide automaticamente. A maioria dos visitantes passa sem perceber. Só o tráfego suspeito vê um desafio. Esse é o modo recomendado para a maioria das landing pages. |
| **Non-Interactive** | Sempre exibe um pequeno widget visível, mas os visitantes não precisam clicar nem interagir com ele. Útil se você quiser um indicador de segurança visível.                        |
| **Invisible**       | Totalmente silencioso. Nenhum widget é exibido. A verificação acontece inteiramente em segundo plano.                                                                              |

<Tip>
  Para landing pages de geração de leads, o **modo Managed** costuma ser a melhor escolha. Ele mantém a experiência fluida para os visitantes reais e bloqueia os envios feitos por bots.
</Tip>

***

## Como adicionar o Turnstile no LanderLab

<Steps>
  <Step title="Acesse sua landing page">
    Vá até **Landing Pages** e clique no **nome da landing page** em que você quer ativar a proteção contra bots do Turnstile.
  </Step>

  <Step title="Abra a aba de integrações">
    Clique em **Add Integration** para abrir o painel de integrações.
  </Step>

  <Step title="Selecione o Turnstile">
    Na lista de integrações disponíveis, encontre **Turnstile** (com a descrição "Protect your forms from bots with Turnstile") e clique nele. Um formulário de configuração será exibido.
  </Step>

  <Step title="Preencha os campos obrigatórios">
    Informe os seguintes dados:

    | Campo        | Descrição                                                                                                                                                      |
    | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Name**     | Um nome para identificar esta integração (ex.: "Turnstile"). Ajuda você a reconhecê-la ao reutilizá-la em outras páginas.                                      |
    | **Site Key** | A Site Key do seu widget do Cloudflare Turnstile (ex.: `0x4AAAAAAA...`). Você a encontra no seu painel da Cloudflare, em Turnstile, depois de criar um widget. |
  </Step>

  <Step title="Clique em Add Turnstile">
    Clique no botão **Add Turnstile** para salvar a integração. O LanderLab a armazena globalmente, para que você possa conectá-la a outras landing pages depois sem precisar informar os dados novamente.
  </Step>

  <Step title="Publique sua landing page">
    Clique em **Publish** ou **Republish** na sua landing page para ativar o Turnstile nos seus formulários. Não é necessária nenhuma configuração adicional no editor de formulários.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/HMKrQYFyvSl4tVFf/images/turnstile.png?fit=max&auto=format&n=HMKrQYFyvSl4tVFf&q=85&s=3f997793d00d9554271d930dc42fdb52" alt="Turnstile" width="1920" height="991" data-path="images/turnstile.png" />
</Frame>

***

## Conectar o Turnstile a outra landing page

Como as integrações com o Turnstile são salvas globalmente, você não precisa criar uma nova para cada landing page. É possível reutilizar qualquer integração salva anteriormente em várias páginas.

<Steps>
  <Step title="Abra outra landing page">
    Acesse **Landing Pages** e clique no nome da landing page em que você quer usar a mesma integração com o Turnstile.
  </Step>

  <Step title="Adicione a integração">
    Clique em **Add Integration**. Você verá as configurações do Turnstile salvas anteriormente. Selecione a que você quer conectar.
  </Step>

  <Step title="Selecione as variantes (se for o caso)">
    Se a sua landing page tiver várias **variantes de teste A/B**, será exibido um modal pedindo que você escolha quais variantes devem usar esta integração. Selecione as variantes desejadas e confirme.

    <Note>
      O modal de seleção de variantes só aparece quando a sua landing page tem mais de uma variante ativa. Se houver apenas uma variante, a integração será aplicada automaticamente.
    </Note>
  </Step>

  <Step title="Salve e publique">
    Clique em **Save** e depois em **Publish** ou **Republish** na sua landing page para ativar o Turnstile nas variantes selecionadas.
  </Step>
</Steps>

***

## Como verificar se o Turnstile está funcionando

Depois que a sua landing page for publicada com o Turnstile ativado:

1. Abra a **URL publicada da landing page** no seu navegador.
2. Envie o formulário com dados de teste.
3. O Turnstile validará o envio automaticamente em segundo plano.

Para confirmar que ele está funcionando no lado da Cloudflare:

1. Volte ao seu [painel da Cloudflare](https://dash.cloudflare.com).
2. Clique em **Turnstile** na barra lateral.
3. Selecione o seu widget.
4. Confira a seção **Analytics**. Depois de alguns envios de teste, você deverá ver **Challenges issued** e uma porcentagem de **Likely human**.

<Tip>
  O Turnstile funciona de forma silenciosa para a maioria dos visitantes, então provavelmente você não verá nenhum widget visível na sua página, a menos que tenha escolhido o modo Non-Interactive. Esse é o comportamento esperado.
</Tip>