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

# Envíos programados de reportes

> Envía por correo el reporte PDF de una carpeta o de una herramienta cada mes, cada quincena, cada semana o una sola vez, a personas dentro y fuera de woku

Un **envío programado** manda por correo el reporte PDF de una **carpeta** (todas las herramientas de la carpeta y sus subcarpetas) o de **una herramienta** (woku, NPS, CSAT o CES) a una lista de destinatarios. Los destinatarios no necesitan cuenta en woku: sirve para directorios, jefaturas o clientes que quieren el informe en su bandeja sin entrar a la plataforma.

## Qué lleva el correo

* El **PDF del reporte** del período: primero una página de métricas (respuestas, promedio, reconocimientos y oportunidades de mejora, sentimiento, distribución de puntajes y nube de palabras) y después el análisis de comentarios con IA.
* En los envíos de una carpeta, el **CSV** de las respuestas del período, si lo activas.
* Un enlace para **darse de baja en un clic**. Quien se da de baja deja de recibir los reportes de esa empresa; el resto de los correos de woku no cambia.

El correo sale a nombre de tu empresa, en español o en inglés.

## Frecuencias

| Frecuencia | Cuándo sale | Qué período cubre |
| - | - | - |
| Mensual | El día 1, a las 12:00 UTC | El mes anterior completo |
| Quincenal | Los días 1 y 16, a las 12:00 UTC | Del 16 a fin de mes, o del 1 al 15 |
| Semanal | Los lunes, a las 12:00 UTC | La semana anterior, de lunes a domingo |
| Una sola vez | Ahora o en la fecha que elijas | El período que elijas (desde y hasta) |

Cada período se envía una sola vez, aunque haya varias instancias del servidor. Si un envío falla, queda registrado y no se reintenta solo; puedes mandarlo de nuevo con **Enviar ahora**.

## En la aplicación

En el reporte de una carpeta de **Herramientas**, o en el reporte de un woku, NPS, CSAT o CES, el botón **Programar envío** abre un diálogo con:

* La **lista de envíos** de ese reporte, cada uno con su próximo envío o su estado, y las acciones **Enviar ahora**, **Pausar** o **Reanudar**, **Editar** y **Eliminar**.
* El **formulario** para agregar uno: frecuencia (con la fecha del próximo envío), destinatarios (hasta 10 correos, separados por coma o en líneas distintas) y, en una carpeta, si adjunta el CSV. Para un envío **único** eliges el período y si sale **ahora** o **en una fecha**.

Todos los envíos de la empresa están en **Configuración de empresa > Reportes programados**, en una tabla con el reporte, la frecuencia, los destinatarios y el estado, con las mismas acciones.

Un envío único no se edita: se borra y se crea de nuevo.

## API, SDK y MCP

* `GET /v1/report-subscriptions` lista los envíos (opcionalmente de una carpeta o herramienta, con `scopeType` y `scopeId`).
* `POST /v1/report-subscriptions` crea uno: `scopeType` (`folder`, `woku`, `nps`, `csat` o `ces`), `scopeId`, `frequency` (`monthly`, `biweekly`, `weekly` u `once`), `recipients`, y opcionalmente `includeCsv` y `locale`. Un envío `once` lleva `periodFrom` y `periodTo` (ISO, `periodTo` exclusivo) y `sendAt`; sin `sendAt` sale en los minutos siguientes.
* `PATCH /v1/report-subscriptions/:id` edita un envío recurrente o lo pausa (`active: false`) y lo reanuda.
* `DELETE /v1/report-subscriptions/:id` lo elimina.
* `POST /v1/report-subscriptions/:id/send` lo envía ahora: el último período completo de uno recurrente, o el período propio de uno único.

```ts JavaScript theme={null}
const monthly = await woku.reportSubscriptions.create({
  scopeType: 'folder',
  scopeId: folderId,
  frequency: 'monthly',
  recipients: ['directorio@empresa.com'],
  includeCsv: true,
});
await woku.reportSubscriptions.update(monthly.id, { active: false });
```

```python Python theme={null}
monthly = woku.report_subscriptions.create(
    {
        "scopeType": "folder",
        "scopeId": folder_id,
        "frequency": "monthly",
        "recipients": ["directorio@empresa.com"],
        "includeCsv": True,
    }
)
woku.report_subscriptions.update(monthly["id"], {"active": False})
```

En el servidor MCP están `list_scheduled_reports`, `schedule_report`, `update_scheduled_report`, `delete_scheduled_report` y `send_scheduled_report_now`. Consulta [Herramientas del MCP](/docs/mcp/tools).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.