Formulário no Velk é qualquer formulário cujo preenchimento precisa cair no painel: contato, orçamento, trabalhe conosco, newsletter. Você diz à IA os campos, quais são obrigatórios e o que o visitante lê depois de enviar. A IA declara o formulário no site.json, o arquivo que guarda a estrutura do site, e escreve o HTML dele no tema, com o visual do site. Daí em diante, o Velk valida, grava e manda por e-mail cada envio, e barra robôs; o lead fica gravado mesmo quando o e-mail falha.
Peça à IA
Cria um formulário de orçamento na página de Contato do site da confeitaria. Campos: nome (obrigatório), e-mail (obrigatório), WhatsApp, data do evento, número de convidados, tipo de pedido (bolo de casamento, aniversário, corporativo) e uma mensagem. Depois de enviar, mostra: Obrigado! Respondemos em até um dia útil. No painel, identifica cada lead pelo nome, com o tipo de pedido embaixo. Sem upload de arquivo por enquanto. Roda o schema:validate no fim.
Confira os nomes de campo antes de aprovar: o CRM recebe os campos com esses nomes, e os leads já gravados ficam com os antigos se você renomear depois.
O que a IA faz
- Declara o formulário no
site.json: um id (quote), os campos, a mensagem de sucesso e o assunto do e-mail, que pode levar o nome de quem preencheu. Os campos podem ser texto, e-mail, telefone, URL, número, texto longo, checkbox, lista de opções, oculto ou arquivo. - Define o campo que identifica cada lead no painel (
preview_field) e, desde a v3.8.0, o da segunda linha do cartão (preview_subtitle_field). - Escreve o formulário no template, com o token de segurança, o antispam e uma frase para cada resultado: o Velk devolve códigos, e o tema transforma em frases com a voz do site.
- Roda o
schema:validatee faz um envio de teste.
No painel
| Na tela do formulário | O que o cliente faz ali |
|---|---|
| Destinatários | Inclui ou remove quem recebe cada lead por e-mail. Sem ninguém na lista, os leads continuam gravados. |
| Preenchimentos | Um cartão por lead. Aberto, mostra todos os campos, a página de origem, a campanha, os anexos e se o e-mail saiu. |
| Filtros | Por período; nos formulários em etapas, também concluídos ou em andamento. |
| Spam | O que o antispam bloqueou, nos formulários que guardam. |
| Rastreamento de conversão | Os campos de e-mail e telefone para as conversões de anúncio (veja Rastreamento e consentimento). |
| Exportar | Baixa os leads num arquivo CSV. |
Spam: a armadilha, o Turnstile e a lista Spam
Todo formulário tem um honeypot, um campo escondido que só robô preenche. O robô pego recebe um “enviado” falso, e nenhum e-mail sai. Desde a v3.7.5, um script pequeno esvazia esse campo no navegador do visitante, então o preenchimento automático não barra mais gente de verdade.
O Turnstile, da Cloudflare, é a segunda camada, opcional: crie um widget no painel da Cloudflare (não precisa usar o DNS dela) e passe para a IA as duas chaves, que vão no .env. Quem não passa vê um erro honesto; se a Cloudflare cair, o envio segue.
Os dois erram de vez em quando com gente de verdade. Com keep_spam ligado, o formulário guarda o que eles bloqueiam numa lista Spam, marcando qual antispam pegou, sem os anexos. Não é spam (v3.7.3) devolve o lead, sem e-mail nem webhook, porque ele pode ter semanas. É spam (v3.7.6), ao lado de Excluir, manda o lixo para lá em vez de apagar, e dá para desfazer.
Peça à IA
Protege o formulário de contato do site da clínica. Criei um widget do Turnstile na Cloudflare para o domínio da clínica: me pede as duas chaves. Guarda o que o antispam bloquear, para a gente resgatar paciente de verdade, e me explica como agendar na hospedagem a limpeza do spam com mais de 30 dias.
Nem o deploy nem a publicação do tema mandam o seu .env local para o servidor: num site no ar, as chaves vão no .env do servidor também.
Anexos, campanha e CRM
Um campo file recebe um arquivo (PDF, JPG, PNG, WebP, GIF, DOCX, XLSX, PPTX ou ZIP; SVG só se você pedir) de até 10 MB, a não ser que você defina outro limite; o da hospedagem pode ser menor. Os anexos são privados: ficam fora da biblioteca de mídia, só são baixados pelo lead, no painel, e somem junto com ele.
A campanha é registrada sozinha: os parâmetros UTM e os click IDs de anúncio do Google (gclid, gbraid, wbraid), da Meta (fbclid), da Microsoft, do TikTok, do LinkedIn e do X, lidos do endereço pelo qual o visitante chegou e guardados enquanto ele navega. Nada fora dessa lista fechada é gravado, então um dado pessoal que vá parar num endereço por engano nunca é.
Um webhook, uma função pequena no tema, repassa cada lead gravado para um CRM, uma planilha ou o Slack. Se ele falhar, o lead continua gravado e o erro vai para o log. Com o click ID, o CRM consegue informar a venda de volta à plataforma de anúncio; essa importação acontece fora do Velk.
Formulário em etapas (desde a v3.7.8)
Um formulário longo pode ser dividido em etapas, gravadas conforme o visitante avança: a primeira cria o lead, as outras completam, então quem desiste no meio já deixou nome e e-mail.
- O lead pela metade aparece como “etapa 2 de 3” no painel, onde um filtro mostra só os concluídos (o padrão), só os em andamento ou todos.
- O e-mail e a conversão acontecem uma vez, na última etapa, com o lead inteiro.
- O
step_webhookmanda cada etapa para o CRM assim que ela chega, e de novo se o visitante voltar para corrigir uma. - A campanha é registrada, e o antispam roda, na primeira etapa.
- Etapas exigem JavaScript; nenhum outro recurso de formulário exige.
Peça à IA
Transforma o formulário de orçamento de energia solar em três etapas: 1) nome, e-mail, telefone e o checkbox de consentimento; 2) CEP, cidade e tipo de telhado; 3) valor médio da conta de luz e uma mensagem. Manda cada etapa para o nosso CRM assim que chegar, para o comercial ligar para quem parou no meio. Mantém a mensagem de sucesso atual.
A IA confere com o schema:validate se cada campo está em exatamente uma etapa, e ajusta o template para bater.
Exportar leads (desde a v3.8.0)
O bloco Exportar da tela do formulário baixa um CSV dos leads aprovados e concluídos, com as colunas (cada campo, mais os grupos de metadados e de rastreamento, desmarcados por padrão), o período e o separador que você escolher. Ele abre no Excel com os acentos certos, e uma célula que começa como fórmula vira texto, então nada que o visitante digitou roda na planilha. O endereço do download guarda as suas escolhas, como uma exportação salva. Num site no ar, a IA roda o form:export no servidor e salva o arquivo no seu computador.