logo
PáginasComeçando•

Use um Google Forms ou Typeform antes do redirecionamento

Mostre um Google Forms, Typeform ou Tally quando alguém abre o seu link ou escaneia o seu QR Code dinâmico e depois siga ao destino. Limites e testes.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

Ao final deste guia, o seu link curto ou QR Code dinâmico abre o seu Google Forms, Typeform ou Tally já existente num modal, e o visitante ainda chega ao destino que você configurou — em vez de parar em "Sua resposta foi registrada".

Use quando o formulário já existe e as respostas precisam ficar naquela ferramenta. Quando você precisa dos leads dentro da CodeQR (Respostas, Clientes, CRM, notificações por e-mail) ou precisa que o formulário seja obrigatório, use uma Página da CodeQR: Adicione um formulário de leads a um QR Code ou link curto.

Disponibilidade

  • Plano: Business ou superior (preços).
  • Onde: construtor de links → Formulário de pré-redirecionamento → Usar formulário externo. Mesmo caminho no editor de QR Code para QR Codes dinâmicos.

Antes de começar

  • A URL pública do formulário — a que você compartilharia, não a do editor:
  • Google Forms: Enviar → ícone de link → copiar (https://docs.google.com/forms/d/e/…/viewform). Formulários com pergunta de upload de arquivo ou com "Limitar a 1 resposta" exigem login no Google e não podem ser incorporados — remova essas opções ou use uma Página da CodeQR.
  • Typeform: Share → o link https://form.typeform.com/to/…. Os embeds do Typeform só funcionam em HTTPS e, por padrão, um "redirect on completion" substitui a página inteira, não só o quadro.
  • Tally: o link https://tally.so/r/….
  • Conheça os limites antes de prometer algo à equipe:
  • A CodeQR não recebe as respostas. Elas ficam no Google Forms, no Typeform ou no Tally. Nada aparece em Respostas, Clientes, Eventos ou no seu CRM, e nenhum e-mail é enviado.
  • O formulário não pode ser obrigatório. O visitante sempre pode fechar o modal; o app avisa isso embaixo do campo, e a API recusa isFormMandatory para formulários externos com CodeQR page required for form submission.
  • A CodeQR não sabe que o formulário foi enviado. Depois que o visitante termina, a tela de agradecimento da própria ferramenta aparece dentro do modal; o visitante fecha o modal para seguir ao destino.
  • Algumas ferramentas de formulário não aparecem dentro de um quadro (caixa em branco) — veja Solução de problemas.

Passos

  1. Abra Links → Adicionar Link (ou Editar um link existente) e preencha a URL de destino.
  2. Ative Formulário de pré-redirecionamento.
  3. Selecione Usar formulário externo.
  4. Cole a URL do formulário no campo. Ignore a opção Preenchimento obrigatório? — ela só vale para formulários da plataforma.
  5. Clique em Criar link (ou Salvar link).

The Pre-redirection form section with Use external form selected, a Google Forms URL pasted in the field, and the note that for external forms mandatory forms cannot be guaranteed because the user can close the modal at any time

Para um QR Code: mesma seção no editor de um QR Code dinâmico.

O que o visitante vê

O modal abre com o seu formulário num quadro, sobre uma prévia desfocada do destino. Um botão de fechar fica no canto. Quando o visitante fecha — depois de responder ou sem responder —, a CodeQR o envia pelo mesmo link curto até o destino e lembra a escolha por uma hora naquele navegador.

The visitor modal showing a Tally Contact us form inside a frame, with a close button in the top right corner and a blurred destination page behind

O mesmo pela API

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/catalog",
    "domain": "go.example.com",
    "key": "catalog-form",
    "preRedirection": true,
    "pageUrl": "https://docs.google.com/forms/d/e/1FAIpQLSf_prf_docs_example/viewform?embedded=true"
  }'

A resposta devolve "preRedirection": true, "pageId": null, "pageUrl": "https://docs.google.com/…", "isFormMandatory": false. Enviar "isFormMandatory": true sem pageId devolve 400 CodeQR page required for form submission. Para trocar um link existente de uma Página da CodeQR para um formulário externo, PUT /links/{linkId} com "pageId": null e o novo "pageUrl".

Como verificar

  1. Abra o link curto numa janela anônima. O modal mostra o seu formulário.
  2. Responda. A confirmação da ferramenta aparece dentro do quadro.
  3. Feche o modal. Você cai no destino.
  4. Confira as respostas no Google Forms, no Typeform ou no Tally — não na CodeQR.
curl -sI -A "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)" https://go.example.com/catalog-form | grep -iE "^HTTP|x-pathname"
# HTTP/2 200
# x-pathname: /go.example.com/pre-redirection/catalog-form/link

Solução de problemas

O modal abre, mas a caixa fica em branco

O provedor do formulário se recusa a ser exibido dentro de outro site (X-Frame-Options ou uma política frame-ancestors). Abra o console do navegador: a requisição devolve 200, mas o quadro fica vazio com uma mensagem "Refused to display". Só o dono do formulário pode mudar isso; se não for você, use uma Página da CodeQR.

O formulário pede para o visitante entrar no Google

O Google Forms tem uma pergunta de upload de arquivo, "Limitar a 1 resposta" ou coleta de e-mail verificada. O login não funciona dentro de um quadro nem nos navegadores internos do Instagram e do Facebook. Desligue essas opções ou leve o formulário para uma Página da CodeQR.

O visitante respondeu e nada aconteceu

É o fluxo: o Google Forms mostra o próprio "Sua resposta foi registrada" e não tem opção de redirecionamento; o redirecionamento do Typeform, quando configurado, substitui a página inteira. A CodeQR não é avisada do envio — o visitante fecha o modal para continuar. Diga isso na mensagem de confirmação do formulário ("Feche esta janela para seguir ao download").

No iPhone o formulário recarrega ou não envia

O Safari bloqueia cookies de terceiros dentro de quadros, e a própria comunidade do Typeform confirma que formulários incorporados podem recarregar ou falhar no envio no iOS por esse motivo. Como scans de QR Code são majoritariamente mobile, um formulário de Página da CodeQR (mesma origem, sem cookies de terceiros) é a opção confiável.

Quero tornar o formulário externo obrigatório

Não é possível: o modal pode ser fechado e a CodeQR não sabe se o formulário foi enviado. Obrigatório exige uma Página da CodeQR: Torne o formulário obrigatório ou deixe o visitante pular.

A resposta não diz de qual QR Code veio

A CodeQR não passa nada ao formulário externo. Use o recurso de pré-preenchimento ou campo oculto da própria ferramenta na URL que você cola (por exemplo um parâmetro ?source=cartaz-a que o Tally ou o Typeform capturam), um link por ponto de contato.

Artigos relacionados