# woku - [v1 (181 pages)](https://woku.app/docs/_llms/es/v1.txt): 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 autoservicio](https://woku.app/docs/fundamentals/self-service-platform.md): Crea viajes, escucha a tus clientes y administra tu equipo desde woku #### Conceptos Básicos - [Viajes del cliente](https://woku.app/docs/core-concepts/journeys.md): Describe la experiencia de tus clientes, evalúa sus momentos y automatiza el seguimiento con control por cliente y caso - [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 - [Agente de follow up](https://woku.app/docs/core-concepts/follow-up-agent.md): Conoce el agente de inteligencia artificial que conversa por WhatsApp o correo con cada cliente que pidió mejorar algo y entrega el caso con evidencia - [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 - [Integrar un viaje](https://woku.app/docs/development/journey-integration.md): Configura cuatro momentos con API o MCP, contenido dinámico y webhooks independientes - [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. - [Entorno sandbox](https://woku.app/docs/development/sandbox.md): Un entorno aislado que replica tu configuración de producción para probar captura de respuestas e integraciones 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 #### 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 #### 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 #### Guías - [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 - [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 - [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