Feedback
El modulo de feedback te permite recoger opiniones, peticiones y reportes de tus usuarios desde multiples canales y centralizarlos en Almirant. La IA agrupa automaticamente el feedback similar y sugiere acciones, conectando la voz de tus usuarios directamente con tu proceso de ideacion y planificacion.
Flujo completo
El feedback sigue un recorrido desde la recogida hasta la implementacion:
- Recogida -- El feedback llega desde cualquiera de las cuatro fuentes soportadas
- Procesamiento -- La IA analiza el feedback, agrupa entradas similares (clustering) y genera sugerencias
- Vinculacion -- El feedback se enlaza a ideas existentes o nuevas
- Accion -- Las ideas con suficiente feedback se aprueban y promueven a work items
Fuentes de feedback
Widget embebido
Integra un widget directamente en tu producto para que los usuarios envien feedback sin salir de la aplicacion. El widget captura el mensaje del usuario junto con metadatos contextuales (pagina actual, sesion, etc.).
Bot de Telegram
Conecta un bot de Telegram para recibir feedback directamente desde un grupo o canal. Los mensajes enviados al bot se registran como entradas de feedback en Almirant con la fuente telegram.
API publica
Envia feedback programaticamente desde cualquier sistema externo usando la API publica:
POST /api/feedback/ingest
El endpoint acepta un payload JSON con el contenido del feedback y metadatos opcionales. Esto permite integrar la recogida de feedback en formularios personalizados, chatbots, aplicaciones moviles o cualquier servicio que pueda hacer peticiones HTTP.
Manual
Crea entradas de feedback manualmente desde la interfaz de Almirant. Util para registrar feedback recibido por email, llamadas telefonicas, reuniones o cualquier otro canal no automatizado.
Listado de feedback
La vista principal de feedback muestra todas las entradas recibidas con la siguiente informacion:
| Campo | Descripcion |
|---|---|
| Contenido | Texto del feedback enviado por el usuario |
| Fuente | Canal de origen (widget, telegram, api, manual) |
| Fecha | Fecha y hora de recepcion |
| Cluster | Grupo tematico asignado por la IA |
| Idea vinculada | Idea a la que esta enlazado (si aplica) |
Clustering con IA
Cuando se acumula feedback, la IA analiza el contenido y agrupa automaticamente las entradas que tratan sobre el mismo tema o peticion. Esto permite:
- Identificar patrones -- Detectar que funcionalidad o mejora solicitan multiples usuarios
- Cuantificar demanda -- Ver cuantos usuarios piden lo mismo
- Priorizar -- Tomar decisiones basadas en volumen real de feedback
Cada cluster tiene un nombre descriptivo generado por la IA (por ejemplo, "Solicitud de exportacion PDF" o "Problemas con la carga de imagenes") y agrupa todas las entradas de feedback relacionadas.
Como funciona
- Cada nueva entrada de feedback se analiza contra los clusters existentes
- Si el contenido es similar a un cluster existente, se anade automaticamente
- Si no encaja en ningun cluster, se puede crear uno nuevo
- Los clusters se actualizan dinamicamente conforme llega mas feedback
Sugerencias de IA
Basandose en los clusters de feedback, la IA puede generar sugerencias como:
- Crear una idea a partir de un cluster con alto volumen
- Vincular feedback a una idea existente que ya aborda esa peticion
- Priorizar ideas que tienen mas feedback asociado
Las sugerencias aparecen como recomendaciones que puedes aceptar o descartar.
Vincular feedback a ideas
El paso mas importante es conectar el feedback con ideas para crear trazabilidad entre lo que piden los usuarios y lo que el equipo decide construir.
Vincular desde el feedback
Desde el detalle de una entrada de feedback, haz clic en Vincular a idea y selecciona una idea existente o crea una nueva. Esto establece una relacion directa entre el feedback y la idea.
Vincular desde la idea
Desde el detalle de una idea, puedes buscar y vincular entradas de feedback existentes. Esto es util cuando ya tienes una idea creada y quieres asociar el feedback que la justifica.
Desvincular feedback
Si vinculas feedback a una idea por error, puedes desvincular la relacion desde el detalle del feedback o desde la idea. La entrada de feedback no se elimina, solo se rompe la asociacion.
El poder de la trazabilidad
Cuando el feedback esta vinculado a ideas, y las ideas se promueven a work items, se crea una cadena completa:
Esta cadena permite responder preguntas como:
- "Por que estamos construyendo esto?" -- Porque 15 usuarios lo pidieron (ver feedback vinculado)
- "Que usuarios se benefician?" -- Los que enviaron feedback sobre este tema
- "Que impacto tiene esta tarea?" -- Resuelve el cluster de feedback mas grande del mes
Consulta Promocion y trazabilidad para mas detalles sobre el flujo completo.
El feedback expone los siguientes endpoints y tools MCP:
API publica:
| Endpoint | Descripcion |
|---|---|
POST /api/feedback/ingest | Ingesta de feedback desde fuentes externas |
GET /api/feedback/bootstrap | Obtiene la configuracion inicial del widget de feedback |
Tools MCP para vinculacion:
| Tool | Descripcion |
|---|---|
link_feedback_to_idea_item | Vincula una entrada de feedback a una idea |
unlink_feedback_from_idea_item | Desvincula feedback de una idea |
El endpoint de ingesta (/api/feedback/ingest) es publico y no requiere autenticacion de sesion, lo que permite integrarlo en widgets client-side o servicios externos. Acepta un payload JSON con el contenido del feedback y metadatos opcionales como fuente e identificador de usuario.
Relacionado: Gestion de ideas | Promocion y trazabilidad