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

# Exportaciones programadas

> Entrega automática de datos a SFTP, S3, webhook o correo según un cron configurable

<Info>
  **Disponible en el plan Corporate.** Esta funcionalidad forma parte de las capacidades empresariales de woku. [Conversa con nuestro equipo comercial](https://woku.app/pricing).
</Info>

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.

<Note>
  La entrega por **correo automático** y por **SFTP** está operativa para
  exportaciones recurrentes; **S3** y **webhook** quedan disponibles como
  destinos adicionales.
</Note>
