O formulário não apareceu ou o lead não chegou

Encontre o seu sintoma abaixo. Cada item traz a causa que a CodeQR conhece, a correção e onde ler mais. Termos: "formulário da plataforma" é um formulário de Página da CodeQR; "formulário externo" é um Google Forms, Typeform, Tally ou outra URL exibida no modal.

O formulário não aparece e o link vai direto ao destino

Confira nesta ordem:

Você já o viu neste navegador na última hora. Depois de um envio ou de um pulo, a CodeQR grava um cookie skipForm por uma hora naquele link. Abra uma janela anônima ou outro navegador. É o relato mais comum.
O link ou QR Code foi aberto por um robô ou uma prévia de link. WhatsApp, Slack, Facebook, Google e outros crawlers recebem o destino diretamente. Teste com um navegador de verdade ou com curl -A "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)": a resposta precisa ser 200 com x-pathname: /<domínio>/pre-redirection/<chave>/link.
O QR Code é estático. Só QR Codes dinâmicos mostram o formulário, porque um código estático codifica o próprio destino. O editor desabilita o botão em códigos estáticos e a API recusa a combinação. Crie um QR Code dinâmico.
A página não está publicada. O visitante pula o formulário e vai direto ao destino, mesmo com Preenchimento obrigatório? marcado, e nenhum lead é registrado. Abra a página e ligue o botão ao lado do nome dela.
O formulário nunca foi ligado. Abaixo do Business o botão fica desabilitado e mostra o selo Business, então links e QR Codes criados nesses planos não têm formulário. Um formulário salvo quando o workspace estava no Business continua aparecendo depois de um downgrade; você pode desligá-lo, mas não religá-lo sem fazer upgrade.
A alteração não foi salva. Com o botão ligado e nenhuma página selecionada, salvar falha com Pre-redirection page URL missing e o link mantém o comportamento anterior. Selecione uma página ou cole a URL externa e salve.
O link está expirado ou protegido por senha. Essas verificações rodam antes: um link expirado nunca chega ao formulário, e um link protegido o mostra depois da senha. Corrija o próprio link.

O formulário aparece na primeira vez e nunca mais

O mesmo cookie skipForm de uma hora. Pular conta tanto quanto enviar. Para testes repetidos use janelas anônimas; para um visitante real, o formulário volta depois de uma hora.

O formulário não carrega dentro do Instagram, do Facebook ou do TikTok

QR Codes escaneados pela câmera abrem o navegador de verdade do celular e funcionam. O mesmo link tocado dentro de um app social abre o navegador interno do app, onde cookies de terceiros, login no Google, upload de arquivos e alguns scripts são bloqueados ou quebram. Typeform e Jotform já relataram formulários falhando ali, e a correção dependeu da Meta. O que você pode fazer:

Prefira um formulário da plataforma (mesma origem, sem cookies de terceiros, sem login) a um externo para tráfego de redes sociais.
Diga aos visitantes para abrir o link no navegador (menu "⋯" → "Abrir no navegador") quando souber que o tráfego vem de um link na bio.
Mantenha o formulário curto; uploads e login no Google não funcionam em navegadores internos.

O modal abre com uma caixa em branco (formulário externo)

O provedor do formulário não permite a página dele dentro de outro site (X-Frame-Options, CSP frame-ancestors), ou o navegador do visitante bloqueou (Safari com configuração estrita de cookies, um bloqueador de anúncios). A requisição devolve 200, a caixa fica vazia. Só o dono do formulário pode permitir a incorporação; senão, use um formulário da plataforma. Veja Use um Google Forms ou Typeform antes do redirecionamento.

O Google Forms pede para o visitante fazer login

O formulário tem pergunta de upload de arquivo, "Limitar a 1 resposta" ou coleta de e-mail verificada. Desligue isso no Google Forms ou mova o formulário para uma Página da CodeQR.

O botão de envio fica cinza

Exigir caixa de consentimento está ligado e o visitante não marcou Li e concordo. Para remover a caixa, desligue essa opção na seção Consentimento da página; o formulário passa a mostrar o texto como aviso. Um campo obrigatório vazio não deixa o botão cinza: ao tocar nele, o erro aparece embaixo do campo.

O visitante enviou e nada aconteceu, ou "Muitos envios"

Muitos envios. Tente novamente em instantes.: mais de 10 envios em um minuto do mesmo endereço IP naquela página (uma rede compartilhada num evento pode bater nisso). Espere um minuto.
Aceite o termo de consentimento para continuar.: a caixa de consentimento estava desmarcada quando a requisição chegou ao servidor.
Esta página não está publicada, então não pode receber envios no momento.: a página foi despublicada depois que o visitante abriu o formulário. Se recarregar, ele vai para o destino. Para voltar a receber leads, abra a página e ligue o botão ao lado do nome dela.
Uma mensagem embaixo de um campo: o valor falhou na validação daquele campo (padrão, tamanho, mín./máx.). Afrouxe a validação em Campos do Formulário se visitantes legítimos estão esbarrando nela.
Alguns campos estão inválidos. Revise e tente novamente.: o envio como um todo passou de um limite (100 campos ou 100 KB).
Formulário externo: o visitante vê a confirmação da própria ferramenta e precisa fechar o modal para continuar. A CodeQR não é avisada do envio.

O visitante fechou o modal e chegou à página sem preencher

O formulário é opcional, ou é um formulário externo. Marque Preenchimento obrigatório? numa página da plataforma: Torne o formulário obrigatório ou deixe o visitante pular.

A resposta está em Respostas, mas o lead não está em Eventos, na Análise ou no Zapier

O botão Monitoramento de conversão da página está desligado. Com ele desligado, os leads vão para Respostas, Clientes, o e-mail e os conectores de CRM. Eventos e webhooks lead.created ficam de fora. Ligue-o em Páginas → sua página → Conteúdo do Formulário e salve; vale a partir do próximo envio. O Monitoramento de conversão exige Pro ou superior. Tabela completa: Para onde vão os leads.

O lead está no Google Sheets, mas não no HubSpot, no RD Station ou no Kommo

Cada conector recebe o lead separadamente. Os CRMs desduplicam por e-mail: um endereço repetido atualiza o contato existente e responde "já existe", então o lead está no registro antigo. Se o contato nunca existiu, confira o mapeamento de campos do conector em Configurações → Integrações e o log da própria ferramenta.

Nenhum e-mail chegou para um novo lead

Receber novos leads por e-mail está desligado naquela página, ou você é membro e não proprietário (os e-mails vão para proprietários), ou caiu no spam. Os e-mails são enviados só para envios concluídos; não existe notificação push para leads.

O mesmo lead aparece duas vezes na minha automação

O seu endpoint respondeu devagar e a entrega foi repetida, ou duas assinaturas escutam lead.created. Desduplique pelo id do cliente e responda 200 antes de processar. A própria CodeQR registra no máximo 5 leads por hora para o mesmo e-mail e evento.

Os parâmetros UTM faltam no destino depois do formulário

Depois do formulário, o visitante passa pelo link curto com a query string com que chegou, então ?utm_source=… chega ao destino tanto no envio quanto no pulo. Se os valores faltarem, confira a URL que o visitante abriu: só os parâmetros dessa URL seguem adiante. Para marcar toda visita, inclusive de um QR Code impresso, acrescente os valores à URL de destino com o UTM Builder. Se o mesmo parâmetro estiver nos dois lugares, vale o valor do visitante.

WhatsApp, Wi-Fi, vCard e outros tipos de QR Code sem URL de destino não recebem os parâmetros. Os valores utm_* também ficam gravados com a resposta, aparecem na exportação CSV e são enviados com o lead em customFields.

O formulário está no idioma errado, ou mistura idiomas

Os seus textos (título, rótulos dos campos, botão, seu texto de consentimento) aparecem como você escreveu, então escreva-os no idioma do seu público. Os textos da CodeQR, como o consentimento padrão, Li e concordo e a última linha do modal (reportar abuso, termos), seguem o idioma do visitante, e o formulário tem um menu de idioma.

A página mostra mais inícios ou conclusões do que exibições

Exibições conta visitas à URL da própria página. Um formulário aberto por um link ou QR Code não soma exibição, mas as respostas dele contam em Inícios e Conclusões, e por isso esses números podem passar de Exibições. Todo envio aparece em Respostas.

O seletor não mostra a minha página

Só páginas do workspace atual são listadas. Troque de workspace ou crie a página aqui.

Leads de spam ou lixo

A CodeQR aplica um campo honeypot oculto (robôs que preenchem todo campo são descartados), um limite de 10 envios por minuto por IP e página e validação de todo campo no servidor. Para ir além: marque o e-mail como obrigatório com o padrão e-mail, evite campos de texto livre desnecessários e exporte com frequência para notar picos. Não há CAPTCHA no formulário.

Mensagem	Correção
Pre-redirection page URL missing	envie pageUrl (o servidor não o deriva de pageId)
Invalid pre-redirection page URL	pageUrl precisa ser uma URL http(s) absoluta
CodeQR page required for form submission	isFormMandatory: true exige pageId; formulários externos não podem ser obrigatórios
Page not found	o pageId não existe
Pre-redirection forms only work on dynamic QR codes…	envie "static": false, ou "preRedirection": false num código estático
You can only use pre-redirection on a Business plan and above…	faça upgrade, ou envie preRedirection: false