# woku

## Docs

- [Bienvenido a woku](https://woku.app/docs/index.md): Documentación completa de woku, la plataforma para capturar la opinión de tus clientes
- [Primera medición](https://woku.app/docs/getting-started/first-measurement.md): Crea y comparte tu primera medición con cada herramienta: woku, CSAT, CES, NPS, Flow y Forms
- [Instalación](https://woku.app/docs/getting-started/installation.md): Instala woku como aplicación web progresiva en tu computadora o celular
- [Problema](https://woku.app/docs/fundamentals/problem.md): Por qué las encuestas tradicionales ya no funcionan
- [Solución](https://woku.app/docs/fundamentals/solution.md): Cómo woku resuelve el problema: escucha breve, contextual y a lo largo del journey
- [Herramientas](https://woku.app/docs/fundamentals/tools.md): Las herramientas de woku para medir la experiencia: woku, NPS, CSAT, CES, Flow y Forms
- [Plataforma 100% autoservicio (DIY)](https://woku.app/docs/fundamentals/self-service-platform.md): Toda la administración de la plataforma se realiza por el propio equipo desde la interfaz, sin tickets ni dependencia del proveedor
- [woku](https://woku.app/docs/core-concepts/woku.md): Aprende sobre las características de un woku: imagen, nombre y compartir
- [CSAT](https://woku.app/docs/core-concepts/csat.md): Aprende a configurar herramientas CSAT: nombre, experiencia o producto a evaluar, escala 1 a 5 y comentario opcional
- [CES](https://woku.app/docs/core-concepts/ces.md): Aprende a configurar herramientas CES: acción a evaluar, escala 1 a 5 y comentario opcional
- [NPS](https://woku.app/docs/core-concepts/nps.md): Aprende a configurar herramientas NPS: mensaje, audiencia y formas de compartir
- [Flow](https://woku.app/docs/core-concepts/flow.md): Aprende a armar y compartir un Flow, la secuencia de wokus y NPS
- [Forms](https://woku.app/docs/core-concepts/forms.md): Aprende a configurar un Form: campos, ajustes y verificación de respuestas
- [Clientes](https://woku.app/docs/core-concepts/clients.md): El perfil unificado de cada persona: contacto, atributos e historial de respuestas
- [Guía de Integración API](https://woku.app/docs/development/api.md): Documentación completa de la API v1 de woku: wokus, NPS, CSAT, CES, formularios, flows, invitaciones, capturas del SDK móvil, trackers externos, destinos de tickets y planes de acción
- [Versionado y política de deprecación](https://woku.app/docs/development/versioning.md): Cómo woku versiona su API pública y cómo comunica cambios y deprecaciones, para que tus integraciones y agentes de IA se mantengan estables.
- [SDK de React Native](https://woku.app/docs/development/sdk-react-native.md): Captura calificaciones woku y NPS (texto y audio) desde tu app React Native, con buffer offline y entrega consciente de cuarentenas
- [Transformaciones de datos con código](https://woku.app/docs/development/transformations.md): Transforma y deriva campos con JavaScript dentro de Flujo de datos, con código generado por un agente que puedes revisar, editar y simular antes de ejecutar
- [Entorno sandbox](https://woku.app/docs/development/sandbox.md): Un entorno aislado que replica tu configuración de producción para probar funcionalidades, ingesta, transformaciones y alertas antes de publicarlas
- [Widget web JavaScript](https://woku.app/docs/integrations/widget-js.md): Instala el widget de captura de woku en cualquier sitio web con un loader <script> ligero y un iframe alojado en el CDN de woku
- [Webhooks](https://woku.app/docs/integrations/webhooks.md): Recibe eventos de woku en tu sistema en tiempo real, con firma HMAC para verificar la autenticidad y reintentos automáticos
- [Conector Shopify](https://woku.app/docs/integrations/shopify.md): Conecta tu tienda Shopify con woku y evalúa automáticamente la experiencia de compra y los productos de cada pedido pagado, sin escribir código
- [Conector Zendesk](https://woku.app/docs/integrations/zendesk.md): Conecta tu cuenta de Zendesk con woku mediante un API token y envía tickets a tu equipo de soporte cuando una opinión lo amerita
- [Seguridad](https://woku.app/docs/security/index.md): Controles de seguridad y autenticación implementados en Woku
- [Autenticación](https://woku.app/docs/security/authentication.md): Flujo de inicio de sesión, sesiones persistentes, idle timeout y refresh tokens
- [Autenticación en dos pasos (MFA)](https://woku.app/docs/security/mfa.md): Cómo activar TOTP en tu cuenta, gestionar códigos de respaldo y desactivar el segundo factor
- [Sesiones activas](https://woku.app/docs/security/sessions.md): Ver y revocar las sesiones de tu cuenta
- [Registro de auditoría](https://woku.app/docs/security/audit-log.md): Quién hizo qué en tu empresa, cuándo y desde dónde. Filtros, paginación y export CSV.
- [Protección contra fuerza bruta](https://woku.app/docs/security/anti-brute-force.md): Bloqueo automático tras intentos fallidos, notificación al usuario y desbloqueo administrativo
- [Headers de seguridad y CSP](https://woku.app/docs/security/headers-and-csp.md): HSTS, CSP nonce-based, X-Frame-Options, Permissions-Policy y demás headers aplicados por defecto
- [Allowlist de IPs por empresa](https://woku.app/docs/security/ip-allowlist.md): Restringir el acceso autenticado a Woku a una lista de bloques CIDR confiables
- [SSO (Single Sign-On)](https://woku.app/docs/security/sso.md): Inicio de sesión empresarial vía SAML 2.0 u OpenID Connect, intermediado por Stytch B2B
- [Gestión de secrets](https://woku.app/docs/security/secrets-management.md): Cómo Woku almacena y entrega secrets a los servicios en producción, y qué se espera del entorno local
- [Cifrado en reposo y firmas de integridad](https://woku.app/docs/security/encryption-and-signatures.md): Cómo Woku protege datos sensibles almacenados y cómo asegura que documentos críticos no se modifiquen sin detectarlo
- [Cuarentenas](https://woku.app/docs/configuration/quarantines.md): Reglas anti-duplicado que limitan cuántas veces un respondente puede enviar el mismo formulario dentro de una ventana de tiempo
- [Alertas](https://woku.app/docs/configuration/alert-rules.md): Avisos automáticos por email cuando una condición de metas o de volumen de respuestas necesita atención
- [Fuentes de datos](https://woku.app/docs/data/data-sources.md): Conecta archivos o APIs externas como origen de datos de tu empresa, con esquema tipado y listo para usar en flujos de datos
- [Flujo de datos](https://woku.app/docs/data/data-flow.md): Convierte los registros de una fuente de datos en acciones de voz del cliente: un agente de IA construye el flujo, lo pruebas con una simulación y lo ejecutas cuando estés listo
- [Grupos y creación de planes](https://woku.app/docs/action-plans/create-plan.md): Cómo configurar grupos de encargados y cómo woku genera borradores de planes de acción a partir del feedback
- [Revisar y aprobar planes](https://woku.app/docs/action-plans/kanban.md): Cómo revisar los planes de acción de un grupo, ajustarlos con el agente de IA, aprobarlos y cerrar su ciclo
- [Avisos y evidencia del plan](https://woku.app/docs/action-plans/link-alerts.md): Cómo woku avisa al grupo cuando genera un plan y cómo cada plan conserva la evidencia que lo originó
- [Alertas de volumen](https://woku.app/docs/alerts/volume-drop.md): Avisos por email cuando el volumen de respuestas de una herramienta cae o se dispara de forma anómala respecto de su historial
- [Estudio de datos (agente de IA)](https://woku.app/docs/reports/data-studio.md): Describe lo que necesitas en lenguaje natural y un agente de IA construye un informe de insights con números verificados, versionado y publicable
- [Análisis de texto con IA](https://woku.app/docs/reports/text-analysis.md): Clasificación automática de comentarios, sentimiento, palabras clave y descubrimiento de temas emergentes con IA en las respuestas abiertas
- [Espacio de reseñas](https://woku.app/docs/reports/reviews-space.md): Explora tus reseñas en un universo 3D donde la cercanía significa similitud: los comentarios que hablan de lo mismo se agrupan en temas
- [Constructor de reportes](https://woku.app/docs/reports/visual-builder.md): Arma reportes ad hoc sobre tus datos de voz del cliente, con vista previa en vivo y sin escribir código
- [Plantillas predefinidas](https://woku.app/docs/reports/predefined-templates.md): Doce reportes predefinidos listos para usar como punto de partida
- [Exportar y agendar reportes](https://woku.app/docs/reports/exports.md): Formatos de exportación soportados y entrega programada de reportes por correo o SFTP
- [Metas](https://woku.app/docs/guides/goals.md): Define objetivos medibles por herramienta e indicador y sigue su cumplimiento en vivo
- [Tickets a SAC](https://woku.app/docs/guides/support-tickets.md): woku evalúa cada opinión negativa y, cuando amerita atención, crea un ticket de soporte con IA y lo envía a tu plataforma de atención al cliente
- [Importación de estudios externos](https://woku.app/docs/guides/study-import.md): Carga una investigación propia o de terceros como fuente de datos y unifícala con tus clientes mediante un flujo de datos
- [Encuestas multi-idioma](https://woku.app/docs/guides/multilanguage-surveys.md): Una sola encuesta con múltiples idiomas y selección automática según la preferencia del usuario o del navegador
- [Exportaciones programadas](https://woku.app/docs/guides/export-schedules.md): Entrega automática de reportes del constructor por correo o SFTP, con frecuencia diaria, semanal o mensual
- [Inactivación automática de usuarios](https://woku.app/docs/guides/user-deactivation.md): Inactivación de cuentas sin actividad con aviso previo y reactivación por administradores
- [Listar los wokus de la empresa que hace la llamada](https://woku.app/docs/api-reference/wokus/listar-los-wokus-de-la-empresa-que-hace-la-llamada.md)
- [Crear un Woku con una URL de archivo](https://woku.app/docs/api-reference/wokus/crear-un-woku-con-una-url-de-archivo.md): Crea un Woku para recoleccion de feedback usando la URL de un archivo remoto. El archivo se descarga y procesa de forma asincrona.
- [Crear un Woku con una subida de archivo (multipart)](https://woku.app/docs/api-reference/wokus/crear-un-woku-con-una-subida-de-archivo-multipart.md): Crea un Woku y sube su recurso en una unica solicitud multipart.
- [Obtener los datos de reseñas de un Woku](https://woku.app/docs/api-reference/wokus/obtener-los-datos-de-reseñas-de-un-woku.md): Devuelve el payload de reseñas del Woku indicado: informacion de la empresa, detalles del woku y cualquier reseña existente.
- [Crear una reseña de texto para un Woku](https://woku.app/docs/api-reference/wokus/crear-una-reseña-de-texto-para-un-woku.md): Envia una reseña de texto (calificacion con estrellas + feedback de texto) para un Woku.
- [Crear una reseña de voz para un Woku (multipart)](https://woku.app/docs/api-reference/wokus/crear-una-reseña-de-voz-para-un-woku-multipart.md): Envia una reseña de voz para un Woku. El archivo de audio se sube como `file` en una solicitud multipart junto con la calificacion.
- [Compartir el enlace de reseña de un Woku por correo](https://woku.app/docs/api-reference/wokus/compartir-el-enlace-de-reseña-de-un-woku-por-correo.md): Envia el enlace de reseña del Woku a una o mas direcciones de correo invitando a los destinatarios a dejar feedback.
- [Obtiene un woku con estadisticas de reseñas agregadas](https://woku.app/docs/api-reference/wokus/obtiene-un-woku-con-estadisticas-de-reseñas-agregadas.md)
- [Lista las reseñas de un woku (texto y voz)](https://woku.app/docs/api-reference/wokus/lista-las-reseñas-de-un-woku-texto-y-voz.md): Paginado, mas recientes primero. Las reseñas de voz exponen la transcripcion. Requiere la clave secreta.
- [Obtener la empresa que hace la llamada](https://woku.app/docs/api-reference/empresas/obtener-la-empresa-que-hace-la-llamada.md): Devuelve la informacion de la empresa, las carpetas y los wokus de la empresa resuelta a partir de la clave Bearer.
- [Obtener el reporte NPS de toda la empresa](https://woku.app/docs/api-reference/reportes/obtener-el-reporte-nps-de-toda-la-empresa.md): Devuelve el reporte NPS agregado de la empresa resuelta a partir de la clave Bearer.
- [Obtiene el reporte de NPS de una herramienta NPS especifica](https://woku.app/docs/api-reference/reportes/obtiene-el-reporte-de-nps-de-una-herramienta-nps-especifica.md): Devuelve el reporte de NPS de la herramienta indicada. Falla con 400 si la herramienta no pertenece a la empresa que hace la llamada.
- [Lista las definiciones de tracker activas de la empresa que hace la llamada](https://woku.app/docs/api-reference/trackers-externos/lista-las-definiciones-de-tracker-activas-de-la-empresa-que-hace-la-llamada.md): Devuelve el catalogo paginado de definiciones de tracker **activas** que pertenecen a la empresa resuelta a partir del token Bearer. Los trackers inactivos (eliminados de forma logica) no se devuelven aqui.
- [Lista los valores de tracker asignados a un Woku](https://woku.app/docs/api-reference/trackers-externos/lista-los-valores-de-tracker-asignados-a-un-woku.md): Devuelve todos los valores de tracker vinculados actualmente al Woku indicado, acotados a la empresa que hace la llamada.
- [Asigna un valor de tracker a un Woku por nombre de tracker (upsert)](https://woku.app/docs/api-reference/trackers-externos/asigna-un-valor-de-tracker-a-un-woku-por-nombre-de-tracker-upsert.md): Idempotente. Si `(wokuId, trackerName)` ya tiene un valor, se **sobrescribe**. El servidor resuelve el tracker por nombre dentro de la empresa que hace la llamada.
- [Elimina un valor de tracker de un Woku](https://woku.app/docs/api-reference/trackers-externos/elimina-un-valor-de-tracker-de-un-woku.md): Busca el tracker por nombre (activo o inactivo) y elimina su valor del Woku. Devuelve el documento eliminado. **No es idempotente**: devuelve 404 si no existia ningun valor.
- [Busca Wokus por (nombre de tracker, valor)](https://woku.app/docs/api-reference/trackers-externos/busca-wokus-por-nombre-de-tracker-valor.md): Devuelve entradas `WokuExternalTrackerValue` paginadas cuyo nombre de tracker + valor coinciden dentro de la empresa que hace la llamada. Usa `.wokuId` de cada resultado para obtener el Woku completo a traves de los endpoints v0.
- [Lista los valores de tracker asignados a una entidad de VoC](https://woku.app/docs/api-reference/trackers-externos/lista-los-valores-de-tracker-asignados-a-una-entidad-de-voc.md): Devuelve todos los valores de tracker actualmente vinculados a la entidad de VoC dada (herramienta NPS/CSAT/CES, Form o Flow), acotados a la empresa del solicitante.
- [Asigna un valor de tracker a una entidad de VoC por nombre de tracker (upsert)](https://woku.app/docs/api-reference/trackers-externos/asigna-un-valor-de-tracker-a-una-entidad-de-voc-por-nombre-de-tracker-upsert.md): Idempotente. Si `(entityType, id, trackerName)` ya tiene un valor, se **sobrescribe**. El servidor resuelve el tracker por nombre dentro de la empresa del solicitante.
- [Elimina un valor de tracker de una entidad de VoC](https://woku.app/docs/api-reference/trackers-externos/elimina-un-valor-de-tracker-de-una-entidad-de-voc.md): Busca el tracker por nombre (activo o inactivo) y elimina su valor de la entidad de VoC. Devuelve el documento eliminado. **No es idempotente**: devuelve 404 si no existia ningun valor.
- [Obtiene la definicion de una herramienta NPS](https://woku.app/docs/api-reference/nps/obtiene-la-definicion-de-una-herramienta-nps.md): Devuelve la definicion de una herramienta NPS, su nombre interno y el mensaje y la audiencia usados para construir la pregunta de la encuesta ("En una escala de 0 a 10, que tan probable es que recomiendes {npsMessage} a {audienceType}?"). Falla con 403 si la herramienta no pertenece a la empresa que…
- [Lista las respuestas NPS de la empresa que hace la llamada](https://woku.app/docs/api-reference/nps/lista-las-respuestas-nps-de-la-empresa-que-hace-la-llamada.md): Paginado, las mas recientes primero. Filtra por herramienta, rango de fechas y si la respuesta lleva feedback. Requiere la clave secreta.
- [Captura una puntuacion NPS](https://woku.app/docs/api-reference/nps/captura-una-puntuacion-nps.md): Envia una puntuacion NPS (0 a 10) para la empresa que hace la llamada. Proporciona `npsToolId` para adjuntar la puntuacion a una herramienta NPS especifica; omitelo para una puntuacion a nivel de empresa. Opcionalmente incluye el correo del encuestado, o marca el envio como anonimo. La categoria de…
- [Agrega una resena de texto a una puntuacion NPS](https://woku.app/docs/api-reference/nps/agrega-una-resena-de-texto-a-una-puntuacion-nps.md): Adjunta una resena de texto opcional a una puntuacion NPS existente. Falla con 403 si el NPS no pertenece a la empresa que hace la llamada.
- [Agregar una reseña de voz a un puntaje NPS](https://woku.app/docs/api-reference/nps/agregar-una-reseña-de-voz-a-un-puntaje-nps.md): Adjunta una reseña de voz opcional (audio) a un puntaje NPS existente. El audio se sube y se transcribe del lado del servidor. Falla con 403 si el NPS no pertenece a la empresa que hace la llamada.
- [Lista las herramientas NPS de la empresa solicitante](https://woku.app/docs/api-reference/nps/lista-las-herramientas-nps-de-la-empresa-solicitante.md): Forma plural canonica; `GET /v1/nps-tool/{id}` sigue siendo la obtencion de una sola herramienta. Requiere la clave secreta.
- [Obtiene una sola respuesta NPS](https://woku.app/docs/api-reference/nps/obtiene-una-sola-respuesta-nps.md)
- [Verificar si una persona encuestada esta actualmente en cuarentena](https://woku.app/docs/api-reference/cuarentenas/verificar-si-una-persona-encuestada-esta-actualmente-en-cuarentena.md): Verificacion de solo lectura (dry-run): indica si una persona encuestada, identificada por correo o telefono, esta actualmente en cuarentena para la empresa que hace la llamada, para que un cliente pueda decidir si solicitar feedback. No registra nada.
- [Enviar la encuesta NPS por correo o WhatsApp](https://woku.app/docs/api-reference/invitaciones/enviar-la-encuesta-nps-por-correo-o-whatsapp.md): Envia la encuesta NPS (a nivel de empresa, o especifica de una herramienta mediante `npsToolId`) a una lista de destinatarios. La respuesta reporta la aceptacion por destinatario: las personas encuestadas en cuarentena y los destinatarios bloqueados por creditos de WhatsApp o por politica de notific…
- [Enviar un formulario por correo o WhatsApp](https://woku.app/docs/api-reference/invitaciones/enviar-un-formulario-por-correo-o-whatsapp.md): Envia la invitacion del formulario a una lista de destinatarios. El formulario debe pertenecer a la empresa que hace la llamada y estar abierto y activo. Misma semantica por destinatario que el endpoint de invitaciones de NPS.
- [Enviar una invitacion a reseña de woku por correo o WhatsApp](https://woku.app/docs/api-reference/invitaciones/enviar-una-invitacion-a-reseña-de-woku-por-correo-o-whatsapp.md): Envia la invitacion a reseña de woku a una lista de destinatarios. El woku debe pertenecer a la empresa que hace la llamada, estar abierto y aceptar reseñas. Para el canal de correo esto equivale a `POST /v1/wokus/{wokuId}/share`. Misma semantica por destinatario que el endpoint de invitaciones de N…
- [Envia la encuesta CSAT por correo o WhatsApp](https://woku.app/docs/api-reference/invitaciones/envia-la-encuesta-csat-por-correo-o-whatsapp.md): Despacha la encuesta CSAT del `csatToolId` dado a una lista de destinatarios. La respuesta informa la aceptacion por destinatario: los encuestados en cuarentena y los destinatarios bloqueados por creditos de WhatsApp o por politica de notificaciones se listan en `rejected` en lugar de hacer fallar l…
- [Envia la encuesta CES por correo o WhatsApp](https://woku.app/docs/api-reference/invitaciones/envia-la-encuesta-ces-por-correo-o-whatsapp.md): Despacha la encuesta CES del `cesToolId` dado a una lista de destinatarios. La respuesta informa la aceptacion por destinatario: los encuestados en cuarentena y los destinatarios bloqueados por creditos de WhatsApp o por politica de notificaciones se listan en `rejected` en lugar de hacer fallar la…
- [Obtener la definicion de un formulario (para renderizar el formulario)](https://woku.app/docs/api-reference/forms/obtener-la-definicion-de-un-formulario-para-renderizar-el-formulario.md): Devuelve el formulario activo (campos, configuracion, contenido localizado) mas la marca de la empresa, listo para renderizar en tu propia UI. Acepta la clave de captura publicable o la clave secreta.
- [Listar las respuestas de un formulario](https://woku.app/docs/api-reference/forms/listar-las-respuestas-de-un-formulario.md): Paginado, mas recientes primero. Las respuestas exponen las respuestas indexadas por id de campo; los datos de contacto del cliente nunca se incluyen. Requiere la clave secreta.
- [Enviar una respuesta de formulario](https://woku.app/docs/api-reference/forms/enviar-una-respuesta-de-formulario.md): Registra una respuesta para el formulario. Las respuestas se validan contra la definicion del formulario antes de almacenarse; las personas encuestadas en cuarentena se rechazan con 429. Acepta la clave de captura publicable o la clave secreta.
- [Lista los Forms de la empresa solicitante](https://woku.app/docs/api-reference/forms/lista-los-forms-de-la-empresa-solicitante.md)
- [Obtener los datos de un flow](https://woku.app/docs/api-reference/flows/obtener-los-datos-de-un-flow.md): Devuelve el recorrido del flow: wokus en orden de presentacion, la marca de la empresa y el NPS vinculado (especifico de una herramienta o a nivel de empresa). Usa los endpoints de captura existentes para registrar feedback en cada paso. Acepta la clave de captura publicable o la clave secreta.
- [Lista los Flows de la empresa solicitante](https://woku.app/docs/api-reference/flows/lista-los-flows-de-la-empresa-solicitante.md)
- [Captura una reseña de woku o una respuesta NPS (SDK movil)](https://woku.app/docs/api-reference/capturas/captura-una-reseña-de-woku-o-una-respuesta-nps-sdk-movil.md): Endpoint de ingesta para el SDK movil de Woku. Enruta segun `kind`: `woku` crea una reseña de woku, `nps` una respuesta NPS. La empresa se resuelve a partir de la clave de API y el canal de respuesta se sella del lado del servidor a `mobile-sdk`. Envia `application/json` para capturas de texto/calif…
- [Obtiene la definicion de una herramienta CSAT](https://woku.app/docs/api-reference/csat/obtiene-la-definicion-de-una-herramienta-csat.md): Devuelve la definicion de una herramienta CSAT, incluido su nombre interno, la pregunta de encuesta mostrada a los encuestados y un asunto opcional, ademas de los locales disponibles y el locale predeterminado. Las herramientas CSAT siempre son personalizadas (especificas de la herramienta). Falla c…
- [Lista las herramientas CSAT de la empresa solicitante](https://woku.app/docs/api-reference/csat/lista-las-herramientas-csat-de-la-empresa-solicitante.md): Lista paginada de las herramientas CSAT de la empresa. Requiere la clave secreta.
- [Lista las respuestas CSAT de la empresa solicitante](https://woku.app/docs/api-reference/csat/lista-las-respuestas-csat-de-la-empresa-solicitante.md): Paginado, mas recientes primero. Filtra por herramienta CSAT, rango de fechas y si la respuesta lleva feedback. Requiere la clave secreta.
- [Captura una puntuacion CSAT](https://woku.app/docs/api-reference/csat/captura-una-puntuacion-csat.md): Envia una puntuacion de satisfaccion CSAT (1 a 5) para la empresa solicitante. El csatToolId siempre es obligatorio porque las herramientas CSAT siempre son personalizadas (especificas de la herramienta). Opcionalmente incluye el correo del encuestado, o marca el envio como anonimo. CSAT no tiene ca…
- [Obtiene una sola respuesta CSAT](https://woku.app/docs/api-reference/csat/obtiene-una-sola-respuesta-csat.md)
- [Agregar un comentario de texto a una respuesta de CSAT](https://woku.app/docs/api-reference/csat/agregar-un-comentario-de-texto-a-una-respuesta-de-csat.md): Adjunta un comentario de texto opcional a una respuesta de CSAT existente. El comentario se clasifica de forma asincrona. Falla con 403 si la respuesta de CSAT no pertenece a la empresa que hace la llamada.
- [Agregar un comentario de voz a una respuesta de CSAT](https://woku.app/docs/api-reference/csat/agregar-un-comentario-de-voz-a-una-respuesta-de-csat.md): Adjunta un comentario de voz opcional (audio) a una respuesta de CSAT existente. El audio se sube y se transcribe en el servidor. Falla con 403 si la respuesta de CSAT no pertenece a la empresa que hace la llamada.
- [Obtener la definicion de una herramienta de CES](https://woku.app/docs/api-reference/ces/obtener-la-definicion-de-una-herramienta-de-ces.md): Devuelve la definicion de una herramienta de CES: su nombre interno, la pregunta de la encuesta, una accion de seguimiento opcional, y los locales disponibles y por defecto usados para renderizar la encuesta. Las herramientas de CES siempre son personalizadas. Falla con 403 si la herramienta no pert…
- [Listar las herramientas de CES de la empresa que hace la llamada](https://woku.app/docs/api-reference/ces/listar-las-herramientas-de-ces-de-la-empresa-que-hace-la-llamada.md): Lista paginada de las herramientas de CES de la empresa. Requiere la clave secreta.
- [Listar las respuestas de CES de la empresa que hace la llamada](https://woku.app/docs/api-reference/ces/listar-las-respuestas-de-ces-de-la-empresa-que-hace-la-llamada.md): Paginada, mas reciente primero. Filtra por herramienta, rango de fechas y si la respuesta lleva feedback. Requiere la clave secreta.
- [Capturar un puntaje de CES](https://woku.app/docs/api-reference/ces/capturar-un-puntaje-de-ces.md): Envia un puntaje de esfuerzo de CES (1-5) para la empresa que hace la llamada contra una herramienta de CES especifica. Las herramientas de CES siempre son personalizadas, por lo que `cesToolId` siempre es obligatorio. Opcionalmente incluye el correo del encuestado, o marca el envio como anonimo.
- [Obtener una unica respuesta de CES](https://woku.app/docs/api-reference/ces/obtener-una-unica-respuesta-de-ces.md)
- [Agregar una reseña de texto a una respuesta de CES](https://woku.app/docs/api-reference/ces/agregar-una-reseña-de-texto-a-una-respuesta-de-ces.md): Adjunta una reseña de texto opcional a una respuesta de CES existente. El comentario se clasifica y se combina de forma asincrona. Falla con 403 si la respuesta de CES no pertenece a la empresa que hace la llamada.
- [Agregar una reseña de voz a una respuesta de CES](https://woku.app/docs/api-reference/ces/agregar-una-reseña-de-voz-a-una-respuesta-de-ces.md): Adjunta una reseña de voz opcional (audio) a una respuesta de CES existente. El audio se sube y se transcribe en el servidor. Falla con 403 si la respuesta de CES no pertenece a la empresa que hace la llamada.
- [Lista los destinos de tickets de la empresa del solicitante](https://woku.app/docs/api-reference/destinos-de-tickets/lista-los-destinos-de-tickets-de-la-empresa-del-solicitante.md)
- [Crea un destino de tickets](https://woku.app/docs/api-reference/destinos-de-tickets/crea-un-destino-de-tickets.md): `kind`: zendesk \| salesforce \| slack \| custom \| email. `config`/`credentials` se validan segun el kind (ver `CreateTicketDestinationRequest`). `routingConditions` admiten el operador `equals` (un valor) o `any` (el tracker completo).
- [Obtiene un destino de tickets](https://woku.app/docs/api-reference/destinos-de-tickets/obtiene-un-destino-de-tickets.md)
- [Eliminar un destino de tickets](https://woku.app/docs/api-reference/destinos-de-tickets/eliminar-un-destino-de-tickets.md): Sus propias condiciones de enrutamiento viven en el destino y desaparecen con él.
- [Actualiza un destino de tickets](https://woku.app/docs/api-reference/destinos-de-tickets/actualiza-un-destino-de-tickets.md): Todos los campos son opcionales. Enviar `credentials` rota el secreto almacenado. Enviar `kind` cambia el proveedor; luego `config`/`credentials` se validan contra el NUEVO kind.
- [Listar los grupos de planes de acción de la empresa que hace la llamada](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/listar-los-grupos-de-planes-de-acción-de-la-empresa-que-hace-la-llamada.md)
- [Crear un grupo de planes de acción](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/crear-un-grupo-de-planes-de-acción.md)
- [Obtener un grupo de planes de acción](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/obtener-un-grupo-de-planes-de-acción.md)
- [Eliminar un grupo de planes de acción](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/eliminar-un-grupo-de-planes-de-acción.md): Sus condiciones y miembros viven en el documento y desaparecen con él; los planes ya generados conservan su propia instantánea congelada (referencian el grupo solo por id).
- [Actualizar un grupo de planes de acción](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/actualizar-un-grupo-de-planes-de-acción.md)
- [Habilitar o deshabilitar un grupo de planes de acción](https://woku.app/docs/api-reference/grupos-de-planes-de-acción/habilitar-o-deshabilitar-un-grupo-de-planes-de-acción.md): Un grupo deshabilitado deja de contar feedback y de generar borradores, pero mantiene visibles su historial y estadísticas.
- [Listar los planes de acción de la empresa que hace la llamada](https://woku.app/docs/api-reference/planes-de-acción/listar-los-planes-de-acción-de-la-empresa-que-hace-la-llamada.md)
- [Obtener un plan de acción](https://woku.app/docs/api-reference/planes-de-acción/obtener-un-plan-de-acción.md): Devuelve el plan completo, incluyendo la instantánea congelada de evidencia, el trace de generación y el estado de entrega.
- [Enviar un plan aprobado a un destino](https://woku.app/docs/api-reference/planes-de-acción/enviar-un-plan-aprobado-a-un-destino.md): `provider`: jira \| monday \| clickup \| notion (externo, necesita `target`) o `internal` (gestionado dentro de woku, sin target). Los proveedores externos requieren que el plan esté `approved` o `delivery_error`; la entrega corre luego de forma asíncrona (consultar `GET /v1/action-plans/{id}`). `in…
- [Agregar una tarea (borrador o plan gestionado)](https://woku.app/docs/api-reference/planes-de-acción/agregar-una-tarea-borrador-o-plan-gestionado.md)
- [Reordenar tareas (plan borrador o gestionado)](https://woku.app/docs/api-reference/planes-de-acción/reordenar-tareas-plan-borrador-o-gestionado.md)
- [Eliminar una tarea (plan borrador o gestionado)](https://woku.app/docs/api-reference/planes-de-acción/eliminar-una-tarea-plan-borrador-o-gestionado.md)
- [Editar una tarea: texto en un plan borrador/gestionado, estado y responsable en un plan gestionado](https://woku.app/docs/api-reference/planes-de-acción/editar-una-tarea:-texto-en-un-plan-borradorgestionado-estado-y-responsable-en-un-plan-gestionado.md)
- [Aprobar un plan borrador](https://woku.app/docs/api-reference/planes-de-acción/aprobar-un-plan-borrador.md): Transicion: `draft` → `approved`.
- [Reabrir a borrador un plan approved/delivery_error](https://woku.app/docs/api-reference/planes-de-acción/reabrir-a-borrador-un-plan-approveddelivery_error.md): Transicion: `approved` \| `delivery_error` → `draft` ("Editar").
- [Cancelar un plan](https://woku.app/docs/api-reference/planes-de-acción/cancelar-un-plan.md): Transicion: `draft` \| `approved` \| `delivery_error` \| `in_progress` → `canceled`.
- [Cerrar un plan gestionado](https://woku.app/docs/api-reference/planes-de-acción/cerrar-un-plan-gestionado.md): Transicion: `in_progress` → `completed`.
- [Reabrir un plan gestionado completado](https://woku.app/docs/api-reference/planes-de-acción/reabrir-un-plan-gestionado-completado.md): Transicion: `completed` → `in_progress`.
- [Servidor MCP](https://woku.app/docs/mcp/server.md): Qué es el servidor MCP de woku, cómo se autentica y qué puede tocar un agente conectado
- [Conectar un cliente](https://woku.app/docs/mcp/connect-a-client.md): Agrega el servidor MCP de woku a claude.ai, Claude Code, ChatGPT, Codex, OpenCode u otro cliente MCP y aprueba el acceso desde tu cuenta
- [Guía del agente](https://woku.app/docs/mcp/agent-guide.md): El método woku y las dos herramientas meta con las que un agente aprende a usar woku: woku_guide y design_voc_program
- [Herramientas](https://woku.app/docs/mcp/tools.md): Las herramientas que el servidor MCP de woku expone a un agente: wokus, NPS, CSAT, CES, formularios, planes de acción, reportes, facturación, integraciones y más

## OpenAPI Specs

- [openapi-v1](https://woku.app/docs/openapi-v1.json)
- [openapi-v1.es](https://woku.app/docs/openapi-v1.es.json)
- [openapi.es](https://woku.app/docs/openapi.es.json)
- [openapi](https://woku.app/docs/openapi.json)