Torne o formulário obrigatório ou deixe o visitante pular

Depois de ler esta página você decide se o visitante precisa preencher o formulário para chegar ao destino ou se pode pular, e prevê onde ele cai depois, inclusive numa conversa de WhatsApp, numa loja de aplicativos ou num destino escolhido pelas Regras inteligentes.

Disponibilidade

• Plano: Business ou superior (preços). Em planos inferiores o botão fica desabilitado e mostra o selo Business.
• Onde: construtor de links ou editor de QR Code → Formulário de pré-redirecionamento → Preenchimento obrigatório?. A caixa só fica ativa com Usar formulário da plataforma e uma página selecionada. Formulários externos sempre podem ser fechados.

Obrigatório ou opcional

Para ligar: abra o link (⋮ → Editar) ou o QR Code, marque Preenchimento obrigatório? embaixo da página selecionada e clique em Salvar link (num QR Code, Salvar QR Code). Pela API, envie "isFormMandatory": true junto com pageId e pageUrl; sem pageId a API responde 400 CodeQR page required for form submission.

Um formulário obrigatório só barra o visitante enquanto a página estiver publicada. Se ela não estiver, o visitante vai direto ao destino, e um QR Code impresso continua funcionando.

O que acontece depois do formulário

1. Envio. A CodeQR grava a resposta e devolve o visitante pelo mesmo link curto com um marcador de "formulário feito". O link então se comporta como qualquer outro link da CodeQR: Regras inteligentes, Segmentação iOS, Segmentação Android, Segmentação Geográfica e Camuflagem de links valem todas. O visitante cai no destino que essas regras escolherem.
2. Pulo (só em formulários opcionais). Mesmo caminho, com um marcador de "continuou sem formulário". Nenhuma resposta concluída é gravada.
3. Nos dois casos, a CodeQR grava um cookie skipForm por uma hora, restrito àquele link ou QR Code. Durante essa hora o mesmo navegador vai direto ao destino; depois, o formulário aparece de novo. Pular fixa tanto quanto enviar.
4. O clique ou o scan já foi contado quando o visitante abriu o link pela primeira vez, antes do formulário. Voltar pelo link depois do envio não conta um segundo clique se isso acontecer em até cinco minutos.

Onde é "o destino", por tipo:

Os parâmetros de query do link curto seguem com o visitante. Quem abriu https://go.example.com/promo?utm_source=newsletter cai em https://example.com/promo?utm_source=newsletter, tanto no envio quanto no pulo, então a análise do seu destino vê a campanha. Se a URL de destino já tiver esse parâmetro, o valor do visitante o substitui e os demais parâmetros ficam. QR Codes de WhatsApp e a página de exibição de outros tipos não os recebem. Os valores utm_* também ficam gravados com a resposta e aparecem na exportação CSV.

As configurações de Após o Envio da página (mensagem de agradecimento, URL de redirecionamento) pertencem à página avulsa e não aparecem aqui, porque o redirecionamento ao destino as substitui.

Como escolher

• Obrigatório quando o destino é a recompensa (um e-book, um cupom, um documento) e você prefere menos leads reais a tráfego. Espere queda: um formulário de contato público converte menos de 10% de quem o vê, formulários no celular convertem vários pontos abaixo do desktop, e cada campo a mais custa mais.
• Opcional quando o destino é o seu produto, cardápio ou anúncio e o formulário é um bônus. Você mantém o tráfego e conta quantos escolheram deixar contato.
• Nota legal. Na LGPD, autorizações genéricas são nulas e o ônus da prova do consentimento é de quem coleta; na UE e no Reino Unido, o consentimento não é "livre" quando o acesso a um serviço fica condicionado a aceitar marketing. Um formulário obrigatório deve pedir o necessário para entregar o que prometeu, e o texto de consentimento deve dizer o que você fará com os dados. Mantenha o link da política de privacidade visível; a CodeQR grava o texto do consentimento com cada resposta, e o horário do consentimento quando Exigir caixa de consentimento está ligado. Com ele desligado, o formulário só mostra um aviso e nenhum horário de consentimento é registrado.

Como verificar

# primeira visita: a página do formulário (200), cookie cq_id de uma hora
curl -sI -A "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)" https://go.example.com/promo | grep -iE "^HTTP|x-pathname"
# HTTP/2 200
# x-pathname: /go.example.com/pre-redirection/promo/link

# depois de enviar ou pular: o navegador carrega skipForm e recebe o destino
curl -sI -b "skipForm=FORM_FILLED" https://go.example.com/promo | grep -iE "^HTTP|location"
# HTTP/2 302
# location: https://example.com/promo

# os parâmetros de query seguem com o visitante
curl -sI -b "skipForm=FORM_FILLED" "https://go.example.com/promo?utm_source=newsletter" | grep -i location
# location: https://example.com/promo?utm_source=newsletter

# QR Code de WhatsApp depois do formulário
curl -sI -b "skipForm=FORM_FILLED" https://go.example.com/wa-qr | grep -i location
# location: https://wa.me/5511999999999?text=Hi%2C%20I%20want%20the%20catalog

No navegador: abra o link numa janela anônima, envie e veja a barra de endereço ir do link curto ao destino.

Solução de problemas

O visitante fechou o modal e chegou à página mesmo assim

O formulário é opcional, ou é um formulário externo (sempre opcional). Marque Preenchimento obrigatório? numa página da plataforma e salve.

O formulário aparece na primeira vez e nunca mais enquanto eu testo

O cookie skipForm de uma hora. Abra uma janela anônima a cada teste ou limpe os cookies do domínio do link.

Os parâmetros UTM não chegam à minha landing page depois do formulário

O redirecionamento depois do formulário mantém a query string da URL que o visitante abriu, então confira se essa URL traz os parâmetros e se é um link ou um QR Code de URL. Para marcar toda visita, coloque os valores de UTM na URL de destino, no construtor de links (UTM Builder); um valor na URL aberta substitui o mesmo parâmetro ali.

O visitante cai no destino e não na variante das Regras inteligentes que eu esperava

As regras rodaram depois do formulário exatamente como rodam sem ele. Confira a ordem das regras e o dispositivo ou país do visitante como de costume: Envie cada visitante ao destino certo com Regras inteligentes.

Artigos relacionados

• Capture leads com um formulário antes do redirecionamento
• Adicione um formulário de leads a um QR Code ou link curto
• Para onde vão os leads: Respostas, Clientes, CSV e CRM
• Referência do formulário de pré-redirecionamento