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

# Importación de estudios externos

> Carga estudios propios en CSV y unifícalos con tus respondentes mediante mapeo de columnas

La **importación de estudios externos** permite cargar una investigación
propia (benchmark de NPS, encuesta de terceros) y unificarla con los
respondentes existentes en Woku.

El **motor de carga de datos** soporta archivos **CSV** y **Excel/XLSX**,
además de **ingesta por API** en modo **batch** (lotes) y **por eventos**
(en tiempo real), de modo que puedes cargar tanto archivos puntuales como
flujos continuos de datos.

## Formatos y métodos de ingesta

El motor de carga de datos acepta:

* **CSV**: archivos de valores separados por comas. Ideal para
  exportaciones de otras herramientas y planillas.
* **Excel/XLSX**: libros de cálculo de Excel. Se selecciona la hoja y se
  mapean sus columnas como en CSV.
* **API batch**: carga de lotes de registros mediante la API, útil para
  sincronizaciones periódicas o migraciones masivas.
* **API por eventos**: ingesta continua en tiempo real, donde cada evento
  (por ejemplo, una nueva respuesta o transacción) se envía y se procesa a
  medida que ocurre.

En todos los casos los datos pasan por el mismo mapeo de columnas/campos y
las mismas estrategias de unión descritas abajo, de modo que el resultado
es consistente sin importar el método usado.

## Flujo

1. **Subir**: indica el nombre del estudio y selecciona el archivo (CSV o
   Excel/XLSX), o bien envía los registros por API.
   El contenido se guarda en almacenamiento y se crea una importación en
   estado *pendiente*.
2. **Mapear columnas**: se muestra una vista previa con las primeras
   filas. Asigna cada columna del archivo a un campo destino de Woku
   (email, teléfono, whatsappId, nombre, score, comentario), elige la
   **columna identificadora**, el **campo identificador** y la
   **estrategia de unión**.
3. **Procesar**: la importación se encola y se procesa en segundo plano
   sin bloquear la interfaz. El progreso (`importadas / total`) se
   actualiza en vivo.

## Estrategias de unión

* **Actualizar**: si el identificador coincide con un respondente
  existente, la fila se vincula a ese cliente.
* **Omitir existentes**: si ya existe, no se importa la fila.
* **Crear siempre**: se importa la fila exista o no coincidencia.

## Límites y formato

* Formatos de archivo soportados: **CSV** y **Excel/XLSX**, además de la
  **ingesta por API** (batch y por eventos).
* El identificador se resuelve contra los campos de contacto del cliente
  (email, teléfono, whatsappId). El matching por campo personalizado y
  por campos cifrados es una mejora posterior.
* Las filas con errores (por ejemplo, sin columna identificadora) se
  cuentan aparte y quedan en el registro de errores de la importación.