Asistente VendingPro
Chat flotante con IA disponible en todas las pantallas del sistema. Consulta datos en tiempo real, genera reportes, ejecuta acciones operativas usando lenguaje natural — impulsado por Claude (Anthropic).
El Asistente VendingPro es la interfaz de inteligencia artificial integrada en el ERP. Aparece como un botón flotante en todas las pantallas del sistema y, al abrirse, despliega un chat conversacional que entiende lenguaje natural, consulta datos reales del sistema y puede ejecutar acciones operativas como crear tickets, agendar visitas o registrar recolectas.
El Asistente VendingPro funciona exclusivamente con Claude, el modelo de lenguaje de Anthropic, considerado uno de los más avanzados y seguros para tareas empresariales. La integración está optimizada para Claude y no soporta otros proveedores de IA. El pie del chat siempre indica "Datos en tiempo real · Powered by Claude".
Acceso desde cualquier pantalla
El asistente aparece como un botón flotante azul circular con un ícono de chispas (✦) fijo en la esquina inferior derecha de la pantalla. Está disponible en todos los módulos: Dashboard, Clientes, Facturación, Tickets, Recolecciones, Contabilidad, Reportes, etc.
Al pulsar el botón, se abre el panel del chat directamente sobre la pantalla actual (sin perder el contexto del módulo donde estás trabajando). El mismo botón cambia a un círculo oscuro con una × mientras el chat está abierto, para cerrarlo.
Pantalla inicial del chat
Al abrir el chat por primera vez verás un panel flotante con encabezado azul, saludo personalizado y cuatro accesos rápidos a las preguntas más comunes.
Elementos del chat
- Header azul — título Asistente VendingPro, modelo activo (ejemplo: Claude Haiku) con punto verde indicando que está disponible
- Botón + — inicia una nueva conversación (limpia el historial visible)
- Botón reloj 🕒 — abre el historial de conversaciones anteriores (persistente entre sesiones)
- Botón × — cierra el chat (también lo cierra el botón flotante oscuro)
- Saludo personalizado — usa tu nombre y resume capacidades
- Cuatro chips de acceso rápido — preguntas frecuentes que se ejecutan con un solo clic
- Campo de entrada — escribe libre o usa el carácter
/para invocar comandos predefinidos - Footer — confirma siempre la fuente de datos y el proveedor de IA
Accesos rápidos disponibles
| Chip | Qué hace |
|---|---|
| Resumen del día | Reporte ejecutivo del día actual (ventas, tickets, recolectas) |
| Tickets críticos | Lista tickets de alta prioridad y SLA en riesgo |
| Facturas vencidas | CxC en mora con cliente y antigüedad |
| Generar reporte | Inicia el flujo de generación de reportes PDF |
Conversación natural y acciones reales
Puedes escribir cualquier pregunta o instrucción. El asistente entiende contexto, devuelve enlaces directos al módulo relevante y guía al usuario paso a paso cuando hace falta capturar datos para ejecutar una acción.
Tipos de interacción
Consultas de información
- "¿Cuáles son mis facturas vencidas esta semana?"
- "¿Qué máquinas tienen más tickets correctivos en los últimos 30 días?"
- "Resúmeme las recolecciones del mes"
- "¿Quiénes son mis 5 mejores clientes por facturación?"
Navegación inteligente
Cuando preguntas algo que vive en un módulo del ERP, el asistente devuelve el enlace directo a la pantalla correspondiente (con filtros ya aplicados cuando aplica). Por ejemplo, ante "muéstrame el reporte financiero" responde con el link https://system.vendingproerp.com/reports?tab=financial directo a la pestaña Financiero del módulo Reportes.
Creación de registros guiada
Cuando le pides crear algo (ticket, visita, recolecta), el asistente solicita los datos uno por uno antes de ejecutar. Ejemplo al pedir crear un ticket, te pregunta los seis campos requeridos:
- Cliente — nombre o RUC
- Tipo de ticket — correctivo, preventivo, recarga, instalación, inspección u otro
- Prioridad — crítica, alta, media o baja
- Título — resumen corto del problema
- Descripción — detalles del problema
- Máquina (opcional) — si hay una máquina asociada
Comandos slash (/)
Al escribir / en el campo de entrada se despliegan los comandos predefinidos del sistema. Permiten ejecutar acciones específicas sin tener que redactarlas en lenguaje natural.
Ejemplos de comandos disponibles:
/factura— consultas y acciones sobre facturas/cliente— búsqueda y operaciones sobre clientes/reporte— generar reportes PDF/ticket— crear o consultar tickets
Historial persistente
El botón con ícono de reloj 🕒 en el header del chat abre el historial de conversaciones. A diferencia de un chatbot tradicional que olvida todo al cerrar la pestaña, el Asistente VendingPro guarda las conversaciones por usuario y las recupera entre sesiones, permitiendo retomar análisis o consultas previas.
El botón + inicia una conversación nueva limpia cuando quieres aislar un tema sin contaminar el contexto con preguntas anteriores.
Configuración del Asistente
La configuración es exclusiva del Super Admin. Se accede desde Configuración → Integración → AI Integration → General.
Activación del asistente
El toggle "Asistente IA activo" controla si el botón flotante aparece en los módulos del sistema. Al apagarlo, el asistente se oculta para todos los usuarios.
Configuración de Claude
- API Key (Anthropic) — campo cifrado donde se introduce la clave personal de la cuenta de Anthropic. Se obtiene en
console.anthropic.comy se almacena cifrada en la base de datos. Solo el super_admin puede modificarla. - Probar conexión — botón que valida que la API Key sea correcta y haya saldo disponible antes de guardar.
- Modelo — selector con dos opciones:
- Claude Haiku 4.5 (rápido y económico, 3× más barato — por defecto)
- Claude Sonnet (balance ideal calidad/costo, para análisis más complejos)
- Máximo de tokens por respuesta — controla el largo máximo de cada respuesta. Por defecto 1000 (≈ 750 palabras). 2000 ≈ 1500 palabras.
Estadísticas de uso (últimos 30 días)
Cuatro KPIs actualizados en tiempo real desde el panel de configuración:
- Mensajes — total de interacciones del período
- Tokens — consumo acumulado (entrada + salida)
- Costo estimado — total en USD según la tarifa del modelo activo
- Acciones ejecutadas — registros creados o modificados desde el chat (tickets, visitas, etc.)
El botón Recargar refresca los contadores. Permite controlar el gasto y detectar uso anómalo.
Capacidades habilitadas
El panel enumera las capacidades del asistente con su estado actual:
| Capacidad | Estado | Qué permite |
|---|---|---|
| Búsqueda en todos los módulos | ✓ Habilitada | Consultar datos cruzados de cualquier módulo |
| Generación de reportes PDF | ✓ Habilitada | Disparar la generación de los reportes institucionales |
| Crear tickets, visitas, recolectas | ✓ Habilitada | Crear registros operativos desde el chat |
| Comandos slash (/factura, /cliente) | ✓ Habilitada | Atajos predefinidos para acciones frecuentes |
| Historial persistente de conversaciones | ✓ Habilitada | Recupera conversaciones entre sesiones |
| Editar/anular registros | ⚠ Restringida | Operaciones destructivas o de edición avanzada |
La capacidad de editar o anular registros está deliberadamente restringida. El asistente puede consultar y crear, pero modificar o eliminar registros existentes requiere hacerlo manualmente desde el módulo correspondiente. Es una salvaguarda contra ediciones masivas accidentales por instrucción ambigua.
Seguridad y privacidad
El aviso azul al pie del panel de configuración resume las garantías de seguridad del asistente:
El asistente consulta datos en tiempo real: facturas, clientes, tickets, máquinas. La API Key se almacena cifrada y solo super_admin puede modificarla. Los datos del cliente nunca salen del servidor.
- La API Key cifrada se almacena en la base de datos del ERP y nunca se expone en frontend ni logs
- Solo el rol super_admin puede ver, modificar o probar la API Key
- Las acciones que ejecuta el asistente quedan registradas con el usuario que estaba en sesión
- Las consultas que hace el asistente respetan el sistema de permisos del ERP — un usuario de Contabilidad no obtiene datos a los que su rol no tendría acceso por la UI normal
- Las conversaciones con el asistente son privadas por usuario
Limitaciones a tener presentes
- Costo de uso — cada interacción consume tokens de la API de Anthropic. El panel de configuración muestra el gasto del mes para controlarlo. Con Claude Haiku el costo típico es de centavos por conversación.
- Dependencia de conexión — el asistente requiere internet activo y que el servicio de Anthropic esté disponible. Si falla la conexión, el botón flotante no abre.
- El asistente puede equivocarse — sus respuestas son sugerencias basadas en datos reales, pero la decisión final siempre es del usuario. Verifica datos críticos antes de actuar (especialmente montos, fechas y referencias a clientes).
- No reemplaza el juicio profesional — las recomendaciones que el asistente da en análisis son ayudas para decidir, no decisiones automáticas.
- Sé específico — "Facturas vencidas esta semana de EMPRESA CAFE" es mejor que "facturas pendientes"
- Usa los chips y comandos slash — son atajos validados que dan resultados consistentes
- Aprovéchalo para resúmenes — es excelente sintetizando grandes cantidades de información
- Revisa el link de navegación — cuando devuelve un enlace, llévalo al módulo original para validar los datos
- Cierra y abre conversación nueva (+) al cambiar de tema — evita que el contexto previo influya en la respuesta