Hospedagem com 20% de desconto comprando pelo link

Formulários e leads

Formulários de contato, orçamento e candidatura que guardam cada lead no painel, avisam a equipe por e-mail, filtram spam, registram a campanha e podem mandar o lead para um CRM ou uma planilha.

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:validate e faz um envio de teste.

No painel

Na tela do formulárioO que o cliente faz ali
DestinatáriosInclui ou remove quem recebe cada lead por e-mail. Sem ninguém na lista, os leads continuam gravados.
PreenchimentosUm cartão por lead. Aberto, mostra todos os campos, a página de origem, a campanha, os anexos e se o e-mail saiu.
FiltrosPor período; nos formulários em etapas, também concluídos ou em andamento.
SpamO que o antispam bloqueou, nos formulários que guardam.
Rastreamento de conversãoOs campos de e-mail e telefone para as conversões de anúncio (veja Rastreamento e consentimento).
ExportarBaixa 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_webhook manda 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.

O que a IA roda
# leads de orçamento de setembro, com as colunas de campanha $ ./bin/velk form:export quote --from=2026-09-01 --to=2026-09-30 --cols=name,email,whatsapp,order_type,@params > quote-september.csv # uma vez por dia, agendado na hospedagem (cron) $ ./bin/velk cleanup:spam-submissions --days=30 ✓ Removed 214 blocked submissions older than 30 days. $ ./bin/velk cleanup:incomplete-submissions --days=30 ✓ Removed 9 incomplete submissions older than 30 days.
O CSV tem dado pessoal: guarde onde só a equipe abre. As limpezas apagam os anexos junto e nunca tocam em lead aprovado e concluído.