Hosting con 20% de descuento comprando por el enlace

Formularios y leads

Formularios de contacto, presupuesto y empleo que guardan cada lead en el panel, avisan a tu equipo por correo, filtran el spam, registran la campaña y pueden pasar el lead a un CRM o una hoja de cálculo.

Un formulario de Velk es cualquier formulario cuyos envíos deben llegar al panel: contacto, presupuesto, empleo, newsletter. Le dices a la IA los campos, cuáles son obligatorios y qué lee el visitante después de enviar. La IA declara el formulario en site.json, el archivo que guarda la estructura del sitio, y escribe su HTML en el tema, con el estilo del sitio. Luego Velk valida, guarda y manda por correo cada envío, y deja fuera a los bots; el lead queda guardado aunque falle el correo.

Pídele a la IA

Agrega un formulario de presupuesto a la página de Contacto del sitio de la pastelería. Campos: nombre (obligatorio), correo (obligatorio), WhatsApp, fecha del evento, número de invitados, tipo de pedido (pastel de boda, cumpleaños, corporativo) y un mensaje. Después de enviar, muestra: ¡Gracias! Respondemos en un día hábil. En el panel, identifica cada lead por el nombre, con el tipo de pedido debajo. Sin subida de archivos por ahora. Ejecuta schema:validate al final.

Revisa los nombres de campo antes de aprobar: el CRM recibe los campos con esos nombres, y los leads ya guardados conservan los anteriores si los renombras después.

Lo que hace la IA

  • Declara el formulario en site.json: un id (quote), los campos, el mensaje de éxito y el asunto del correo, que puede incluir el nombre del visitante. Los campos pueden ser texto, correo, teléfono, URL, número, texto largo, casilla, lista de opciones, oculto o archivo.
  • Define el campo que identifica cada lead en el panel (preview_field) y, desde la v3.8.0, el de la segunda línea de la tarjeta (preview_subtitle_field).
  • Escribe el formulario en la plantilla, con el token de seguridad, el antispam y una frase para cada resultado: Velk devuelve códigos, y el tema los convierte en frases con la voz del sitio.
  • Ejecuta schema:validate y hace un envío de prueba.

En el panel

En la pantalla del formularioQué hace ahí el cliente
DestinatariosAgrega o quita quién recibe cada lead por correo. Sin nadie en la lista, los leads se siguen guardando.
EnvíosUna tarjeta por lead. Al abrirla, muestra todos los campos, la página de origen, la campaña, los adjuntos y si el correo salió.
FiltrosPor período; en los formularios por pasos, también finalizados o en curso.
SpamLo que bloqueó el antispam, en los formularios que lo guardan.
Seguimiento de conversiónLos campos de correo y teléfono para las conversiones de anuncios (ver Seguimiento y consentimiento).
ExportarDescarga los leads en un archivo CSV.

Spam: la trampa, Turnstile y la lista Spam

Todo formulario tiene un honeypot, un campo oculto que solo rellenan los bots. Al bot atrapado se le responde con un “enviado” falso, y no sale ningún correo. Desde la v3.7.5 un pequeño script vacía ese campo en el navegador del visitante, así que el autocompletado ya no bloquea a personas reales.

Turnstile, de Cloudflare, es la segunda capa, opcional: crea un widget en el panel de Cloudflare (no hace falta usar su DNS) y pásale a la IA sus dos claves, que van en .env. Quien no lo supera ve un error honesto; si Cloudflare se cae, el envío pasa.

Los dos controles rechazan a una persona real de vez en cuando. Con keep_spam activado, el formulario guarda lo que bloquean en una lista Spam, con la marca del control que lo atrapó y sin los adjuntos. No es spam (v3.7.3) devuelve el lead, sin correo ni webhook, porque puede tener semanas. Es spam (v3.7.6), junto a Eliminar, manda la basura ahí en lugar de destruirla, y se puede deshacer.

Pídele a la IA

Protege el formulario de contacto del sitio de la clínica. Creé un widget de Turnstile en Cloudflare para el dominio de la clínica: pídeme las dos claves. Guarda lo que bloquee el antispam, para rescatar a pacientes reales, y explícame cómo programar en el hosting la limpieza del spam de más de 30 días.

Ni el deploy ni la publicación del tema envían tu .env local al servidor: en un sitio publicado, las claves van también en el .env del servidor.

Adjuntos, campaña y CRM

Un campo file recibe un archivo (PDF, JPG, PNG, WebP, GIF, DOCX, XLSX, PPTX o ZIP; SVG solo si lo pides) de hasta 10 MB, salvo que definas otro límite; el del hosting puede ser menor. Los adjuntos son privados: quedan fuera de la biblioteca de medios, solo se descargan desde el lead y se borran con él.

La campaña se registra sola: los parámetros UTM y los click IDs de anuncios de Google (gclid, gbraid, wbraid), Meta (fbclid), Microsoft, TikTok, LinkedIn y X, leídos de la dirección por la que llegó el visitante y conservados mientras navega. Solo se guarda esa lista cerrada, así que un dato personal que acabe en una dirección por error nunca queda registrado.

Un webhook, una pequeña función del tema, pasa cada lead guardado a un CRM, una hoja de cálculo o Slack. Si falla, el lead sigue guardado y el error va al log. Con el click ID, el CRM puede informar la venta a la plataforma de anuncios; esa importación ocurre fuera de Velk.

Formularios por pasos (desde la v3.7.8)

Un formulario largo se puede dividir en pasos que se guardan a medida que el visitante avanza: el primero crea el lead y los demás lo completan, así que quien abandona a mitad de camino ya dejó nombre y correo.

  • Un lead a medias aparece como “paso 2 de 3” en el panel, donde un filtro muestra solo los finalizados (por defecto), solo los en curso o todos.
  • El correo y la conversión ocurren una sola vez, en el último paso, con el lead completo.
  • step_webhook envía cada paso al CRM en cuanto llega, y otra vez si el visitante vuelve a corregir uno.
  • La campaña se registra, y el antispam actúa, en el primer paso.
  • Los pasos necesitan JavaScript; ninguna otra función de los formularios lo necesita.

Pídele a la IA

Convierte el formulario de presupuesto de paneles solares en tres pasos: 1) nombre, correo, teléfono y la casilla de consentimiento; 2) código postal, ciudad y tipo de techo; 3) gasto medio de luz y un mensaje. Envía cada paso a nuestro CRM en cuanto llegue, para que ventas llame a quien se detuvo a mitad. Mantén el mensaje de éxito actual.

La IA comprueba con schema:validate que cada campo esté en exactamente un paso, y ajusta la plantilla para que coincida.

Exportar leads (desde la v3.8.0)

El bloque Exportar de la pantalla del formulario descarga un CSV de los leads aprobados y finalizados, con las columnas (cada campo, más los grupos de metadatos y de seguimiento, desmarcados por defecto), el período y el separador que elijas. Abre en Excel con los acentos bien, y una celda que empieza como fórmula se escribe como texto, así que nada de lo que escribió un visitante se ejecuta en la hoja. La dirección de descarga guarda tus elecciones, como una exportación guardada. En un sitio publicado, la IA ejecuta form:export en el servidor y guarda el archivo en tu computadora.

Lo que ejecuta la IA
# leads de presupuesto de septiembre, con las columnas de campaña $ ./bin/velk form:export quote --from=2026-09-01 --to=2026-09-30 --cols=name,email,whatsapp,order_type,@params > quote-september.csv # una vez al día, programado en el hosting (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.
El CSV contiene datos personales: guárdalo donde solo el equipo pueda abrirlo. Las limpiezas borran también los adjuntos y nunca tocan leads aprobados y finalizados.