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

# Constructor de reportes

> Arma reportes ad hoc sobre tus datos de voz del cliente, con vista previa en vivo y sin escribir código

El **constructor de reportes** permite armar un reporte sin código: se
elige una fuente de datos, se define cómo agrupar, qué medir y qué
filtrar, y una **vista previa en vivo** muestra el resultado mientras se
construye. El servidor traduce la definición a una consulta que se
ejecuta del lado del servidor.

## Fuentes de datos

El constructor trabaja sobre seis fuentes de voz del cliente:

* **Wokus**: una fila por opinión (calificación, texto o audio).
* **NPS**: respuestas de encuestas NPS.
* **CSAT**: respuestas de satisfacción.
* **CES**: respuestas de esfuerzo del cliente.
* **Formularios**: respuestas de formularios.
* **Clientes**: clientes registrados de la empresa.

## Campos disponibles

Cada fuente expone un catálogo de campos curado, por lo que los
selectores solo ofrecen campos válidos:

| Fuente      | Campos                                                                                                 |
| ----------- | ------------------------------------------------------------------------------------------------------ |
| Wokus       | Fecha de creación, Calificación (numérico), Tipo de feedback, Tipo de opinión, Canal, Comentario, Woku |
| NPS         | Fecha de creación, Nota (numérico), Tipo de feedback, Anónimo                                          |
| CSAT        | Fecha de creación, Nota (numérico), Tipo de comentario                                                 |
| CES         | Fecha de creación, Nota (numérico), Tipo de comentario                                                 |
| Formularios | Fecha de creación, Estado, Anónimo                                                                     |
| Clientes    | Fecha de creación, Opt-out de seguimiento                                                              |

Algunos campos son categóricos con valores fijos:

* **Tipo de feedback**: reconocimiento o mejora.
* **Tipo de opinión** (wokus): estrella, texto o audio.
* **Canal** (wokus): WhatsApp, email, app de reseña, widget web, SDK
  móvil o API.
* **Tipo de comentario** (CSAT y CES): texto o audio.

## Armar el reporte

1. Define el **nombre** y la **fuente de datos**.
2. En **Agrupar por** agrega las dimensiones del reporte. Los campos de
   fecha exigen elegir un **periodo**: día, semana o mes.
3. En **Medir** agrega al menos una medida: **conteo** de registros
   (opiniones, respuestas o clientes según la fuente) o **suma**,
   **promedio**, **mínimo** o **máximo** sobre un campo numérico, por
   ejemplo el promedio de la nota.
4. En **Filtrar** acota los datos. Los operadores dependen del tipo de
   campo: los numéricos y de fecha aceptan comparaciones (igual,
   distinto, mayor, menor), los booleanos solo igual o distinto, y
   **contiene** está disponible únicamente en el campo Comentario. Los
   campos categóricos ofrecen un selector con sus valores válidos en
   lugar de texto libre.

Los nombres de columna (alias) se completan solos a partir del campo y
el cálculo, y se pueden editar. Aceptan letras, números, espacios,
guion y guion bajo.

## Vista previa en vivo

La vista previa se recalcula sola mientras se edita la definición, con
una pequeña espera para no consultar en cada tecla. Muestra las
primeras 10 filas del resultado y no guarda nada: sirve para validar la
configuración antes de guardar.

## Guardar y ejecutar

Para guardar, el reporte necesita un nombre (al menos 2 caracteres y no
solo números) y al menos una medida válida. El resultado se muestra
como tabla. Desde el detalle del reporte se puede exportar a CSV, Excel
o PDF, y configurar la [entrega programada](/docs/reports/exports) por
correo o SFTP.

<Tip>
  Las [plantillas predefinidas](/docs/reports/predefined-templates) abren
  el constructor con una definición ya armada, útil como punto de partida
  para ajustar en lugar de empezar de cero.
</Tip>

## Cómo se construye la consulta

La consulta se ejecuta del lado del servidor con aislamiento por
empresa: cada reporte consulta solo los datos de tu empresa, con los
filtros saneados, agrupa por las dimensiones elegidas y calcula las
medidas. Los cortes de fecha usan la zona horaria de la empresa, o
America/Santiago por defecto.