# 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.

Digital factory

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 en la última columna, 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, haz click en la botón principal arriba a la derecha + Nuevo. 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 también 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
  • 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 usuario 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

  • 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 targetizació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 targets. Para aprender más dirígete a Targets

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, y rellena 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.

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. bajo el 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.

Enviaste esta respuesta el: {{ '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>

# Respuestas

Al hacer click en el contador de respuestas de 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 a 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.

# Editar

Para modificar un formulario, deberás ir a la sección "Análisis" y usar la acción "Editar" en el menú de opciones arriba a la derecha.

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 campo

Esta sección te permitirá añadir cuantos campos sean necesarios para completar el formulario o eliminar los que no sean necesarios:

  • 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á que elegir una en formato dropdown.
  • Checkbox: Te permite añadir opciones de las cuales el usuario podrá que elegir múltiples en formato checkbox.
  • Elección: Te permite añadir opciones de las cuales el usuario podrá que 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 y los archivos.

# 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 cuatro principales secciones son:

  • General
  • Snippet
  • Opciones
  • Notificaciones

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ás marcada, entonces se podrá acceder y responder el formulario, si no está habilitada, entonces los usuarios no lo verán ni podrán responderlo.

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.

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 cuenta.