# Encuestas

> El módulo de espacio Encuestas. Cómo el equipo crea un espacio de una encuesta o de varias, arma el cuestionario por secciones en un editor que ya es la pantalla de respuesta (desde una plantilla NPS, satisfacción, evento, curso, eNPS o en blanco), lo abre para quien tiene acceso al espacio con una invitación por correo y/o por el enlace público sin iniciar sesión, identificada o anónima, y lee el resultado con filtros y CSV.

La **encuesta** es un cuestionario del equipo, con varias preguntas organizadas en **secciones**, para quien tiene acceso a un espacio de la comunidad y/o para cualquier persona con el **enlace público**. Sirve para medir el NPS de la comunidad, la satisfacción con un evento o un curso, el eNPS de una empresa, o lo que el equipo quiera preguntar, sin Google Forms ni Typeform, con el resultado consolidado dentro de la comunidad.

**Encuestas** es un [módulo de espacio](/conceitos/modulos), en la pestaña **Comunidad** de **Añadir Espacio**. Toda encuesta vive en un espacio de Encuestas, y **quien tiene acceso al espacio es su público**. No hay que confundirla con la [votación](/espacos/enquetes) del Feed, que es una sola pregunta publicada como post.

## Encuesta o votación

| | [Votación](/espacos/enquetes) | Encuesta |
|---|---|---|
| Qué es | Una pregunta, de 2 a 10 opciones, publicada como post | Un cuestionario: secciones, hasta 100 preguntas, 5 tipos de pregunta |
| Dónde aparece | En el Feed o en un espacio de Contenido, con reacciones y comentarios | En un espacio de Encuestas, en una pantalla propia de respuesta, por etapas; nada va al Feed |
| Quién responde | Quien ve el post | Quien tiene acceso al espacio y/o cualquier persona con el enlace público, sin iniciar sesión |
| Anonimato | El equipo ve quién votó qué | Identificada o anónima, elegida antes de abrir |
| Resultado | Barras en el propio post | Panel por sección, NPS, filtros y CSV |

Para una pregunta rápida del día a día, la votación. Para un feedback estructurado, la encuesta.

## Para qué sirve

| Comunidad | Encuesta |
|---|---|
| Evento | La encuesta de satisfacción del evento, respondida por el enlace también por quien no es miembro |
| Escuela online | El feedback de un curso: contenido, instructor, aplicabilidad |
| Coworking | El NPS de los residentes, una vez por semestre |
| Empresa | El eNPS del equipo, anónimo |

## Cómo funciona

### El espacio: una encuesta o varias

Al crear el espacio, **Cómo funciona el espacio** pregunta:

| Modo | Cómo queda |
|---|---|
| **Varias encuestas** (lo predeterminado) | Una lista de encuestas. El equipo ve todas, con los filtros **Todas**, **Borradores**, **Programadas**, **Abiertas** y **Cerradas** (la programada muestra *Abre el…*), y crea con **Nueva encuesta**; el miembro ve las que puede responder, con **Responder** o **Respondida**, y la marca **Obligatoria** en las obligatorias |
| **Una encuesta** | El espacio es una encuesta: quien entra va directo a ella. El equipo ve el editor (o el resultado, una vez abierta); el miembro, el formulario. Vacío, muestra **Crear encuesta** al equipo |

**Una encuesta** solo es posible con como máximo una encuesta en el espacio (borradores y cerradas cuentan): cambiar a ese modo con dos o más se rechaza, y una segunda encuesta también. El modo se cambia después en la configuración del espacio.

**El espacio nace con la encuesta.** En **Una encuesta**, **Siguiente** lleva a un tercer paso, **Encuesta**, en la misma ventana: **Empieza con** (una plantilla o **En blanco**), **Título de la encuesta** (obligatorio), **Descripción**, **Modo** (identificada o anónima) y **Tipo de respuesta**. **Crear encuesta** crea el espacio y la encuesta, como borrador, y abre su editor enseguida: *"La encuesta nace como borrador: nadie recibe nada hasta que la abras."* Si la encuesta se rechaza, el espacio queda creado, el paso conserva lo escrito y solo se reintenta la encuesta. Los espacios de [una convocatoria](/espacos/chamada-de-trabalhos) y de [un curso](/espacos/cursos#cursos-en-el-modo-un-solo-curso) funcionan igual: terminan abiertos en la convocatoria o en el curso.

Un ejemplo: un espacio **Encuesta del evento**, en modo **Una encuesta**, privado para quien compró la entrada; y un espacio **Encuestas**, en modo **Varias encuestas**, abierto a los miembros, con el NPS del semestre y las encuestas de cada curso.

### Quién hace qué

| Quién | Qué hace |
|---|---|
| Propietario y administrador | Todo: crean el espacio y las encuestas, editan el borrador, activan el enlace, abren, cierran, eliminan, ven el resultado y las respuestas y exportan el CSV |
| Miembro (y moderador y finanzas) | Con acceso al espacio, responde sus encuestas abiertas, en el espacio o por la invitación por correo |
| Quien no tiene cuenta | Responde por el enlace público, si la encuesta está abierta y con el enlace activado; nada más |

### Las plantillas

**Nueva encuesta** abre la elección de la plantilla. Las preguntas vienen listas, en el idioma de la comunidad, y todo se edita antes de abrir.

| Plantilla | Qué trae | Modo |
|---|---|---|
| **NPS de la comunidad** | Una sección: la nota de 0 a 10 y *"¿Qué pesó más en tu nota?"* | Identificada |
| **Encuesta de satisfacción** | Una sección: la satisfacción general de 1 a 5, en estrellas, y un comentario | Identificada |
| **Feedback del evento** | Cuatro secciones: **Contenido** (charlas y temas), **Infraestructura** (lugar, comida, wifi), **Experiencia** (organización, NPS del evento y comentario) y **Perfil** (*"¿Fue tu primera vez en el evento?"*). Las valoraciones usan Excelente, Bueno, Regular, Malo y No aplica | Anónima, con el enlace público activado |
| **Feedback del curso** | Una sección: contenido, instructor y aplicabilidad, con la misma escala, y *"¿Qué podría mejorar?"* | Identificada |
| **eNPS** | Una sección: *"¿cuánto recomendarías la empresa como lugar para trabajar?"* y el porqué | Anónima |
| **En blanco** | Una sección vacía, para armar desde cero | Identificada |

### Secciones

Toda encuesta tiene **al menos una sección**, con título y descripción opcional; cada pregunta pertenece a una sección. Para quien responde, las secciones son **etapas**:

- El **título** y la **introducción** de la encuesta abren la primera pantalla, con el modo (anónima o identificada), el número de etapas y de preguntas y el botón **Empezar**.
- Arriba, la barra con el título de cada etapa (*Contenido · Infraestructura · Experiencia · Perfil*). En el móvil, pasa a *"Etapa 2 de 4 · Infraestructura"*. Una encuesta de una sola sección no muestra la barra.
- **Siguiente** solo avanza con las obligatorias de la etapa respondidas; **Volver** conserva lo marcado; **Enviar** aparece en la última etapa.
- La respuesta se graba **una sola vez, al Enviar**. Nada queda guardado en el servidor a medias: si la persona cierra la pestaña antes, empieza de nuevo.

En el resultado, las preguntas aparecen agrupadas por sección, en el mismo orden. Una encuesta tiene hasta **20 secciones** y **100 preguntas**.

### El editor

Armar la encuesta es editar **la propia pantalla de quien responde**, con los colores de la comunidad, como en el editor de [campañas](/notificacoes/campanhas-de-email):

- **Haz clic para escribir** en el sitio: título, introducción, título y descripción de la sección, enunciado, ayuda y opciones.
- Las **secciones** aparecen como las etapas, en pestañas arriba del lienzo; **Sección** crea una nueva. **Eliminar sección** borra también sus preguntas, después de confirmar.
- El **+** entre las preguntas inserta una pregunta (uno de los 5 tipos) o una sección nueva.
- **Arrastra** por el asa para reordenar las preguntas dentro de la sección; arrastra una pregunta hasta la pestaña de otra etapa para moverla allí; arrastra las pestañas para reordenar las secciones. **Mover a la sección**, **Subir** y **Bajar**, en el panel, hacen lo mismo sin arrastrar.
- El **panel** de la pregunta seleccionada tiene **Tipo**, **Obligatoria**, las opciones de la escala, **Duplicar** (copia también las opciones, útil cuando la misma escala se repite) y **Eliminar**.
- **Ordenador** y **Móvil** cambian el ancho; **Vista previa** recorre las etapas como quien responde, con **Enviar (vista previa)**, sin grabar nada.

Arriba están **Público y enlace**, **Modo**, **Tipo de respuesta**, **Período**, **Vista previa**, **Guardar borrador** y **Abrir** (o **Programar**, con un inicio en el futuro). En una programada, **Cancelar programación** en lugar de **Abrir**; en una abierta, **Cerrar**. Junto al título aparece **Cambios sin guardar** o **Todo guardado**.

La barra del editor muestra solo el título, el estado y la acción principal; la configuración pasa a resúmenes en los que se hace clic, y **Pausar**, **Cerrar** y **Eliminar** quedan en **Más acciones**. El aviso del modo queda encima de la introducción, y una encuesta **identificada** cuya introducción habla de anonimato muestra *"La introducción habla de anonimato, pero la encuesta es identificada."*, con **Corregir texto**. Las plantillas muestran las primeras preguntas antes de elegir.

### Los 5 tipos de pregunta

| Tipo | Cómo se responde | Detalles |
|---|---|---|
| **Opción única** | Una opción | De 2 a 30 opciones, sin repetir |
| **Opción múltiple** | Una o más opciones | De 2 a 30 opciones |
| **Escala** | Un número de un mínimo a un máximo | Mínimo 0 o 1, máximo de 2 a 10, etiquetas opcionales en los extremos (*Muy insatisfecho*, *Muy satisfecho*); **Mostrar como estrellas** usa una escala de 1 a 5 en estrellas |
| **NPS (0 a 10)** | Una nota de 0 a 10 | El resultado calcula el NPS (ver [El resultado](#el-resultado)) |
| **Texto** | Una respuesta escrita | Corta o **Respuesta larga**, hasta 5.000 caracteres |

Cualquier pregunta puede ser **Obligatoria**. No hay lógica condicional (saltar preguntas según la respuesta), matriz ni envío de archivos.

### Identificada o anónima

El **Modo** se elige en el borrador y **no cambia después de abierta**. La introducción dice el modo antes de la primera pregunta.

| Modo | Qué ve el equipo |
|---|---|
| **Identificada** | La respuesta de cada miembro ligada a su nombre, con la fecha. Quien responde por el enlace público sin iniciar sesión aparece como **Visitante**, con la fecha |
| **Anónima** | Solo el conjunto: ningún nombre, ninguna hora, ninguna lista de quién respondió o de quién falta, ni cuántos faltan |

En la anónima, la introducción dice exactamente: *"Encuesta anónima: la comunidad no puede vincular la respuesta contigo."* Esa es la promesa: la comunidad (equipo, API, asistente, CSV) no tiene cómo saber quién respondió qué. La respuesta se guarda sin la persona y sin hora, separada del registro de que ya respondió, y las respuestas nunca aparecen en el orden en que llegaron.

Los cuidados de la anónima:

- **Mínimo de 3 respuestas.** Antes, el resultado muestra *"El resultado aparece con 3 respuestas"* y ningún número ni texto.
- **Publicación en bloques de 3.** Las respuestas entran en el resultado de 3 en 3, siempre 3 nuevas del mismo origen (miembros o visitantes). El número de respuestas crece de 3 en 3, y una respuesta sola nunca cambia el resultado: comparar dos lecturas no revela lo que respondió una persona.
- **Filtro solo por origen.** En la anónima, el resultado se filtra solo por **miembros** o **visitantes**; grupo, etiqueta y empresa quedan para la identificada. El recorte aparece cuando él **y el resto** tienen al menos 3 respuestas cada uno. Sin la regla del resto, un recorte de 3 en una encuesta de 4 delataría a la cuarta persona por la diferencia.
- **Textos mezclados y sin fecha.**
- **CSV sin persona, sin segmento, sin origen y sin fecha**, solo a partir de 3 respuestas y solo con las respuestas ya publicadas en los bloques de 3.

> [!WARNING]
> En una encuesta **identificada**, la respuesta es un dato personal de la comunidad, que es la responsable del tratamiento. No preguntes por salud, religión, opinión política u otro dato sensible en una identificada; si lo necesitas, usa la anónima.

### Público y enlace

El público es **quien tiene acceso al espacio**: su [visibilidad](/conceitos/visibilidade-e-acesso) y, en un espacio privado, los grupos, productos y planes de **Quién tiene acceso**. La encuesta necesita **alguien con acceso al espacio, el enlace público activado, o los dos**.

- **Público**: **Público y enlace** muestra cuántas personas tienen hoy acceso al espacio (hasta 50.000), con algunos nombres. Para cambiar quién responde, cambia el acceso del espacio. El público se **congela cuando la encuesta se abre**: quien reciba acceso al espacio después no entra en ella.
- **Invitación por correo**: al abrir, con la casilla **Avisar por correo** marcada (por defecto), cada persona del público recibe **un** correo de invitación, 10 minutos después, con el botón **Responder**, si dejó activada la categoría **Encuestas** en [Correos de esta comunidad](/notificacoes/emails-desta-comunidade). Editar la encuesta después no la reenvía. El botón lleva a la misma dirección para todos, así que el correo no vincula a nadie con una respuesta anónima.
- **Enlace para los miembros**: la dirección de la invitación. Quien tiene acceso al espacio responde por él, con sesión iniciada, o directamente en el espacio. Quien lo abre con sesión iniciada y no tiene acceso ve *"Esta encuesta no es para ti"* (salvo que el enlace público esté activado).

  El enlace de la invitación abre la encuesta **dentro de su espacio**, con el menú de la comunidad. Quien responde llega al formulario (o al aviso de ya respondida o cerrada, según el caso); el propietario y el administrador llegan al editor, si la encuesta es borrador o programada, o al resultado, si está abierta o cerrada. Si ningún espacio del menú de la persona tiene la encuesta, la pantalla de respuesta suelta explica por qué. En un espacio de **Varias encuestas**, la dirección del navegador sigue a la encuesta abierta: puedes copiarla, enviarla a alguien del equipo y recargar la página sin volver a la lista.

- **Espacio**: en borrador, la encuesta puede pasar a otro espacio de Encuestas.
- **Enlace público**: cualquier persona con el enlace responde **sin iniciar sesión**, en el dominio de la propia comunidad (el personalizado, si lo tiene, o su dirección en `memberfy.net`, como `clube.memberfy.net/s/…`), con la marca de la comunidad, aunque la comunidad sea privada (la página muestra solo la encuesta). **Copiar** copia la dirección; desactivarlo hace que el enlace diga *"Este enlace no está disponible"*. La dirección es larga y aleatoria: no se puede adivinar la de otra encuesta.

**Quién ya respondió.** Por el enlace público, la respuesta repetida se bloquea **por esfuerzo, sin garantía**:

- **Quien abre el enlace sin iniciar sesión** recibe un marcador **en este navegador** (la pantalla avisa: *"Guardamos un marcador en este navegador solo para evitar respuestas repetidas"*). En el mismo navegador, el segundo intento ve *"Ya respondiste en este navegador. ¡Gracias!"*. **Una ventana privada, otro navegador, otro dispositivo o los datos del navegador borrados responden de nuevo.** Si la encuesta necesita de verdad una respuesta por persona, usa el público de la comunidad, sin el enlace público.
- **Quien lo abre con sesión iniciada y es miembro de la comunidad de la encuesta** responde **como miembro**, una sola vez de verdad, en cualquier navegador: el segundo intento ve *"Ya respondiste"*. La respuesta sigue el modo de la encuesta. Con sesión en otra comunidad, cuenta como visitante.

**Contra robots y abusos**, el enlace público tiene:

- una **verificación contra robots** que hace el propio navegador en un segundo aproximadamente, sin hacer clic en nada y sin enviar datos a terceros (si falla, la pantalla pide enviar de nuevo);
- un límite de **300 envíos cada 10 minutos por red**, por encuesta (por encima, *"Demasiados envíos desde esta red. Espera unos minutos e inténtalo de nuevo."*);
- un tope de **5.000 respuestas de visitantes** por encuesta; las respuestas de miembros no cuentan para el tope;
- y el equipo puede **desactivar el enlace** en cualquier momento.

La dirección de red de quien responde no se guarda con la encuesta.

### Período y programación

**Período** define el **Inicio** y el **Fin** de la recogida, en la zona horaria de la comunidad: *"Fuera de ese período nadie responde."* El fin tiene que ser después del inicio.

- **Sin Inicio** (*Al abrir*), la encuesta empieza cuando el equipo pulsa **Abrir**.
- **Con un Inicio en el futuro**, el botón pasa a **Programar**. La confirmación dice cuándo se abre y desde cuándo sale la invitación por correo: *"La encuesta se abre sola el … y la invitación por correo sale a partir de …. No se envía nada antes."* A esa hora la encuesta **se abre sola**, exactamente como si el equipo hubiera pulsado **Abrir**: el público se congela en ese momento y la invitación sale 10 minutos después (si **Avisar por correo** quedó marcado al programar).
- **Programada**, sigue **editable como un borrador**, entera (preguntas, modo, tipo de respuesta, período). **Cancelar programación** (o quitar el Inicio) la devuelve a borrador: *"Programación cancelada: la encuesta volvió a borrador."*
- **Con Fin**, se cierra sola en la fecha y hora elegidas. Sin Fin, queda abierta hasta que alguien del equipo pulse **Cerrar**.

**Fuera del período, nadie responde, por ningún camino** (en el espacio, por el enlace de la invitación o por el enlace público). Antes del inicio, la pantalla dice *"Esta encuesta todavía no empezó"* y cuándo se abre; después del fin, o cerrada, el enlace público muestra *"Encuesta cerrada"*. **Una encuesta cerrada no se reabre**; las respuestas y el resultado siguen disponibles.

### Tipo de respuesta

**Tipo de respuesta** dice cuánto cuenta la comunidad con la respuesta. Se elige en el borrador (o en el paso **Encuesta** del espacio de una encuesta) y **se bloquea al abrir**.

| Tipo | Para quien está en el público |
|---|---|
| **Encuesta opcional** (lo predeterminado) | La invitación por correo y la encuesta en el espacio. Ninguna ventana en la app: *"No se presiona a nadie."* |
| **Encuesta obligatoria** | Marcada como **Obligatoria** en la lista y en la pantalla de respuesta (*"Esta encuesta es obligatoria: el equipo cuenta con tu respuesta."*), y la invitación dice que la respuesta es obligatoria. Al entrar en la app, la ventana *"Una encuesta espera tu respuesta"*, con **Ahora no** |
| **Respuesta inmediata** | Como la obligatoria, pero la ventana no tiene **Ahora no** ni se cierra: *"Para seguir usando la app, responde esta encuesta."* Desaparece cuando la persona responde o cuando la encuesta se cierra |

El tipo vale para quien entró en el público al abrir; quien obtuvo acceso al espacio después ve la encuesta como opcional. En la identificada, obligatoria e inmediata muestran en el resultado quién falta por responder (ver [El resultado](#el-resultado)).

Una vez abierta, la estructura se bloquea: solo cambian el **título**, la **introducción**, el **Fin** del período y el **enlace público** (activar o desactivar), con **Guardar cambios**. El **Inicio**, el **Modo** y el **Tipo de respuesta** ya no cambian.

Eliminar el espacio elimina sus encuestas y desactiva los enlaces públicos.

### Quien sale de la comunidad

Cuando un miembro sale de la comunidad (por su cuenta, eliminado por el equipo, por el asistente, al terminar el vínculo con la empresa o al rechazar una invitación de importación), **sus respuestas identificadas se borran de verdad**, y el resultado se recalcula. Las respuestas **anónimas se quedan**, porque no hay cómo saber de quién son. Es la única excepción a la regla de que Memberfy guarda los datos de la comunidad.

## Paso a paso

### Crear el espacio

*Rol: propietario o administrador.*

1. En el menú, debajo de la sección, haz clic en **Añadir Espacio**.
2. En la pestaña **Comunidad**, elige **Encuestas** y haz clic en **Siguiente**.
3. Escribe el título y elige la **Visibilidad** (y, si es **Privada**, **Quién tiene acceso**): es quien va a responder.
4. En **Cómo funciona el espacio**, elige **Varias encuestas** o **Una encuesta**. Con **Varias encuestas**, crea el espacio.
5. Con **Una encuesta**, **Siguiente** lleva al paso **Encuesta**: elige la plantilla (o **En blanco**), el título, la descripción, el **Modo** y el **Tipo de respuesta**, y haz clic en **Crear encuesta**. El espacio y la encuesta nacen juntos y se abre el editor; sigue en [Crear y abrir la encuesta](#crear-y-abrir-la-encuesta), paso 3.

Consulta [Crear y organizar espacios](/espacos/criar-e-organizar-espacos).

### Crear y abrir la encuesta

1. En el espacio, haz clic en **Nueva encuesta** (en modo **Una encuesta**, **Crear encuesta**).
2. Elige una plantilla, o **En blanco**.
3. Ajusta el título, la introducción, las secciones y las preguntas directamente en el lienzo. Revísalo en **Vista previa**.
4. En **Modo**, elige **Identificada** o **Anónima**. En **Tipo de respuesta**, **Encuesta opcional**, **Encuesta obligatoria** o **Respuesta inmediata**.
5. En **Público y enlace**, comprueba cuántas personas tienen acceso al espacio y, si quieres, activa el **Enlace público**. En **Período**, el **Inicio** (vacío para empezar al abrir) y el **Fin**, si lo hay.
6. **Guardar borrador**. Hasta abrirla, nadie ve la encuesta, ni por el enlace.
7. **Abrir** y confirma: la ventana indica a cuántas personas va la invitación por correo. El público se congela y la encuesta empieza a aceptar respuestas. Con un Inicio en el futuro, el botón es **Programar**: la encuesta queda **Programada** y se abre sola a la hora fijada.
8. Si el enlace público está activado, difunde la dirección, copiada en **Público y enlace**.

### Responder (miembro)

Quien tiene acceso al espacio responde de dos formas: abriendo el espacio en el menú (en modo **Varias encuestas**, haciendo clic en **Responder**) o con el botón **Responder** de la invitación por correo. Una encuesta ya respondida aparece como **Respondida**; una obligatoria, como **Obligatoria**. Una encuesta programada no aparece a quien responde hasta que se abre; quien llega antes por el enlace ve *"Esta encuesta todavía no empezó"*.

**El aviso en la app.** Solo en las encuestas **obligatorias** y de **respuesta inmediata**: al entrar en la comunidad, quien está en el público y aún no respondió ve un único aviso (*"Una encuesta espera tu respuesta"*), con cada encuesta, el plazo y si es **Anónima**. Hacer clic en una encuesta abre la respuesta. En la obligatoria, **Ahora no** cierra el aviso de esas encuestas, y no vuelve para ellas. En la de respuesta inmediata no hay **Ahora no**: el aviso vuelve en cada pantalla hasta que la persona responde o la encuesta se cierra. Responder saca la encuesta del aviso. La encuesta opcional no abre aviso: llega por la invitación por correo y por la lista del espacio.

### Ver el resultado

En el espacio, haz clic en una encuesta abierta o cerrada (un borrador abre el editor); en modo **Una encuesta**, el resultado aparece directamente una vez abierta. La lista muestra, en cada una, destinatarios, respuestas y el plazo.

## El resultado

**La cabecera.** El título de la encuesta, el estado (**Abierta**, **Cerrada**…), si es **Identificada** o **Anónima** y el plazo, con **Editar** y **Exportar CSV**. En la anónima, el **(i)** junto a **Anónima** explica las reglas de anonimato (los bloques y el filtro solo por origen). En el móvil, los botones quedan solo con el icono.

**Las secciones, en pestañas.** Justo debajo, las pestañas **Resumen**, **Respuestas individuales** (solo en la identificada), **Rondas** (solo en la recurrente) y **Mapa de calor** (solo en la identificada). En la misma línea están los filtros: **Origen** (**Todas**, miembros o visitantes) y **Segmento** (un grupo, una etiqueta o una empresa; **Todos los segmentos** vuelve al total). En el móvil, los filtros están en **Filtros**. Una encuesta sin otras pestañas muestra el origen como botones.

**Las tarjetas de arriba.** Solo las que tienen algo que decir, repartidas por igual en la fila:

| Tarjeta | Qué muestra | Cuándo aparece |
|---|---|---|
| **Respuestas** | El total, con *N de miembros · N de visitantes* | Siempre que hay respuestas |
| **Tasa de respuesta** | El porcentaje sobre los destinatarios (*de N destinatarios*). Los visitantes no entran en la cuenta, porque no tienen denominador. En la anónima, cuenta solo las respuestas ya publicadas | Cuando la encuesta tiene destinatarios |
| **Última respuesta** | Hace cuánto llegó la última, con *N en los últimos 7 días* | En la identificada |
| **Último bloque publicado** | Hace cuánto entró el último bloque en el resultado, con *N en los últimos 7 días* | En la anónima |
| **NPS** | La nota de la primera pregunta NPS y las tres franjas: **Detractores**, **Neutrales** y **Promotores**, en porcentaje | Cuando la encuesta tiene una pregunta NPS |

**Respuestas por día.** Un gráfico con cuántas respuestas llegaron cada día, en la zona horaria de la comunidad, siguiendo el filtro. En la **anónima**, la encuesta no guarda la hora de ninguna respuesta: el gráfico se llama **Respuestas publicadas por día** y cuenta los bloques que entraron en el resultado cada día, nunca cuándo respondió alguien. Las respuestas publicadas antes de ese registro aparecen en una nota debajo. El gráfico solo aparece con al menos dos días y alguna respuesta. En una encuesta anónima filtrada por **Origen** o **Segmento**, cuando parte de las respuestas se publicó antes del registro diario, el gráfico no aparece y en su lugar se lee *"El gráfico por día no está disponible para este segmento."*

**Una tarjeta por pregunta**, agrupadas por sección (el nombre de la sección aparece cuando hay más de una), en dos columnas en pantalla ancha. Cada tarjeta dice el tipo y cuántas personas respondieron:

- **Opción única y opción múltiple:** barras con el porcentaje y el recuento; la opción más elegida queda destacada.
- **NPS:** la nota (de −100 a 100: % de promotores menos % de detractores), las tres franjas y el histograma de 0 a 10 con la **Media**. Promotores son las notas 9 y 10, neutrales 7 y 8, detractores de 0 a 6.
- **Escala:** la **Media** y el histograma de las notas.
- **Texto:** las respuestas en lista (hasta 1.000 por pregunta). Con más de 4, aparecen las 4 primeras, la búsqueda **Buscar en las respuestas** y **Ver todas (N)**.
- Una pregunta que nadie respondió dice *"Nadie ha respondido a esta pregunta todavía."*

**Estados vacíos.** Sin ninguna respuesta: *"Todavía no hay respuestas"*, con *"El resultado aparece aquí en cuanto lleguen las primeras respuestas."* (o *"La encuesta se cerró sin respuestas."*). Con un filtro sin nada: *"No hay respuestas en este segmento."* En la **anónima** con menos de 3 respuestas publicadas: *"El resultado aparece con 3 respuestas"*, sin ningún número, y la explicación: después, el resultado crece en bloques de 3 respuestas, publicados cada hora, para que nadie descubra quién acaba de responder.

**En las otras pestañas:**

- **Respuestas individuales:** solo en la identificada, con el nombre del miembro (o *Visitante*) y la fecha, de la más reciente a la más antigua.
- **Faltan por responder:** solo en la **identificada** con **Encuesta obligatoria** o **Respuesta inmediata**, encima del resumen: los nombres de quien está en el público y aún no respondió, con el recuento (*"Mostrando N de M."* cuando la lista es larga), o *"Todo el público ya respondió."* En la **anónima**, el resultado no muestra nada sobre quién ni cuántos faltan, en ningún tipo de respuesta: comparar el recuento antes y después de una respuesta revelaría quién respondió.
- **Filtro:** uno a la vez. En la anónima, solo **Origen**, con el mínimo de 3 y la regla del complemento.
- **Exportar CSV:** una fila por respuesta y una columna por pregunta, con la sección en la cabecera. En la identificada, empieza con nombre, correo, origen y fecha de la respuesta; en la anónima, solo las respuestas ya publicadas, mezcladas, y solo a partir de 3. El **Mapa de calor** y las **Rondas** tienen su propia exportación.

## Encuesta recurrente y mapa de calor

### Repetir la encuesta

Para medir el clima o el eNPS cada cierto tiempo sin volver a crear la encuesta, activa **Repetir** en **Período de la encuesta** (botón **Período**), con la encuesta en borrador:

| Campo | Qué define |
|---|---|
| **Frecuencia** | **Semanal**, **Quincenal**, **Mensual** o **Trimestral** |
| **Día de la semana** o **Día del mes** | El día de la semana en la semanal y la quincenal; el día del mes (de 1 a 28) en la mensual y la trimestral |
| **Hora** | La hora a la que se abre cada ronda, en la zona horaria de la comunidad |
| **Duración (días)** | Cuánto tiempo queda abierta cada ronda: hasta 7 días en la semanal, 14 en la quincenal, 28 en la mensual y 90 en la trimestral |
| **Invitar por correo en cada ronda** | La invitación de la categoría **Encuestas** en cada ronda (activada por defecto) |

**Guardar y activar la repetición**. La encuesta recibe la etiqueta **Recurrente** y el resumen muestra **Repetición activa**, la agenda (*"El día 1 de cada mes, 09:00 · abierta 7 días"*) y la **Próxima ronda**. No tiene **Abrir**: solo se abre por rondas.

- **Cada ronda es una copia de la encuesta** que se abre sola el día y a la hora elegidos, con el público del momento (quien tiene acceso al espacio en ese instante), envía la invitación y se cierra al final de la duración. El modo (identificada o anónima) y las reglas de publicación del resultado valen en cada ronda.
- **Cada persona responde una vez por ronda**; la respuesta de una ronda no cuenta para otra.
- **Cambiar las preguntas solo afecta a las próximas rondas.** La encuesta recurrente sigue editable; la ronda abierta sigue con las preguntas con las que se abrió.
- **Pausar repetición** deja de abrir rondas nuevas, sin cerrar la ronda abierta; **Reanudar repetición** recupera la agenda. **Terminar repetición** pide confirmación y no tiene vuelta atrás: no se abre ninguna ronda nueva, las que ya ocurrieron siguen en el resultado y la abierta sigue hasta cerrarse.
- En el espacio de **Una encuesta**, quien responde llega a la ronda abierta más reciente. Eliminar la encuesta recurrente elimina sus rondas.

### Rondas y evolución

En el resultado de una encuesta recurrente, la pestaña **Rondas** se abre primero:

- un gráfico de líneas por pregunta de NPS o de escala, con la **Evolución por ronda**;
- la tabla de las rondas, con **Apertura**, **Respuestas**, **Tasa** y el valor de cada pregunta, y **Ver resultado** para abrir el resultado de esa ronda.

El selector **Ronda**, arriba, cambia la ronda del resumen, de las respuestas y del mapa. En la anónima, la ronda con menos de 3 respuestas y la ronda aún abierta aparecen **sin número**.

### Mapa de calor

En la encuesta **identificada** (recurrente o no), la pestaña **Mapa de calor** muestra dónde la nota es mejor o peor:

- **Agrupar por**: **Grupo principal**, **Etiqueta** o **Empresa**, uno a la vez. En la etiqueta y en la empresa, quien tiene más de una cuenta en cada fila;
- una columna por pregunta de NPS y de escala, la columna **Respuestas** y la fila del total;
- cada celda con el valor, el recuento de respuestas y un color de cinco franjas, de **Peor** a **Mejor**. El mapa usa el grupo, la etiqueta y la empresa de la persona en el momento en que respondió, y cuenta solo las respuestas de miembros;
- en la recurrente, el mapa es el de la ronda elegida, con la **Variación** de cada celda frente a la ronda anterior;
- **Exportar mapa (CSV)** descarga lo que está en pantalla.

El mapa de calor agrupa con un control compacto, llama a las columnas **P1**, **P2**… con las preguntas debajo, explica la flecha de la variación (*"+3 vs. ronda anterior"*) y tiene una sola exportación. También en la encuesta identificada, un grupo con menos de 3 respuestas aparece como **Pocas respuestas**, sin número.

En la encuesta **anónima**, el mapa de calor no está disponible.

Las rondas y el mapa son del propietario y del administrador; el moderador y los miembros no los ven.

## Ejemplo: la encuesta de satisfacción de un evento

Un evento de tecnología acabó y la organización quiere escuchar a quien fue, miembro o no:

1. **Nueva encuesta › Feedback del evento**, en el espacio del evento. Título: *Encuesta de satisfacción del evento*. Introducción: *"¡Gracias por participar en la 10.ª edición! Tarda menos de 2 minutos."*
2. Las cuatro secciones ya vienen: **Contenido**, **Infraestructura**, **Experiencia** y **Perfil**. En **Contenido**, el equipo añade *"Calidad de la línea de APIs"* con **Duplicar** sobre una pregunta lista (la escala Excelente…No aplica viene incluida) y crea una opción única con opciones propias: *"La duración de las charlas fue…"* *Demasiado corta*, *Adecuada*, *Demasiado larga*.
3. **Modo: Anónima** y **Enlace público** activado (los dos vienen así en la plantilla). La encuesta vive en un espacio **Encuesta del evento**, en modo **Una encuesta**, privado para el producto de la entrada: quien la compró recibe la invitación por correo al abrirla. **Plazo:** una semana.
4. **Abrir**, copiar el enlace público y enviarlo en el grupo del evento, para quien no tiene cuenta.
5. Quien fue responde en el móvil, sin cuenta, en cuatro etapas. Con la tercera respuesta, aparece el resultado, y desde ahí cambia de 3 en 3; el filtro **Origen** separa miembros y visitantes cuando cada lado tiene al menos 3.

## Con el asistente (MCP)

El propietario y el administrador hacen con el asistente casi todo lo que hacen en el espacio: crear el espacio de Encuestas (con el modo), ver las plantillas, crear la encuesta en el espacio con secciones y preguntas, el período (`starts_at`, `closes_at`) y el tipo de respuesta (`response_mode`), editar el borrador o la programada (o moverla a otro espacio), comprobar el alcance del público, abrir o programar (`open_survey` con un `starts_at` en el futuro programa; `starts_at` nulo cancela), activar el enlace (la respuesta trae la dirección pública), leer el resultado con un filtro (con quién falta por responder, solo en la identificada), listar las respuestas individuales y exportar el CSV. **Abrir** y **programar** (porque envían la invitación por correo), **cerrar** y **eliminar** piden tu confirmación; el resto actúa en la primera llamada. La receta **Hacer una encuesta** la arma, la abre y resume el resultado contigo.

Cualquier miembro pregunta al asistente qué encuestas esperan su respuesta (`list_my_pending_surveys`), con el enlace para responder en la app y el tipo de respuesta (`response_mode`) de cada una.

La encuesta recurrente también se hace con el asistente, con `recurrence` en `create_survey` y `update_survey`, pausar, reanudar y terminar la repetición (terminar pide confirmación), las rondas, la evolución y el mapa de calor de la identificada, con el CSV. Consulta [Herramientas · Miembros](/mcp/ferramentas-membros#encuesta-recurrente-y-mapa-de-calor).

**Responder una encuesta con el asistente no existe**: el registro de lo que el asistente hace en nombre de alguien identificaría a quien respondió. Consulta [Herramientas · Miembros](/mcp/ferramentas-membros#encuestas).

`get_survey_results` trae también `activity`, las respuestas por día: en la anónima, el recuento es de las respuestas publicadas cada día, y el asistente nunca dice cuándo respondió alguien.

## Errores comunes y cómo resolverlos

| Mensaje | Por qué | Qué hacer |
|---|---|---|
| *Elige un público, activa el enlace público, o las dos cosas, antes de abrir.* | Nadie tiene acceso al espacio y el enlace público está desactivado | Cambia el acceso del espacio o activa el enlace público en **Público y enlace** |
| *Este espacio es de una sola encuesta y ya existe…* | El espacio está en modo **Una encuesta** | Crea la nueva en otro espacio, o cambia el espacio a **Varias encuestas** |
| *Este espacio tiene N encuestas y "Una encuesta" admite solo una…* | Cambio a **Una encuesta** con más de una encuesta en el espacio | Borra las demás (no se borra nada solo) o mantén **Varias encuestas** |
| *Incluye al menos una pregunta antes de abrir.* | Solo hay secciones vacías | Usa el **+** para añadir una pregunta |
| *Una vez abierta, la encuesta solo cambia el título, la descripción, el plazo y el enlace público.* | La estructura, el inicio, el modo y el tipo de respuesta se bloquean al abrir | Para cambiar preguntas, crea otra encuesta |
| *El resultado aparece con 3 respuestas.* | Encuesta anónima con menos de 3 respuestas publicadas | Espera más respuestas |
| *Esta encuesta no es para ti.* | La persona tiene sesión iniciada, no tiene acceso al espacio y el enlace público está desactivado | Dale acceso al espacio antes de abrir, o activa el enlace público |
| *Esta encuesta ya recibió el máximo de 5000 respuestas por el enlace público.* | El tope de visitantes | Ciérrala o crea otra encuesta |
| *Esta encuesta todavía no comenzó.* | La encuesta está programada, o su Inicio aún no llegó | Espera a la hora del Inicio o, en el equipo, quita el Inicio y ábrela ahora |
| *El fin tiene que ser después del inicio.* | En **Período**, el Fin va antes del Inicio | Corrige una de las fechas |
| *Esta encuesta ya está programada. Para abrirla ahora, quita la fecha de inicio.* | **Abrir** en una encuesta ya programada | **Cancelar programación** o quita el Inicio, y ábrela |

## En la API

El espacio es `module: "surveys"`, con `moduleConfig.mode` `single` o `multi` al crear y editar el espacio; `GET` y `PUT /api/surveys/spaces/{spaceId}` leen y cambian el modo (en `single`, el `GET` trae la encuesta). Las rutas del equipo están en `/api/surveys` (propietario y administrador, con el `X-CommunityId`): plantillas, lista (`?spaceId=`), crear (con `spaceId`, obligatorio), editar (en el borrador o la programada, el árbol entero de secciones y preguntas, y `spaceId` para moverla), vista previa del público (`spaceId` o `surveyId`), abrir, cerrar, eliminar, resultado con un filtro (`groupId`, `tag`, `companyId` u `origin`; en la anónima, solo `origin`, y los demás devuelven 422), respuestas individuales y CSV. El miembro lista las encuestas que puede responder en `GET /api/surveys?spaceId=`, con `alreadyResponded`. Las abiertas que aún esperan su respuesta están en `GET /api/surveys/pending` (con el `responseMode` de cada una, `notice` si debe aparecer el aviso en la app y `blocking` si hay una de respuesta inmediata), y el aviso de una se cierra en `POST /api/surveys/{id}/notice/dismiss`. Las dos rutas públicas, `/api/public/surveys/{publicToken}`, sirven la encuesta y reciben la respuesta sin iniciar sesión. Antes de enviar, la página pública pide un desafío en `/api/public/surveys/{publicToken}/challenge`, que el navegador resuelve y envía con la respuesta.

**Período y tipo de respuesta.** Crear y editar aceptan `startsAt` y `closesAt` (el fin después del inicio) y `responseMode` (`optional`, lo predeterminado, `required` o `immediate`), en el borrador y en la programada. Abrir con `startsAt` en el futuro la programa: el `status` queda `scheduled` (los estados son `draft`, `scheduled`, `open` y `closed`) y la encuesta se abre sola en `startsAt`; `startsAt: null` cancela. En el resultado, `pending` (`count`, `members`, `truncated`) solo viene en la identificada con `required` o `immediate`; en la anónima, el campo no existe.

**Respuestas por día**. `GET /api/surveys/{id}/results` trae `activity` (nulo cuando `locked`), solo recuentos, en la zona horaria de la comunidad y siguiendo el filtro: `basis`, `timeZone`, `days` (`[{ date, count }]`), `lastAt`, `lastWeek` (cuántas en los últimos 7 días) y `untracked`. En la identificada, `basis` es `response` y cuenta cada respuesta en su día. En la anónima, `basis` es `publication`: la respuesta anónima no guarda hora, así que el recuento es de los bloques publicados cada hora, en el día de la publicación; `untracked` son las respuestas publicadas antes de ese registro.

| Error | Cuándo |
|---|---|
| `403` | El rol no gestiona encuestas, o la persona con sesión iniciada no tiene acceso al espacio |
| `404` | La encuesta no existe, es de otra comunidad, o el enlace está desactivado |
| `409` | Ya respondió (el miembro, en cualquier navegador; el visitante, en el mismo navegador), segunda encuesta en un espacio **Una encuesta**, o cambio a **Una encuesta** con dos o más |
| `422` | Crear sin `spaceId` o con un espacio que no es de Encuestas, estructura no válida, encuesta en borrador o cerrada, fuera del período (`notYetOpen` antes del inicio, `closed` después del fin), fin antes del inicio (`closesBeforeStart`), abrir una ya programada (`alreadyScheduled`), cambio bloqueado después de abrir, cerrar el aviso de una de respuesta inmediata aún sin responder (`noticeRequired`), verificación contra robots caducada, recorte por debajo del mínimo |
| `429` | Límite de envíos de la red o tope de 5.000 respuestas de visitantes |
| `503` | La verificación contra robots no está disponible en este momento; inténtalo de nuevo en unos instantes |

## Relacionados

- [Módulos](/conceitos/modulos)
- [Visibilidad y acceso](/conceitos/visibilidade-e-acesso)
- [Campañas de correo](/notificacoes/campanhas-de-email)
- [Votaciones](/espacos/enquetes)
- [Grupos y organigrama](/membros/grupos-e-organograma)
- [Etiquetas](/membros/tags)
- [Roles y permisos](/conceitos/papeis-e-permissoes)
- [Herramientas · Miembros](/mcp/ferramentas-membros#encuestas)