> ## 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 Google reCAPTCHA v3 para proteger formulários

> Ative o Google reCAPTCHA v3 para proteger os formulários das suas landing pages contra bots e spam sem nenhum desafio visível nem interrupção para os visitantes.

> Adicione o Google reCAPTCHA v3 às suas landing pages no LanderLab para proteger seus formulários contra bots e spam sem pedir que os visitantes resolvam nenhum desafio nem cliquem em nenhuma caixa de seleção.

## O que é o reCAPTCHA v3?

O Google reCAPTCHA v3 funciona inteiramente em segundo plano. Ele analisa o comportamento de cada visitante na sua página e atribui uma pontuação entre 0,0 e 1,0, em que 1,0 significa muito provavelmente humano e 0,0 significa muito provavelmente um bot. Essa pontuação é usada para decidir se um envio de formulário deve ser aceito ou bloqueado.

Os visitantes nunca veem um desafio, uma caixa de seleção nem qualquer widget visível. Para os usuários reais, a experiência é totalmente fluida. Os envios feitos por bots são bloqueados silenciosamente.

O LanderLab cuida da instalação do script do reCAPTCHA v3 e da verificação do token no servidor para você. Depois que a integração é adicionada com a sua Site Key e a sua Secret Key, o reCAPTCHA v3 fica ativo automaticamente nos formulários da sua landing page.

<Note>
  Depois que você adiciona uma integração com o reCAPTCHA v3, 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 reCAPTCHA v3 no LanderLab, você precisa registrar o seu site no Google reCAPTCHA Admin Console e obter a sua **Site Key** e a sua **Secret Key**. Isso leva cerca de 2 minutos.

<Steps>
  <Step title="Acesse o reCAPTCHA Admin Console">
    Abra o [Google reCAPTCHA Admin Console](https://www.google.com/recaptcha/admin) e faça login com a sua conta do Google.
  </Step>

  <Step title="Registre um novo site">
    Clique no botão **+** (ou em **Create**) para registrar um novo site. Preencha o seguinte:

    | Campo              | O que informar                                                                           |
    | :----------------- | :--------------------------------------------------------------------------------------- |
    | **Label**          | Um nome para identificar esta chave (ex.: "LanderLab - reCAPTCHA v3").                   |
    | **reCAPTCHA type** | Selecione **Score based (v3)**.                                                          |
    | **Domains**        | Informe o domínio da sua landing page (ex.: `yourdomain.com`, sem `https://` nem `www`). |
  </Step>

  <Step title="Aceite os termos e envie">
    Aceite os Termos de Serviço do reCAPTCHA e clique em **Submit**.
  </Step>

  <Step title="Copie as duas chaves">
    Depois do envio, o Google exibirá a sua **Site Key** e a sua **Secret Key**. Copie as duas. Você precisará de ambas para adicionar o reCAPTCHA v3 no LanderLab.

    | Chave          | O que faz                                                                                                           |
    | :------------- | :------------------------------------------------------------------------------------------------------------------ |
    | **Site Key**   | É carregada na sua página para executar o desafio do reCAPTCHA no navegador do visitante. É uma chave pública.      |
    | **Secret Key** | É usada no servidor para verificar o token do visitante com o Google. É uma chave privada: mantenha-a em segurança. |

    <Warning>
      Nunca compartilhe a sua **Secret Key** publicamente. Diferentemente da Site Key, a Secret Key é uma credencial privada usada na verificação no servidor. Mantenha-a fora de qualquer código público, repositório ou documento compartilhado.
    </Warning>
  </Step>
</Steps>

***

## Como adicionar o reCAPTCHA v3 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 do reCAPTCHA v3.
  </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 reCAPTCHA v3">
    Na lista de integrações disponíveis, encontre **reCAPTCHA v3** (com a descrição "Protect your forms from bots with reCAPTCHA v3") 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.: "reCAPTCHA v3"). Ajuda você a reconhecê-la ao reutilizá-la em outras páginas.   |
    | **Site Key**   | A Site Key pública obtida no registro do Google reCAPTCHA (ex.: `6LcX...`).                                                    |
    | **Secret Key** | A Secret Key privada obtida no registro do Google reCAPTCHA (ex.: `6LcX...`). É usada para a verificação do token no servidor. |
  </Step>

  <Step title="Clique em Add reCAPTCHA v3">
    Clique no botão **Add reCAPTCHA v3** 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 reCAPTCHA v3 nos seus formulários. A proteção funciona silenciosamente em segundo plano. Os visitantes não verão nenhum widget nem desafio.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/HMKrQYFyvSl4tVFf/images/recaptcha-v3.png?fit=max&auto=format&n=HMKrQYFyvSl4tVFf&q=85&s=b5db20d00f86b2aa9522e2848872a0b9" alt="O formulário de integração do reCAPTCHA v3 no LanderLab, com os campos Name, Site Key e Secret Key" width="1920" height="991" data-path="images/recaptcha-v3.png" />
</Frame>

***

## Conectar o reCAPTCHA v3 a outra landing page

Como as integrações com o reCAPTCHA v3 são salvas globalmente, você não precisa criar uma nova para cada landing page.

<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 reCAPTCHA v3.
  </Step>

  <Step title="Adicione a integração">
    Clique em **Add Integration**. Você verá as configurações do reCAPTCHA v3 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 reCAPTCHA v3 nas variantes selecionadas.
  </Step>
</Steps>

***

## reCAPTCHA v2 vs. reCAPTCHA v3

Não sabe qual versão usar? Veja uma comparação rápida:

| Recurso                         | reCAPTCHA v2                                               | reCAPTCHA v3                                           |
| :------------------------------ | :--------------------------------------------------------- | :----------------------------------------------------- |
| **Experiência do visitante**    | Caixa de seleção visível; pode exibir desafios com imagens | Totalmente invisível, sem necessidade de interação     |
| **Campos obrigatórios**         | Apenas a Site Key                                          | Site Key e Secret Key                                  |
| **Opções de tamanho do widget** | Normal e Compact                                           | Sem widget visível                                     |
| **Ideal para**                  | Formulários em que uma verificação visível é aceitável     | Formulários em que uma experiência fluida é prioridade |

As duas versões protegem seus formulários contra bots e spam. O reCAPTCHA v3 geralmente é o preferido para landing pages de geração de leads porque não cria nenhum atrito para os visitantes reais.

***

## Dicas para o reCAPTCHA v3

* **Verifique se o domínio corresponde** - O domínio que você informou no Google Admin Console precisa corresponder ao domínio em que a sua landing page está publicada. Se eles não corresponderem, o reCAPTCHA não funcionará corretamente.
* **As duas chaves são obrigatórias** - Diferentemente do v2, o reCAPTCHA v3 exige a Site Key e a Secret Key. Certifique-se de copiar as duas no Google Admin Console antes de configurar a integração no LanderLab.
* **Você não verá um widget visível** - O reCAPTCHA v3 é totalmente invisível. Se quiser confirmar que ele está funcionando, consulte os dados de análise no Google reCAPTCHA Admin Console depois de alguns envios de teste.