XQuiz

Endereço

O bloco de endereço — CEP, rua, número, complemento, bairro, cidade e estado em um elemento só, com preenchimento automático pelo CEP e a resposta em uma linha

O elemento Endereço captura o endereço completo em um bloco só: CEP, Rua, Número, Complemento, Bairro, Cidade e Estado, cada campo com o próprio rótulo. Ele nasce com Preenchimento automático ligado e o resto vazio — sem texto de ajuda, sem variável e com Obrigatório desligado. A estrutura segue o endereço brasileiro, com rua e número em campos separados.

Aba Conteúdo

Em Geral, dois toggles:

  • Preenchimento automático, ligado por padrão — o campo CEP ganha a máscara 00000-000 e, ao receber o oitavo dígito, o funil busca o endereço e preenche Rua, Bairro, Cidade e Estado. Só para endereços do Brasil.
  • Obrigatório, desligado por padrão — exige CEP, Rua, Número, Cidade e Estado. Complemento e Bairro nunca são exigidos: não existem em todo endereço.

Em Outros: Texto de ajuda, que aceita {{nome}}, e Salvar resposta em variável, opcional — a resposta é capturada de qualquer forma. Ao contrário dos outros inputs, uma variável que já tem valor na sessão não preenche os campos: ela guarda o endereço inteiro em uma linha.

Preenchimento automático

Com o toggle ligado, o visitante digita o CEP e o resto aparece: rua, bairro, cidade e estado são preenchidos e o cursor vai para Número, que é o que falta. Tudo continua editável.

  • O que o visitante digitou não é sobrescrito. Se ele escreveu a rua antes do CEP, a rua fica como está.
  • Trocar o CEP atualiza os campos que vieram da busca.
  • Cidade com CEP único (municípios pequenos) devolve só cidade e estado; rua e bairro ficam para o visitante, e o cursor vai para Rua.
  • CEP não encontrado ou busca indisponível não trava o funil: os campos ficam em branco para o visitante preencher.

A busca sai do navegador do visitante para o ViaCEP, um serviço público — dos dados do visitante, só o CEP digitado é enviado, e só com o toggle ligado. Com ele desligado, o campo de CEP aceita qualquer texto e nenhuma busca acontece.

Validação

Com Obrigatório, os cinco campos exigidos em branco impedem o avanço, com a mensagem "Campo obrigatório". Com Preenchimento automático, um CEP incompleto bloqueia o avanço mesmo sem Obrigatório, com "CEP inválido" — o CEP não é conferido além do formato. As mensagens e os rótulos dos campos saem no Idioma do funil e aparecem ao sair do bloco ou ao tentar avançar por um Botão, uma opção de quiz ou um Redirecionar.

Tema e Configurações

Na aba Tema, duas cores: Cor primária (sublinhado em foco e cursor) e Cor do texto; o fundo segue o da página. O toggle Container põe o bloco em um card, liberando Cor de fundo, Cor da borda e a pasta Bordas. Em Configurações: Nome do elemento, Delay e Exibição condicional.

No funil publicado

O elemento entrega uma resposta: o endereço em uma linha, como Praça da Sé, 123, apto 4 - Sé, São Paulo - SP, 01001-000. Campo vazio some junto com o separador dele. A resposta é gravada ao sair do bloco — passar de um campo para outro do mesmo endereço não grava —, no clique que avança e quando o visitante troca de aba ou fecha o funil.

Ela aparece na coluna da página da tabela de Leads e no CSV; com variável vinculada, ganha também coluna própria e segue para as integrações como um campo só. {{nome}} e a Exibição condicional só reagem depois que o visitante sai do bloco. Se o visitante voltar para a página, o endereço continua preenchido.

Nesta página