Veja como utilizar o recaptcha na Uappi

O reCAPTCHA v2 é uma ferramenta de segurança do Google amplamente utilizada para proteger sites contra bots e tentativas de spam — tudo isso sem comprometer a experiência do usuário.

Esse recurso também está disponível na Uappi, ajudando sua loja a garantir mais segurança nas páginas de login, cadastro e checkout.

Siga o passo a passo abaixo para configurá-lo corretamente!

Passo a passo da configuração

1. Registro e obtenção das credenciais

1. Faça login com sua conta Google e acesse este link.
2. Selecione a opção “Desafio v2” como tipo de reCAPTCHA.

3. Insira o nome do seu domínio (por exemplo: seudominio.com.br).
   
   • Importante: se sua loja está em fase de homologação (uappi.dev), cadastre também o domínio de homologação e o domínio de produção. Assim, quando o site for publicado (pós-go live), você não precisará voltar nessa tela para ajustar os domínios.
     
4. Aceite os termos de serviço e clique em “Enviar”.
   
5. Você receberá duas chaves:
   
   • Chave do Site (Site Key) — também chamada de Public Key
     
   • Chave Secreta (Secret Key) — também chamada de Private Key
     

Atenção: as chaves do reCAPTCHA geradas pelo Google devem começar com o prefixo “6L”. 

Caso suas chaves não apresentem esse prefixo, verifique se elas foram criadas corretamente — o uso de uma chave incorreta pode impedir o funcionamento do reCAPTCHA na sua loja.

2. Configurando o reCAPTCHA na Uappi

Acesso às configurações

No painel da Uappi, siga o caminho: Apps > Segurança > Recaptcha. Ou, se preferir:
Configurações > Integrações > Recaptcha.

Inserção das chaves

1. Cole a Chave do Site (Site Key) e a Chave Secreta (Secret Key) nos campos correspondentes.
   
2. Após preencher, clique em “Enviar” para salvar as configurações.

Dica: certifique-se de colar as chaves, exatamente como foram geradas pelo Google, sem espaços ou alterações.

3. Ativação e uso do reCAPTCHA

Após inserir as chaves, defina onde o reCAPTCHA será aplicado na sua loja:

• Cadastro de cliente;
  
• Pagamento;
  
• Login;
  
• Todos os módulos acima.
  

Também é possível configurar o número de erros permitidos antes da exibição do reCAPTCHA. Se você definir o valor “0”, o reCAPTCHA será exibido logo na primeira tentativa de acesso.

Resumo das boas práticas:

• Verifique se suas chaves começam com o prefixo “6L”.
  
• Cadaste tanto o domínio de homologação quanto o de produção.
  
• Escolha corretamente o tipo de reCAPTCHA (v2).
  
• Teste a funcionalidade após ativar para garantir que o recurso está ativo.

Dúvidas?

Para ver mais conteúdos sobre a plataforma da Uappi, acesse nossa central de ajuda!