Introducción

El componente “Form” de wolkvox Studio te permite crear un formulario para que el agente capture datos del cliente durante una atención (Agent Scripting).

Cada campo diligenciado se guarda en una variable (por ejemplo: $fullname, $dni, $email, etc.), para que luego puedas usar esos valores dentro del flujo (validaciones, envíos a base de datos, consumo de APIs, mensajes, etc.).

Ten en cuenta que los datos capturados en el “Form” no quedan almacenados automáticamente en los reportes de wolkvox Manager. Si necesitas guardarlos, debes hacerlo con componentes del flujo.

Configuración

Haz doble clic sobre el componente para abrir su panel de configuración (lado derecho).

En el campo “Pregunta”, redacta el texto que verá el agente como instrucción principal. Este texto sirve como guía para que el agente sepa qué debe capturar.

Debajo de Pregunta verás una tabla (con columnas como Label, Type, ID Name, Default Value y el indicador de requerido). Para crear campos:

1. Haz clic derecho dentro de la tabla. 
   • Selecciona Adicionar Ítem. 
2. En la ventana emergente configura:
   • Label: nombre visible del campo (lo que verá el agente).
   • Type: tipo de campo. Puedes usar: text, number, password, radio, select, select_search, email, checkbox, date, textarea, color.
   • ID Name: nombre de la variable donde se guardará el valor.
     • Importante: no escribas el signo $. El sistema lo agrega internamente.
     • Ejemplo: si pones fullname, luego podrás usar $fullname.
   • Default Value (si aplica): valor predeterminado del campo (opcional). Si lo dejas vacío, el valor se asigna cuando el agente diligencie el formulario. 
   • Values list (solo para radio, select y select_search): lista de opciones separadas por coma. 
   • Campo Obligatorio: actívalo si quieres que el agente no pueda enviar el formulario sin completar ese campo.
   • Da clic en “Agregar” para incluir el campo en la tabla.

Tipos de campo disponibles en el componente “Form”

Al configurar un campo dentro del componente “Form”, el atributo “Type” define el tipo de información que el agente podrá capturar y la forma en que ese campo se mostrará en el formulario. A continuación se describe cada opción disponible:

text

• Campo de texto libre.
• Permite al agente ingresar cualquier valor alfanumérico sin restricciones específicas.
• Uso recomendado: nombres, direcciones, comentarios cortos, referencias generales.

number

• Campo numérico.
• Solo permite ingresar números. No acepta letras ni caracteres especiales.
• Uso recomendado: documentos de identidad, cantidades, edades, códigos numéricos.

password

• Campo de texto oculto.
• El valor ingresado se muestra enmascarado (•••••) para proteger información sensible.
• Uso recomendado: Contraseñas temporales, códigos de acceso o información sensible solo cuando sea estrictamente necesario y siempre controlando cuidadosamente dónde se reutiliza la variable.
• Nota importante: Aunque el valor se oculta visualmente en el formulario, la información se guarda en una variable normal. Si esa variable se utiliza o se muestra posteriormente en otro componente del flujo, el valor se mostrará en texto plano.

radio

• Selección única entre varias opciones.
• El agente solo puede elegir una opción de una lista definida en Values list.
• Uso recomendado: preguntas de Sí/No, estados excluyentes, decisiones únicas.

select

• Lista desplegable de selección única.
• Muestra las opciones definidas en Values list dentro de un menú desplegable.
• Uso recomendado: catálogos cerrados como productos, categorías, ciudades, planes.

select_search

• Lista desplegable con buscador.
• Funciona como select, pero permite buscar dentro de la lista cuando hay muchas opciones.
• Uso recomendado: listados largos (por ejemplo, modelos, sucursales, referencias extensas).

email

• Campo de correo electrónico.
• Valida automáticamente que el valor ingresado tenga el formato de un email válido.
• Uso recomendado: correos electrónicos de clientes o contactos.

checkbox

• Campo de selección múltiple o confirmación.
• Permite marcar o desmarcar una opción (true / false).
• Uso recomendado: aceptación de términos y condiciones, confirmaciones, autorizaciones.

date

• Selector de fecha.
• Muestra un calendario para que el agente seleccione una fecha específica.
• Uso recomendado: fechas de compra, nacimiento, entrega, vencimientos.

textarea

• Campo de texto multilínea.
• Permite ingresar textos largos y se muestra como un área ampliada.
• Uso recomendado: observaciones, notas del cliente, comentarios detallados.

color

• Selector de color.
• Permite elegir un color y guarda su valor (por ejemplo, en formato hexadecimal).
• Uso recomendado: personalización, selección visual, identificación por color.

Tip: Si necesitas ajustar un campo ya creado, desde el mismo menú contextual de la tabla puedes usar opciones como Editar ítem o Borrar ítem.

Cuando termines de construir todos los campos da clic en “Guardar Formulario” (parte inferior del panel).

1. Usa las variables capturadas en el flujo (ejemplo práctico)
2. Una vez el agente diligencia el formulario, los datos quedan disponibles en variables con $.