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.

Disponible en el plan Corporate. Esta funcionalidad forma parte de las capacidades empresariales de woku. Conversa con nuestro equipo comercial.
Una exportación programada ejecuta un reporte de forma periódica y entrega el resultado a un destino, sin intervención manual. Puedes exportar cualquier campo, datos de usuarios, campos ingestados, capturados o de sistema, y entregarlo automáticamente a correo electrónico y a SFTP según una agenda configurable.

Configuración

  • Nombre y cron (por ejemplo 0 6 * * 1 = lunes a las 6am).
  • Formato: CSV, XLSX o JSON.
  • Reporte (opcional): el id de una definición de reporte del constructor. Si no se indica, la exportación de una colección directa es una mejora posterior.
  • Destino y sus campos:
    • SFTP: host, puerto, usuario, contraseña y ruta remota. La contraseña se cifra en reposo con el servicio de cifrado de la plataforma antes de guardarse.
    • S3: bucket, región y prefijo.
    • Webhook: URL (recibe el archivo en base64).
    • Correo: destinatarios.

Campos exportables

Una exportación puede incluir cualquier campo disponible para la empresa, sin restricciones por origen:
  • Campos de usuarios: atributos de los miembros y respondentes.
  • Campos ingestados: datos cargados vía importación o API.
  • Campos capturados: respuestas de encuestas y formularios.
  • Campos de sistema: marcas de tiempo, identificadores, estados y metadatos generados por la plataforma.
Seleccionas las columnas que quieres incluir al definir el reporte que alimenta la exportación.

Destinos

Cada exportación programada entrega su resultado de forma automática a uno de estos destinos:
  • Correo automático: la plataforma envía el archivo a los destinatarios configurados en cada corrida, sin intervención manual.
  • SFTP: la plataforma deposita el archivo en el servidor remoto (host, puerto, usuario, ruta). Las credenciales se cifran en reposo con el servicio de cifrado de la plataforma.
  • S3 y Webhook: destinos adicionales para integraciones con almacenamiento en la nube y sistemas externos.
Los destinos de correo automático y SFTP están operativos y son los recomendados para distribución recurrente de datos y para integraciones con sistemas internos.

Ejecución

  • El agendador usa trabajos repetibles en Redis (BullMQ), de modo que cada ocurrencia se ejecuta una sola vez aunque haya varias instancias del servidor.
  • Al deshabilitar o eliminar una exportación se quita el trabajo repetible, evitando crons huérfanos.
  • El botón Ejecutar ahora encola una corrida inmediata.
  • Cada corrida registra fecha, estado (éxito o fallo) y, en caso de error, el detalle. Los fallos se reintentan con backoff exponencial.

Zona horaria

El cron respeta la zona horaria configurada (por defecto America/Santiago), relevante para operaciones en CL, CO, MX, PE y AR.
La entrega por correo automático y por SFTP está operativa para exportaciones recurrentes; S3 y webhook quedan disponibles como destinos adicionales.