logo
PáginasComeçando•

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

Preenchimento obrigatório? remove o botão de fechar; sem ele o visitante pode pular. O que acontece depois: mesmo link curto, Regras inteligentes.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

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ê exatamente 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).
  • 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

  • Botão de fechar no modal — Opcional (padrão): sim · Obrigatório (Preenchimento obrigatório? marcado): não
  • Caminho do visitante — Opcional (padrão): preencher e enviar, ou fechar e continuar · Obrigatório (Preenchimento obrigatório? marcado): preencher e enviar
  • Funciona com — Opcional (padrão): formulário de Página da CodeQR, formulário externo · Obrigatório (Preenchimento obrigatório? marcado): somente formulário de Página da CodeQR
  • O que a CodeQR registra — Opcional (padrão): FORM_FILLED ou CONTINUED_WITHOUT_FORM no cookie do visitante · Obrigatório (Preenchimento obrigatório? marcado): FORM_FILLED

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

The Pre-redirection form section with a platform page selected and the Mandatory Forms? checkbox ticked

The visitor modal on a phone with a required form: title, Name and Email fields, the consent checkbox and the button, and no close button anywhere

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 é 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. Enviar não conta um segundo clique.

Onde é "o destino", por tipo:

  • Link curto, QR Code dinâmico de URL — Depois do formulário o visitante recebe: a URL de destino, ou a URL escolhida pelas Regras inteligentes e pela segmentação
  • QR Code de WhatsApp — Depois do formulário o visitante recebe: https://wa.me/<número>?text=<sua mensagem> — o WhatsApp abre com a mensagem preenchida
  • QR Codes dinâmicos de Wi-Fi, vCard, texto e outros tipos — Depois do formulário o visitante recebe: a página de exibição do próprio QR Code

Duas coisas que não acontecem neste fluxo:

  • Parâmetros de query do link curto não são repassados. Um visitante que abriu https://go.example.com/promo?utm_source=newsletter cai no destino sem utm_source. Os valores de UTM ficam gravados com a resposta (aparecem na exportação CSV e em customFields do lead), mas a análise do seu destino não os vê.
  • 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 — 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 e o horário com cada resposta.

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

# 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

Por desenho, hoje: o redirecionamento depois do formulário é montado a partir do próprio link curto. Coloque os valores de UTM na URL de destino, no construtor de links (UTM Builder), se a sua análise precisar deles; os parâmetros originais do visitante ficam guardados com a resposta.

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