# woku ## Docs - [Alertas por caída de volumen](https://woku.app/docs/alertas/caida-de-volumen.md): Detección estadística de caídas anómalas en el volumen de feedback, con desviación estándar y z-score - [Alertas por palabras clave](https://woku.app/docs/alertas/keywords.md): Detección automática de palabras clave en el feedback de texto y voz, con acciones configurables - [Get the caller company](https://woku.app/docs/api-reference/companies/get-the-caller-company.md): Returns company info, folders and wokus for the company resolved from the Bearer key. - [Assign a tracker value to a Woku by tracker name (upsert)](https://woku.app/docs/api-reference/external-trackers/assign-a-tracker-value-to-a-woku-by-tracker-name-upsert.md): Idempotent. If `(wokuId, trackerName)` already has a value, it is **overwritten**. The server resolves the tracker by name within the caller's company. - [List active tracker definitions of the caller company](https://woku.app/docs/api-reference/external-trackers/list-active-tracker-definitions-of-the-caller-company.md): Returns the paginated catalog of **active** tracker definitions belonging to the company resolved from the Bearer token. Inactive (soft-deleted) trackers are not returned here. - [List tracker values assigned to a Woku](https://woku.app/docs/api-reference/external-trackers/list-tracker-values-assigned-to-a-woku.md): Returns every tracker value currently bound to the given Woku, scoped to the caller's company. - [Remove a tracker value from a Woku](https://woku.app/docs/api-reference/external-trackers/remove-a-tracker-value-from-a-woku.md): Looks up the tracker by name (active or inactive) and removes its value from the Woku. Returns the removed document. **Not idempotent**: returns 404 if no value existed. - [Search Wokus by (tracker name, value)](https://woku.app/docs/api-reference/external-trackers/search-wokus-by-tracker-name-value.md): Returns paginated `WokuExternalTrackerValue` entries whose tracker name + value match within the caller's company. Use `.wokuId` from each result to fetch the full Woku via the v0 endpoints. - [Add a text review to an NPS score](https://woku.app/docs/api-reference/nps/add-a-text-review-to-an-nps-score.md): Attaches an optional text review to an existing NPS score. Fails with 403 if the NPS does not belong to the caller company. - [Add a voice review to an NPS score](https://woku.app/docs/api-reference/nps/add-a-voice-review-to-an-nps-score.md): Attaches an optional voice review (audio) to an existing NPS score. The audio is uploaded and transcribed server-side. Fails with 403 if the NPS does not belong to the caller company. - [Capture an NPS score](https://woku.app/docs/api-reference/nps/capture-an-nps-score.md): Submits an NPS score (0–10) for the caller company. Provide `npsToolId` to attach the score to a specific NPS tool; omit it for a company-level score. Optionally include the respondent email, or mark the submission anonymous. The detractor (0–6) / passive (7–8) / promoter (9–10) category is derived… - [Get an NPS tool definition](https://woku.app/docs/api-reference/nps/get-an-nps-tool-definition.md): Returns the definition of an NPS tool — its internal name and the message and audience used to build the survey question ("On a 0–10 scale, how likely are you to recommend {npsMessage} to {audienceType}?"). Fails with 403 if the tool does not belong to the caller company. - [Check whether a respondent is currently quarantined](https://woku.app/docs/api-reference/quarantines/check-whether-a-respondent-is-currently-quarantined.md): Read-only (dry-run) check: tells whether a respondent — identified by email or phone — is currently quarantined for the caller company, so a client can decide whether to prompt for feedback. Records nothing. - [Get the company-wide NPS report](https://woku.app/docs/api-reference/reports/get-the-company-wide-nps-report.md): Returns the aggregated NPS report for the company resolved from the Bearer key. - [Get the NPS report for a specific NPS tool](https://woku.app/docs/api-reference/reports/get-the-nps-report-for-a-specific-nps-tool.md): Returns the NPS report for the given tool. Fails with 400 if the tool does not belong to the caller company. - [Create a text review for a Woku](https://woku.app/docs/api-reference/wokus/create-a-text-review-for-a-woku.md): Submits a text review (star rating + text feedback) for a Woku. - [Create a voice review for a Woku (multipart)](https://woku.app/docs/api-reference/wokus/create-a-voice-review-for-a-woku-multipart.md): Submits a voice review for a Woku. The audio file is uploaded as `file` in a multipart request alongside the rating. - [Create a Woku with a file upload (multipart)](https://woku.app/docs/api-reference/wokus/create-a-woku-with-a-file-upload-multipart.md): Creates a Woku and uploads its asset in a single multipart request. - [Create a Woku with a file URL](https://woku.app/docs/api-reference/wokus/create-a-woku-with-a-file-url.md): Creates a Woku for feedback collection using a remote file URL. The file is downloaded and processed asynchronously. - [Get review data for a Woku](https://woku.app/docs/api-reference/wokus/get-review-data-for-a-woku.md): Returns the review payload for the given Woku: company info, woku details, and any existing reviews. - [Share a Woku review link via email](https://woku.app/docs/api-reference/wokus/share-a-woku-review-link-via-email.md): Sends the Woku review link to one or more email addresses inviting recipients to leave feedback. - [Flow](https://woku.app/docs/conceptos-basicos/flow.md): Aprende a armar y compartir un Flow, la secuencia de wokus y NPS - [Forms](https://woku.app/docs/conceptos-basicos/forms.md): Aprende a configurar un Form: campos, ajustes y verificación de respuestas - [NPS](https://woku.app/docs/conceptos-basicos/nps.md): Aprende a configurar herramientas NPS: mensaje, audiencia y formas de compartir - [woku](https://woku.app/docs/conceptos-basicos/woku.md): Aprende sobre las características de un woku: imagen, nombre y compartir - [Cuarentenas](https://woku.app/docs/configuracion/cuarentenas.md): Reglas anti-duplicado que limitan cuántas veces un respondente puede enviar el mismo formulario dentro de una ventana de tiempo - [Reglas de alerta](https://woku.app/docs/configuracion/reglas-de-alerta.md): Motor de reglas configurable que reacciona a respuestas y al paso del tiempo: asigna, notifica y escala automáticamente - [Guía de Integración API](https://woku.app/docs/desarrollo/API.md): Documentación completa de la API de woku para integrar wokus, NPS y trackers externos en tus aplicaciones - [Entorno sandbox](https://woku.app/docs/desarrollo/sandbox.md): Un entorno aislado que replica tu configuración de producción para probar funcionalidades, ingesta, transformaciones y alertas antes de publicarlas - [SDK de React Native](https://woku.app/docs/desarrollo/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/desarrollo/transformaciones.md): Transforma y calcula campos con JavaScript dentro del pipeline de ingesta de woku, sin middleware externo - [Instalación](https://woku.app/docs/empezando/instalacion.md): Instala woku como aplicación web progresiva en tu computadora o celular - [Primer Flow](https://woku.app/docs/empezando/primer-flow.md): Encadena varios wokus en una sola experiencia para tu cliente - [Primer Form](https://woku.app/docs/empezando/primer-form.md): Crea tu primer formulario y empieza a capturar datos estructurados - [Primer NPS](https://woku.app/docs/empezando/primer-nps.md): Crea tu primera herramienta NPS y compártela con tus clientes - [Primer woku](https://woku.app/docs/empezando/primer-woku.md): Crea tu primer woku y aprende a compartirlo con tus clientes - [Plataforma 100% autoservicio (DIY)](https://woku.app/docs/fundamentos/plataforma-autoservicio.md): Toda la administración de la plataforma se realiza por el propio equipo desde la interfaz, sin tickets ni dependencia del proveedor - [Problema](https://woku.app/docs/fundamentos/problema.md): Por qué las encuestas tradicionales ya no funcionan - [¿Qué es Flow?](https://woku.app/docs/fundamentos/que-es-flow.md): Encadena varios wokus y un NPS en una sola experiencia guiada para tu cliente - [¿Qué es Forms?](https://woku.app/docs/fundamentos/que-es-forms.md): Captura datos estructurados de tus clientes con formularios cortos y enfocados - [¿Qué es NPS?](https://woku.app/docs/fundamentos/que-es-nps.md): Mide la lealtad de tus clientes con la pregunta más usada del mundo, en formato woku - [¿Qué es woku?](https://woku.app/docs/fundamentos/que-es-woku.md): Conoce woku, la herramienta para capturar la opinión de tus clientes - [Encuestas multi-idioma](https://woku.app/docs/guias/encuestas-multidioma.md): Una sola encuesta con múltiples idiomas y selección automática según la preferencia del usuario o del navegador - [Importación de estudios externos](https://woku.app/docs/guias/importacion-estudios.md): Carga estudios propios en CSV y unifícalos con tus respondentes mediante mapeo de columnas - [Inactivación automática de usuarios](https://woku.app/docs/guias/inactivacion-usuarios.md): Inactivación de cuentas sin actividad con aviso previo y reactivación por administradores - [Metas](https://woku.app/docs/guias/metas.md): Define objetivos de NPS y tasa de respuesta por scope y sigue su cumplimiento - [Exportaciones programadas](https://woku.app/docs/guias/schedules-exportacion.md): Entrega automática de datos a SFTP, S3, webhook o correo según un cron configurable - [Bienvenido a woku](https://woku.app/docs/index.md): Documentación completa de woku, la plataforma para capturar la opinión de tus clientes - [Webhooks](https://woku.app/docs/integraciones/webhooks.md): Recibe eventos de woku en tu sistema en tiempo real, con firma HMAC para verificar la autenticidad y reintentos automáticos - [Widget web JavaScript](https://woku.app/docs/integraciones/widget-js.md): Instala el widget de captura de woku en cualquier sitio web con un loader