Skip to main content

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.

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.