> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Añadir un elemento de encuesta a su widget

> Cree encuestas NPS, CSAT y de feedback en el Widget Studio utilizando elementos de encuesta como botones, escalas, opción múltiple y campos de respuesta corta o larga.

En el Widget Studio, puede crear encuestas totalmente funcionales (por ejemplo, NPS, CSAT, formularios de satisfacción, feedback de productos) utilizando un conjunto de **elementos de encuesta** específicos. Cada elemento incluye su propia personalización.

El conjunto de elementos de encuesta le permite:

* Crear widgets NPS y CSAT estructurados y con marca propia.
* Recopilar feedback cualitativo y cuantitativo.
* Aplicar reglas de validación detalladas.
* Exportar o dirigir las respuestas con flexibilidad.

Los datos de la encuesta se pueden recopilar **en Kameleoon** (exportables en formato .csv) o **enviarse a un servicio externo** mediante una solicitud HTTP.

## Elementos de encuesta

Los elementos de encuesta se enumeran en la sección **Encuesta** del panel **Añadir elemento**.

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-a-widget-with-the-widget-studio/create-csat-nps-and-surveys/add-a-survey-element-to-your-widget/Capture-decran-2025-05-19-a-11.13.58.png)
</Frame>

* **Botón:** Necesario para desencadenar el envío de la encuesta.
* **Respuesta corta:** Recopila entradas de texto breves de los usuarios.
* **Respuesta larga:** Ideal para feedback abierto y más extenso.
* **Opción múltiple:** Incluye compatibilidad con casillas de verificación, selección única o múltiple, campo "Otro" opcional y aleatorización de respuestas.
* **NPS:** Recopila datos de Net Promoter Score con preguntas de seguimiento opcionales.
* **Escala:** Muestra una escala utilizando números o emojis.

Cada elemento se puede configurar utilizando opciones de configuración y estilo específicas en el Widget Studio.

## Configuración

### Botón

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-csat-nps-and-survey/add-a-survery-element-to-your-widget/button.png)
</Frame>

#### Configuración general

* **Texto del botón:**
  * Introduzca el texto de su botón en el campo de texto.
  * Utilice los botones encima del campo de texto para:
    * Editar su texto con IA.
    * Acceder a las opciones de estilo.
    * Editar la fuente de su texto.
    * Cambiar la alineación de su texto.
    * Editar el color de su texto.
    * Añadir un emoji.
  * Haga clic en el **menú de tres puntos** para:
    * Eliminar el formato.
    * Expandir el editor de texto.
* **Estilo:** Cambie el tipo y color de fondo del botón.
* **Animación:** Seleccione una animación de entrada o salida para su botón.

#### Configuración avanzada

En **Configuración avanzada**, puede definir:

* **Estado predeterminado:** Si el botón aparecerá de forma predeterminada.

<Note>
  Si selecciona **Deshabilitado** y previamente activó **Hacer obligatorio** en cualquier encuesta, el botón se habilitará automáticamente una vez que los usuarios respondan a todos los elementos obligatorios de la misma pantalla.
</Note>

* **URL de redirección:** La URL a la que se redirigirá a los usuarios que hagan clic en el botón.
* **Abrir en pestaña nueva:** Alterne si la URL de redirección se abrirá en una pestaña nueva.

#### Diseño

Hay dos pestañas en el menú **Diseño**: **General** y **Estilo**.

##### General

En la pestaña **General**, puede definir:

* **Alineación:** Cambie la alineación del botón.
* **Reposicionar y redimensionar:** Puede posicionar su botón en los ejes **X** e **Y** o definir su anchura y altura en píxeles o en porcentaje.
  * Haga clic en **Activar configuración de traslación** para acceder a las opciones de traslación. Puede trasladar su botón desde su posición actual en el eje X o Y en una cantidad definida en píxeles o en porcentaje.
* **Sincronización de dispositivos:** Seleccione un dispositivo y defina cómo se sincronizará el botón con otros dispositivos.
  * **Totalmente sincronizado:** Todas las propiedades del botón se sincronizarán con el dispositivo maestro.
  * **Parcialmente sincronizado:** Todas las propiedades del botón se sincronizarán con el dispositivo maestro, a menos que una propiedad cambie en otro dispositivo.
  * **Sin sincronización:** Ninguna de las propiedades del botón se sincronizará con el dispositivo maestro. Debe definir las propiedades del botón en este dispositivo por separado.
  * **Ocultar:** El botón no será visible en el dispositivo.
* **Relleno:** Añada relleno entre los bordes del botón y su texto.
* **CSS y clases:** Añada CSS y clases para dar estilo a su botón.

##### Estilo

En la pestaña **Estilo**, puede definir:

* **Estado:** Puede ser **Habilitado**, **Hover** o **Deshabilitado**.
* **Texto:** Determine la altura de línea del texto y aplique las transformaciones deseadas.
* **Fondo:** Cambie el tipo o color de fondo del botón.
* **Borde:** Añada un borde alrededor de todos los lados del botón o un borde personalizado.
* **Sombra:** Añada una sombra y edite su color o posición.

### Respuesta corta y Respuesta larga

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-a-widget-with-the-widget-studio/create-csat-nps-and-surveys/add-a-survey-element-to-your-widget/Capture-decran-2025-05-19-a-15.24.42-1536x914.png)
</Frame>

#### Configuración general

* **Etiqueta/Pregunta:** La indicación o pregunta principal.
* **Marcador de posición (opcional):** Texto mostrado antes de la entrada del usuario; desaparece en cuanto el usuario empieza a escribir.
* **Valor precargado (opcional):** Inserta una respuesta predefinida en el campo.
* **Estado predeterminado:** Determina si el campo está habilitado o deshabilitado al cargar.

#### Configuración avanzada

* **Posición de la etiqueta:** Posicione la etiqueta encima o debajo del campo de entrada.
* **Límite de caracteres:** Número máximo de caracteres permitidos.
* **Hacer obligatorio:** Obliga a los usuarios a responder a cierta pregunta antes de enviar. Se añade automáticamente un `*` a la etiqueta. Al habilitar **Hacer obligatorio** se revela la sección **Regla de validación**, lo que le permite definir restricciones de entrada adicionales.
* **Regla de validación:**

| Tipo de regla    | Descripción                                                           |
| ---------------- | --------------------------------------------------------------------- |
| **No vacío**     | La entrada no debe estar en blanco.                                   |
| **Alfanumérico** | Acepta solo letras y números.                                         |
| **Longitud**     | Defina el recuento mínimo/máximo de caracteres.                       |
| **Regex**        | Aplica una expresión regular personalizada para controlar el formato. |

* **Mensaje de error:** Mensaje personalizado mostrado cuando falla la validación. El estilo del mensaje de error puede configurarse en **Diseño** > **Respuestas** seleccionando el **estado Inválido**.

### Opción múltiple

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-a-widget-with-the-widget-studio/create-csat-nps-and-surveys/add-a-survey-element-to-your-widget/Capture-decran-2025-05-19-a-15.24.42-1536x914.png)
</Frame>

#### Configuración general

* **Pregunta:** El texto de la pregunta mostrado encima de las respuestas.
* **Respuestas:** Añada, elimine o reordene las opciones de respuesta. Haga clic en **Añadir una respuesta** para crear más opciones.

#### Configuración avanzada

* **Selección múltiple:** Permite a los usuarios seleccionar más de una respuesta. Si está deshabilitada, solo se puede marcar una respuesta.
* **Añadir "Otro":** Añade una entrada de texto abierta etiquetada como "Otro" para que los usuarios puedan escribir una respuesta personalizada.
* **Aleatorizar respuestas:** Mezcla aleatoriamente el orden de las respuestas listadas para cada usuario para reducir el sesgo de selección.
* **Hacer obligatorio:** Si está habilitada, los usuarios deben seleccionar al menos una respuesta para enviar la encuesta. Se añade automáticamente un `*` después de la etiqueta de la pregunta (mismo estilo que **Pregunta** en la pestaña **Diseño**).

### Escala

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-a-widget-with-the-widget-studio/create-csat-nps-and-surveys/add-a-survey-element-to-your-widget/Capture-decran-2025-05-19-a-15.44.30-1-1536x916.png)
</Frame>

#### Configuración general

* **Tipo de escala:** Emojis, estrellas, corazones o números.
* **Número de elementos de la escala:** Número de valores en la escala (por ejemplo, 1-5).
* **Pregunta:** La indicación principal.

#### Etiquetas de la escala

* **Posición de la etiqueta:** Elija mostrar las etiquetas encima, debajo o no mostrarlas.
* Puede personalizar las etiquetas para cada elemento de la escala.

#### Configuración avanzada

**Hacer obligatorio:** Respuesta obligatoria antes del envío.

### NPS

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/assets/widgets/create-a-widget-with-the-widget-studio/create-csat-nps-and-surveys/add-a-survey-element-to-your-widget/Capture-decran-2025-05-19-a-15.44.01-1-1536x915.png)
</Frame>

#### Estructura de la pregunta

* La redacción de la pregunta NPS es parcialmente fija debido a la estandarización. Solo se pueden editar partes de la pregunta. Para cambiar el idioma, vaya a la pestaña **Traducción** y establezca un idioma predeterminado.

#### Campos

* **¿Qué tan probable es que recomiende (X) a (Y)?**
  * Puede editar los campos de producto/servicio y de destinatario.
* **Pregunta de seguimiento (opcional):**
  * Puede mostrarse a **todos los usuarios** o solo a:
    * Promotores (puntuación 9-10)
    * Pasivos (puntuación 7-8)
    * Detractores (puntuación 0-6)
  * Permite contenido de seguimiento condicional.
* **Hacer obligatorio:** Solo la **puntuación NPS inicial** puede marcarse como obligatoria. La pregunta de seguimiento siempre es opcional.
