# woku - [v1 (171 pages)](https://woku.app/docs/_llms/es/v1.md): Documentation for v1. ## v0 ### Documentación #### Empezando - [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 #### Fundamentos - [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 #### Conceptos Básicos - [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 - [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. - [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 - [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 acompaña a cada comprador con un viaje de 4 etapas post-compra (compra, entrega, posventa y lealtad), sin escribir código - [Conector Pancake](https://woku.app/docs/integrations/pancake.md): Conecta Pancake POS y tu inbox de Pancake con woku y acompaña a cada cliente con un viaje de 5 etapas: preventa, venta, entrega, posventa y lealtad, 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 - [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 #### Configuración - [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 #### Datos - [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 #### Planes de Acción - [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 - [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 #### Reportes y Analítica - [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 #### Guías - [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 ### Referencia de API #### Wokus - [Crear un woku mediante URL](https://woku.app/docs/api-reference/wokus/crear-un-woku-mediante-url.md): Crea un nuevo woku para la recoleccion de feedback usando la URL de un archivo. El archivo se descargara y procesara automaticamente. Opcionalmente, puedes asociar un correo o numero de telefono de cliente para enviar una invitacion a dejar una reseña. - [Crear un woku con carga de archivo](https://woku.app/docs/api-reference/wokus/crear-un-woku-con-carga-de-archivo.md): Crea un nuevo woku con una carga de archivo opcional usando multipart form data. Este endpoint es ideal cuando quieres subir la imagen directamente en lugar de proporcionar una URL. Admite archivos de imagen (JPEG, PNG, WebP, etc.). - [Crear una reseña de texto](https://woku.app/docs/api-reference/wokus/crear-una-reseña-de-texto.md): Crea una nueva reseña de texto (textnote) para un woku. Incluye una calificacion con estrellas (1-5) y feedback en texto. Opcionalmente puedes asociar un correo o numero de telefono de cliente. - [Crear una reseña de voz](https://woku.app/docs/api-reference/wokus/crear-una-reseña-de-voz.md): Crea una nueva reseña de voz (voicemail) para un woku con form data. Requiere la carga de un archivo de audio junto con una calificacion con estrellas. El audio se convertira automaticamente a formato MP4 y se transcribira. - [Obtener datos de reseñas de un woku](https://woku.app/docs/api-reference/wokus/obtener-datos-de-reseñas-de-un-woku.md): Obtiene los datos de reseñas de un woku especifico, incluyendo informacion de la empresa, detalles del woku, la URL del archivo y todas las reseñas existentes (calificaciones, textnotes y voicemails). - [Compartir un woku por correo](https://woku.app/docs/api-reference/wokus/compartir-un-woku-por-correo.md): Envia el enlace de reseña de un woku a una o mas direcciones de correo, invitando a los destinatarios a dejar feedback. Puedes enviarlo a un solo correo o a varios correos a la vez. #### Empresas - [Obtener datos de la empresa](https://woku.app/docs/api-reference/empresas/obtener-datos-de-la-empresa.md): Obtiene informacion completa de la empresa, incluyendo carpetas, wokus y datos de NPS, usando la API key de la empresa proporcionada en el header Authorization. #### Reportes - [Obtener el reporte NPS de la empresa](https://woku.app/docs/api-reference/reportes/obtener-el-reporte-nps-de-la-empresa.md): Obtiene los datos del reporte de NPS (Net Promoter Score) a nivel de empresa, incluyendo el puntaje NPS general, la distribucion de respuestas (promotores, pasivos, detractores) y las tendencias a lo largo del tiempo. - [Obtener reporte de herramienta NPS](https://woku.app/docs/api-reference/reportes/obtener-reporte-de-herramienta-nps.md): Recupera los datos del reporte NPS de una herramienta NPS especifica, incluyendo la distribucion de puntaje, el conteo de respuestas y analiticas detalladas. ### SDKs #### Gestión (servidor) - [SDK de JavaScript](https://woku.app/docs/development/sdk-javascript.md): Gestiona toda tu cuenta de woku desde tu backend con @wokuapp/sdk: trackers, herramientas VoC (NPS, CSAT, CES), wokus, tickets, planes de accion y envios sobre la API v1 - [SDK de Python](https://woku.app/docs/development/sdk-python.md): Gestiona toda tu cuenta de woku desde tu backend con el paquete woku: cliente sync y async sobre httpx para trackers, herramientas VoC, tickets, planes de accion y envios de la API v1 #### Captura (cliente) - [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