# Formularios

Una de las funcionalidades más requeridas por todas las plataformas es la captura de datos de usuarios para posteriormente analizar y segmentar. Con esta herramienta podrás crear cuantos formularios necesites para recolectar datos provenientes de los usuarios de tus sitios.

Al entrar a la herramienta, podrás ver un listado de todos los formularios que hay activos actualmente en la cuenta. Podrás filtrar por su estado (habilitado o deshabilitado), por el sitio en el que se despliegan, y buscar por el nombre del formulario.

En cada fila de la tabla de formularios, verás en la primera columna el nombre del formulario, a continuación la fecha de creación, y la cantidad de respuestas que se han enviado para ese formulario.

Desde este listado también puedes acceder a la vista de análisis individual, haciendo click en el título del formulario, asimismo al listado de respuestas del formulario, haciendo click en el número de respuestas del formulario.

Para habilitar o deshabilitar los formularios y permitir que usuario puedan o no enviar sus respuestas, debes ir a la vista de análisis y seleccionar la acción respectiva entre las opciones desplegadas en la sección superior derecha.

# Crear formulario

Para crear un nuevo formulario, sigues estos pasos:

Desde el menú lateral en la plataforma, selecciona Customers, y haz click en Reinos.
Haz click en tu reino.
Haz click en + Nuevo Formulario. Esto te llevará a la vista de creación de un nuevo formulario, donde deberás llenar los atributos principales del mismo:

Nombre: Nombre asociado al formulario. Este valor aparecerá tanto en el índice de formularios en el administrador de Modyo y como título cuando un usuario lo vaya a responder.
Descripción: Este texto aparecerá como texto debajo del título cuando los usuarios lo vayan a responder.
Límite de personas: Permite determinar el número máximo de respuestas son permitidas.
Sitio: Te permite seleccionar en que sitio se mostrará este formulario. Ten en consideración que esto provoca que el formulario cambie su aspecto de acuerdo a las clases definidas en el CSS global del sitio. Para más información, dirígete a Template builder.

Alerta

Solamente podrás seleccionar un sitio que pertenece al mismo reino, dentro de la Configuración del sitio, en General, asegúrate de que el sitio sea parte del reino correcto.

Habilitado: Selecciona si el formulario va a comenzar en estado habilitado o no.
Aceptar múltiples respuestas: Si esta opción está habilitada, cada vez que un usuario responda el formulario, se registrará como una nueva respuesta. Si esta opción está deshabilitada, cada vez que un mismo usuario responda el formulario, estará sobrescribiendo su respuesta anterior.
Solo para usuarios registrados: Te permite determinar si el formulario solo será visible para usuario registrados en Modyo. Si esta opción está habilitada, un usuario sin sesión no podrá ver el formulario. Si esta opción está deshabilitada, cualquier usuario podrá responder el formulario.
Solicitar contestar automáticamente: Si el formulario es privado (solo usuarios registrados lo pueden contestar), aparecerá esta opción que te permitirá redireccionar automáticamente a los usuarios que inicien sesión en el sitio asociado al formulario para que lo contesten.

Luego de una división podrás ver las opciones para modificar la redirección luego de que un usuario responda el formulario.

Opciones por defecto: Luego de responder el formulario el usuario es redireccionado al home del sitio asociado al formulario.
URL de redirección: Te permite ingresar una URL a la que se redireccionará al usuario luego de haber respondido el formulario. Es necesario escribir el URL entero (e.g. https://test.miModyo.com/home).
Página de agradecimiento: Te permite añadir un mensaje de agradecimiento personalizado luego de que un usuario responde el formulario, junto a un botón que lo llevará a una página del sitio. La URL del botón es una URL relativa del sitio asociado al formulario. También podrás determinar si quieres que el usuario sea redireccionado automáticamente a esa página luego de un tiempo determinado.
Habilitar segmentación: Si el formulario es privado (solo usuarios registrados lo pueden contestar), podrás seleccionar un conjunto de usuarios que puedan contestar el formulario haciendo uso de los segmentos. Para aprender más dirígete a Segmentos

Atención

En caso de ser un formulario público, los usuarios que no tienen una sesión activa en Modyo, verás tres campos obligatorios en la parte superior del formulario: Nombre, Apellido, y Correo. Una vez que envíen el formulario, se creará un usuario con esos valores y luego la respuesta será asociada a ese usuario.

Atención

Si un usuario no tiene una sesión activa, llena el formulario, y el correo electrónico coincide con uno de los usuario ya registrados en Modyo, entonces la respuesta quedará asociada al usuario ya existente y no se creará uno nuevo.

# Editar formulario

Para modificar un formulario, sigue estos pasos:

En el menú lateral, selecciona Customers y haz click en Reinos.
Selecciona tu reino y haz click en tu formulario.
En el menú de opciones arriba a la derecha, haz click en "Editar".

Una vez que entres en la sección de edición de un formulario, podrás ver 2 secciones: una sección central, donde podrás reorganizar las preguntas arrastrándoles en el orden requerido, y la sección lateral derecha, que cuenta con tres pestañas:

# Añadir

Esta sección te permitirá añadir cuantos campos sean necesarios para completar el formulario o eliminar los que no sean necesarios. A continuación se muestran los campos que puedes agregar para un formulario:

Texto simple: Permite al usuario ingresar un texto hasta 256 caracteres.
Párrafo: Permite al usuario ingresar un texto de múltiples líneas hasta 65535 caracteres.
Número: Le permite al usuario ingresar números.
Dropdown: Te permite añadir opciones de las cuales el usuario podrá elegir una en formato dropdown.
Checkbox: Te permite añadir opciones de las cuales el usuario podrá elegir múltiples en formato checkbox.
Elección: Te permite añadir opciones de las cuales el usuario podrá elegir una en formato radio button.
Fecha: Te permite añadir un campo de fecha en el que el usuario podrá seleccionar una dentro del rango permitido.
Preguntas anidadas: Te permite añadir una serie de alternativas que pueden ser anidadas, de tal forma que al usuario se le solicita que seleccione una de las posibles opciones anidadas dentro de la opción que seleccionó.

Atención

Desde la versión 9.0.8 en adelante, los formularios ya no cuentan con preguntas de tipo archivos, por lo que no podrás requerir que los usuarios suban archivos usando los formularios de Modyo.

Puedes eliminar uno de los campos del formulario haciendo click en el icono de basurero a la derecha de cada campo en la sección principal. La eliminación será efectiva una vez que guardes los cambios.

Peligro

Si tu formulario ya está activado y ya tienes respuestas, ten mucho cuidado al eliminar preguntas de el, ya que al hacerlo, estarás eliminando los valores de esas respuestas que los usuario ya enviaron. Esta acción es irreversible.

# Propiedades del campo

Esta sección te permitirá modificar las opciones para cada una de las preguntas de tu formulario, deberás seleccionar un campo de la sección principal para poder hacer uso de esta sección.

Todos los campos que puedes añadir cuentan con un título, que será la pregunta asociada a la respuesta, la opción de hacer ese campo requerido para enviar el formulario, y una breve descripción en caso de que para responder el campo sean necesarias instrucciones.

Algunos campos cuentan con validaciones, para asegurar que el usuario cumpla con ciertos requisitos para rellenar el campo, algunas de esas restricciones son:

Largo mínimo: Largo requerido para que el texto sea válido
Largo máximo: largo máximo permitido para que el texto sea permitido
Expresión regular: Formato del texto ingresado debe coincidir con la expresión regular asociada para ser válido.
Número mínimo: El número ingresado no puede ser menor que este valor.
Número máximo: El número ingresado no puede ser mayor que este valor.
Fecha mínima: La fecha ingresada no puede ser anterior a este valor
Fecha máxima: La fecha ingresada no puede ser posterior a este valor.

De la misma forma en que algunos campos cuentan con validaciones, la mayoría cuentan con un valor por defecto que venga preseleccionado al momento de cargar el formulario. Los únicos que no cuentan con un valor por defecto son las preguntas anidadas.

# Expresiones Regulares

Para los campos de texto simple y parrafo, podrás agregar validaciones a través de expresiones regulares. Haciendo el click en el botón de funciones, puedes ver las diferentes validaciones predeterminadas:

Email
URL
Número de Teléfono
RUT Chileno
Número de tarjeta bancaria
Código postal Estadounidense
Código postal Canadiense
Código postal Chileno
UUID

Al seleccionar cualquiera de las diferentes opciones y al hacer click en Añadir, se autocompletará la expresión al campo.

# Propiedades del formulario

Esta sección te permitirá cambiar el comportamiento general del formulario. Contiene lo mismo que la vista de creación de un formulario nuevo, pero a su vez agrega un par de opciones nuevas las que se detalla a continuación.

Sus secciones son:

General
Snippet
Opciones
Notificaciones
JS Personalizado

# General

La sección General agrega dos opciones:

Texto del botón enviar: Te permite personalizar el texto asociado al botón Enviar del formulario.
Habilitado: Te permite determinar si los usuarios podrán o no responder el formulario. Si la opción está marcada, entonces se podrá acceder y responder el formulario, si no está habilitada, entonces los usuarios no lo verán ni podrán responderlo.

# Snippet

La sección Snippet, que sólo aparecerá si el formulario es público, te permitirá copiar un código HTML que podrás usar en cualquier lugar para cargar dinámicamente el formulario, incluso fuera de Modyo.

Atención

Para poder hacer uso adecuado del snippet del formulario, debes tener en cuenta la configuración CORS de tu cuenta en Modyo y los headers de seguridad de donde estés insertando el snippet.

Para hacer uso del snippet dentro de una página en la plataforma Modyo, debes copiar el código Javascript dentro de la sección Javascript y el div en la sección HTML. El apartado de HTML en Pages no puede correr Javascript, es obligatorio el uso del apartado Javascript para correr el código correctamente.

Las secciónes Opciones y Notificaciones no agregan nada diferente a lo que se encuentra en Nuevo Formulario

Atención

Si usas un sitio de Modyo con un dominio personalizado, deberás activar la opción para compartir orígenes de recursos CORS en la configuración de la plataforma.

# Notificaciones

En la sección Notificaciones podrás configurar los distintos correos que se envían luego de que un usuario responde el formulario.

La notificación por correo envía un correo del tipo "administrativo" en el cual se notifica vía ese canal de que alguien respondió el formulario. Puedes asignar un asunto y un listado de correos a los que quieras notificar.

El correo de agradecimiento te permite personalizar un correo que será enviado al usuario que respondió el formulario. Puedes personalizar tanto el asunto como el cuerpo del mensaje haciendo uso de Liquid. Debajo del campo para personalizar el mensaje, podrás ver un listado de variables que puedes usar para personalizar el correo.

A continuación, tienes un ejemplo de código que podrás usar como base para personalizar el correo de agradecimiento.

Message Sent: {{ 'now' | date: "%b %d, %y" }}
<table width="600px">
    <tr>
        <td><b>user name</b></td>
        <td colspan="2"> {{user.name}}</td>
    </tr>
    <tr>
        <td><b>user first name</b> </td>
        <td colspan="2"> {{user.first_name}}</td>
    </tr>
    <tr>
        <td><b>user last name</b></td>
        <td colspan="2"> {{user.last_name}}</td>
    </tr>
    <tr>
        <td><b>user email</b></td>
        <td colspan="2"> {{user.email}}</td>
    </tr>
    <tr>
        <td><b>form name</b></td>
        <td colspan="2"> {{form.name}}</td>
    </tr>
    <tr>
        <td><b>form description</b></td>
        <td colspan="2"> {{form.description}}</td>
    </tr>
    <tr>
        <td colspan="3" align="center" background-color="#f0f8ff"><b>Questions</b></td>
    </tr>
    <tr>
        <td width="15%"><b>Question type</b></td>
        <td width="15%"><b>Question</b></td>
        <td width="70%"><b>Answer</b></td>
    </tr>
    {% for question in form.questions %}
    <tr>
        <td>{{ question.type }}</td>
        <td>{{ question.title }}</td>
        <td>{{ question.answer }}</td>
    </tr>
    {% endfor %}
</table>

# JS Personalizado

Añade funcionalidad como una validación personalizada a tu formulario usando Javascript siguiendo estos pasos:

En la plataforma Modyo, dentro de tu realm, haz click en tu formulario.
Haz click en más opciones y haz click en Ver.
Abre las herramientas de desarrollador e inspecciona el elemento que quieres modificar.
Anota el id del elemento a validar. (e.g. answers_3684_value)
En el apartado de JS Personalizado podrás agregar validaciones o funcionalidad extra usando Javascript.
Haz click en Guardar.

Tip

Este script va a correr en seguida del div que contiene el formulario, por lo que es importante tomar en cuenta que puede ser afectado por el resto de la configuración del sitio. Por ejemplo si este formulario es embebido en otro sitio externo que no puede correr Javascript.

# Respuestas

Al hacer click en un formulario, llegarás a una vista donde se listan todas las respuestas que los usuarios han enviado y la fecha en que respondieron.

Puedes exportar las respuestas a un archivo XLS o CSV seleccionándolas en el listado y luego usando las acciones masivas al final del mismo.

Peligro

Puedes eliminar respuestas una por una usando la acción a la derecha de cada respuesta, o haciendo uso de las acciones masivas, seleccionando múltiples respuestas y luego el botón Borrar al final de la lista. Ten en cuenta que esta acción es irreversible y una vez que una respuesta ha sido eliminada, no podrá ser recuperada.

Para ver en detalle la respuesta de un usuario, basta con hacer click en el nombre del usuario, y accederás al listado de preguntas junto a las respuestas que ese usuario envió en esa determinada ocasión.

← Segmentos Mensajería →