Adicionar reCAPTCHA

Um formulário público com campo de e-mail atrai robôs. O Google reCAPTCHA adiciona uma verificação que barra a maioria dos envios automatizados sem atrapalhar quem é cliente de verdade. O app o descreve como “reCAPTCHA offers more than just spam protection”.

A configuração tem duas tarefas: registrar sua loja no Google e adicionar ao app as chaves que o Google fornece. Você vai precisar de uma conta Google.

Cuidado

Registre-se para o reCAPTCHA v2, a caixa “I’m not a robot”. Essa é a versão para a qual esta integração foi criada. O v3 funciona de forma invisível e emite outro tipo de chave, então um par de chaves v3 colado no app resulta em um formulário sem verificação visível e sem proteção. O Google define a versão no momento do registro, portanto acerte no formulário de registro em vez de descobrir depois.

Etapa 1: obtenha suas chaves no Google

1. Abra o console de administração do reCAPTCHA

   Acesse o Google reCAPTCHA e entre com sua conta Google.

   Você também pode chegar lá de dentro do app: a página Google reCAPTCHA traz a linha “Click here to create your own reCAPTCHA site key and secret key for your website”, e here é um link para o mesmo console.

2. Preencha o formulário de registro

   O Google pede cinco informações. A segunda é a que decide se tudo vai funcionar:

   Campo	O que informar
   Label	Um nome que indique a qual site essa chave pertence quando você voltar a ela daqui a um ano. O nome da sua loja é a escolha óbvia.
   reCAPTCHA type	reCAPTCHA v2 e, abaixo dele, a opção "I'm not a robot" Checkbox. Não o v3, nem o selo invisível, nem as opções para Android.
   Domain	O domínio da sua loja Shopify, o endereço em que o formulário de cotação é exibido.
   Owners	Deixe como está. O Google define a conta com a qual você entrou. Adicione outros endereços só se um colega também precisar administrar a chave.
   Alerts	Vale ativar. Ele envia e-mail aos proprietários quando o Google detecta um problema no seu site, como um reCAPTCHA mal configurado ou um aumento de tráfego suspeito. O primeiro caso é exatamente a falha de que esta página trata, então deixe o Google avisar você em vez de esperar que um cliente avise.

   Preencha tudo corretamente e envie o formulário.

3. Copie as duas chaves

   O Google então mostra um par de chaves: uma site key e uma secret key. Mantenha a página aberta; você vai colar as duas no app daqui a pouco, em campos com esses mesmos dois nomes.

Nota

O domínio que você registra precisa ser o domínio que clientes realmente acessam ao chegar ao formulário de cotação. Uma divergência entre os dois é o motivo mais comum de a verificação nunca aparecer.

Etapa 2: adicione as chaves ao app

1. Abra as configurações da integração

   No app, acesse Advanced settings e abra a aba Integrations. Em Third-party integration, encontre Google reCAPTCHA e abra-o: cada integração tem a própria página.

2. Cole suas chaves

   A página tem exatamente dois campos, um abaixo do outro:

   Campo no app	O que vai nele
   Site key	A site key emitida pelo Google, a metade pública do par.
   Secret key	A secret key emitida pelo Google, a metade privada. Não a cole em nenhum outro lugar nem a compartilhe fora da sua equipe.

   O Google dá às duas chaves os mesmos nomes que o app, então é só copiar e colar. Elas não são intercambiáveis, por isso cuidado para não trocá-las, que é o erro mais frequente. Copie uma, cole e depois volte para a outra, em vez de copiar as duas e confiar na memória.

   

   

   Cole as duas chaves do Google e salve.

3. Salve e confira o resultado na sua loja virtual

   Salve as alterações e abra o formulário de cotação na sua loja virtual como uma pessoa cliente faria. A caixa “I’m not a robot” deve aparecer no formulário.

   Envie uma solicitação de teste de verdade. Ver a caixa só prova que a site key funciona; concluir um envio é o que prova que a secret key também funciona.

Nota

As chaves salvas voltam mascaradas quando você reabre a página: o app guarda as chaves de integração como um espaço reservado mascarado em vez de exibi-las novamente. Isso é esperado. Cole uma chave nova somente quando realmente quiser alterar uma.

Cuidado

Teste com um envio real sempre que alterar essas chaves. Uma verificação mal configurada pode bloquear clientes legítimos sem avisar, e você não verá as solicitações que nunca chegaram.

Se a verificação não aparecer

• Confira se você registrou o v2, não o v3. Um par de chaves v3 não produz caixa visível, e é para isso que o v3 serve. Abra seu site no console do Google reCAPTCHA e veja o tipo com que ele foi registrado. Se for v3, registre um novo site com a caixa v2 “I’m not a robot” e substitua as duas chaves.
• Confira se o domínio é o mesmo. O domínio registrado no Google deve corresponder ao domínio que clientes realmente usam.
• Confira se as duas chaves foram salvas e na ordem certa. O campo Site key do app recebe a site key do Google e o campo Secret key recebe a secret key do Google. Cole-as novamente a partir do Google se tiver dúvida e salve.
• Confira se o app está ativado no seu tema. No painel do app, o Setup guide mostra App embed is enabled ou App embed is disabled, com um botão Enable app embed.
• Confira se os campos não estão bloqueados. Se estiverem acinzentados, com uma linha de cadeado dizendo “🔐 This feature is available on …”, a integração pertence a um plano superior. Isso é uma questão do seu plano, não uma falha: abra Pricing plans no app.

Próximos passos

• Criar um formulário padrão: o restante do seu formulário
• Visão geral das integrações: conecte os dados de cotação às suas outras ferramentas
• Permitir envio de arquivos: quais tipos de arquivo o app aceita e o armazenamento que os envios usam