Envíos programados de reportes

​

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.

​

Frecuencias

​

En la aplicación

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

​

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.

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 });

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})