1.0 Introducción
Cada tienda OpenCart genera datos cada hora: pedidos, inventario, clientes registrados, carritos abandonados y fluctuaciones en los ingresos. Toda esta información se almacena en la base de datos. Para acceder a cualquier dato específico, hay que ir a la sección de administración correspondiente, seleccionar un rango de fechas, cargar el informe y repetir el proceso al día siguiente.
El Knowband Asistente administrativo inteligente con IA para OpenCart Elimina por completo esa necesidad. Integra una interfaz de chat con IA en tu panel de administración de OpenCart. Escribe cualquier pregunta sobre tu tienda en lenguaje natural y obtén una respuesta directa de tu base de datos en tiempo real en segundos. Sin SQL. Sin informes. Sin intervención de desarrolladores.
Esta guía explica detalladamente cada pestaña y configuración para que puedas conectar tu proveedor de IA, configurar el asistente y comenzar a consultar los datos de tu tienda desde el primer día. Compatible con OpenCart 3.x.
1.1 ¿Quién debería usar este chatbot de administración de IA para OpenCart?
Este asistente administrativo está diseñado para:
- Los dueños de tiendas que realizan las mismas comprobaciones de datos todas las mañanas necesitan una forma más rápida de hacerlo.
- Personal de operaciones que desea obtener información en tiempo real sobre pedidos, niveles de existencias e ingresos sin tener que cargar páginas de informes.
- Tiendas multiadministradoras donde los distintos miembros del equipo necesitan diferentes niveles de acceso a los datos de la tienda.
- Cualquier comerciante que desee análisis de back office de OpenCart impulsados por IA sin depender de un desarrollador.
2.0 Guía de instalación
Requisitos del sistema
Antes de la instalación, confirme que su configuración cumple con lo siguiente:
- OpenCart 3.x
- PHP 7.2 o superior
- Una clave API activa de OpenAI (ChatGPT), Anthropic (Claude) o Google (Gemini).
Instalación de la extensión
Paso 1: Descarga el archivo ZIP de la extensión desde tu cuenta. Inicia sesión en tu panel de administración de OpenCart.
Paso 2: Ve a Extensiones y luego a Instalador. Haz clic en el botón Cargar, selecciona el archivo ZIP de tu sistema y haz clic en Abrir. OpenCart se encarga de la carga y la extracción automáticamente.
Paso 3: Una vez confirmada la carga, vaya a Extensiones y luego a Extensiones. Seleccione Módulos en el menú desplegable de categorías. Localice el módulo en la lista y haga clic en el botón verde Instalar que aparece junto a él.
Paso 4: Una vez finalizada la instalación, haga clic en el botón Editar para abrir el panel de configuración por primera vez.
Paso 5: Si la extensión no aparece en la lista después de la instalación, vaya al Panel de control, haga clic en el icono del engranaje azul en la parte superior derecha y seleccione Actualizar para reconstruir la caché.
Problemas comunes de instalación
Error al cargar la página: El tamaño del archivo supera el límite del servidor. Solicita a tu proveedor de alojamiento que aumente los parámetros upload_max_filesize y post_max_size en la configuración de PHP a al menos 32 MB y vuelve a intentar subir el archivo.
La extensión no es visible después de la instalación: Dirígete al Panel de control y usa el icono de engranaje para borrar la caché de OpenCart. Luego, vuelve a Extensiones, después a Módulos y realiza una nueva búsqueda.
La pantalla de configuración parece estar rota: Borre la caché de su navegador recargándola por completo y restablezca la caché del tema de OpenCart desde el menú de configuración del panel de control.
3.0 Descripción general del panel de administración
El asistente de administración inteligente de IA para OpenCart de Knowband tiene ocho pestañas en la parte superior de la pantalla de configuración:
- Configuración Preferencias principales, opciones de visibilidad de SQL, entrada de voz, idioma, retención de registros, caché de esquema.
- Proveedor de IA: Conecta OpenAI ChatGPT, Anthropic Claude o Google Gemini utilizando tu propia clave API.
- Diseño del widget: Ajusta el aspecto del widget de chat dentro del panel de administración con una vista previa en tiempo real a la derecha.
- Vistas de base de datos: Seleccione los dominios de datos de la tienda que la IA tiene permitido consultar.
- Control de acceso: Decida qué perfiles de empleados pueden abrir y utilizar el asistente.
- Chips predefinidos: Accesos directos con un solo toque para consultar los datos diarios de la tienda.
- Historial de consultas: Un registro continuo de cada pregunta formulada, con el nombre del empleado, el tiempo de respuesta y el estado.
- Sesiones: Historias de conversación completas por empleado, disponibles para su consulta en cualquier momento.
4.0 Ficha Configuración
4.1 Configuración general para el Asistente administrativo inteligente con IA para OpenCart
Habilitar Chatbot: Control principal de encendido/apagado para este asistente administrativo. Al desactivarlo, se elimina por completo el widget de chat del panel de administración sin borrar ninguna configuración guardada ni el historial de consultas.
Habilitar chips predefinidos: Muestra u oculta los botones de preguntas de un solo toque dentro del widget de chat. Los chips aparecen como un panel expandible que cualquier administrador puede abrir o cerrar.
Estado predeterminado de los chips: Configura si el panel de chips está abierto o cerrado cuando el widget se carga por primera vez. Al estar contraído, permanece oculto hasta que el administrador lo abre. Al estar expandido, muestra el panel de chips de inmediato.
Número máximo de filas de resultados: Límite máximo de filas de datos que la IA devuelve para una sola consulta. El rango es de 1 a 1000; el valor predeterminado es 100. Aumente este valor para consultas que requieran conjuntos de datos completos y manténgalo en 100 o menos para comprobaciones diarias rápidas.
Mostrar/ocultar consulta SQL: Si se selecciona Sí, la consulta SQL utilizada para generar cada respuesta aparece en el chat debajo del resultado. Cualquier administrador puede ver exactamente cómo se obtuvieron los datos sin necesidad de consultar a un desarrollador.
Permitir edición y reejecución de SQL: Si se selecciona Sí, la consulta SQL que aparece debajo de una respuesta se puede editar en el chat. Cambia el rango de fechas, la categoría de producto o el umbral y vuelve a ejecutarla sin tener que escribir una nueva pregunta desde cero.
La entrada de voz: Activa el icono del micrófono en el chat. Al formular una pregunta, el navegador la convierte a texto mediante la API de reconocimiento de voz web. Funciona mejor en Chrome para ordenadores de escritorio.
4.2 ajustes de idioma
Utilice el lenguaje de back-office: El asistente responde en el idioma que esté configurado en el panel de administración de OpenCart. Si se cambia el panel de administración a francés, las respuestas aparecerán automáticamente en francés.
Usar idioma personalizado: Bloquea el idioma de respuesta a una opción específica, independientemente de la configuración del panel de administración. Útil cuando el personal trabaja en un idioma diferente al predeterminado del panel de administración.
4.3 Configuración de registro y caché
Retención de registros (días): Número de días que el historial de consultas permanece en el sistema antes de que las entradas antiguas se eliminen automáticamente. El valor predeterminado es de 90 días. No es necesaria ninguna limpieza manual; la eliminación se realiza automáticamente.
TTL de la caché de esquema (minutos): El tiempo durante el cual la extensión conserva el esquema de la base de datos en caché antes de actualizarlo. El valor predeterminado es de 1440 minutos. El esquema es un mapa de la estructura de la base de datos almacenada que la IA utiliza para generar consultas precisas. La página de Configuración muestra la última marca de tiempo de caché y la próxima fecha de vencimiento, por lo que el estado siempre está claro.
Actualizar esquema ahora: Reconstruye la caché del esquema bajo demanda sin esperar al ciclo TTL. Úsela después de agregar una nueva extensión, actualizar OpenCart o realizar cualquier cambio estructural en la base de datos.
Haga clic en Guardar configuración Aplicar todos los cambios en esta pestaña.
Pestaña de proveedor de IA 5.0
5.1 Cómo elegir a su proveedor
La pestaña Proveedor de IA se conecta a un modelo de IA externo mediante el proveedor que hayas elegido. Se admiten OpenAI (ChatGPT), Anthropic Claude y Google Gemini. Solo necesitas tu clave API y la conexión es directa, sin intermediarios ni suscripciones adicionales.
Haz clic en cualquier botón de proveedor para cargar su configuración: la clave API, el selector de modelo y el control de temperatura. Solo un proveedor puede estar activo a la vez. Cambiar de proveedor no afecta al historial de consultas ni a la configuración existente.
5.2 Cómo obtener tu clave API
OpenAI
- Visita platform.openai.com e inicia sesión o regístrate.
- Abra la sección Claves API desde el menú del icono de la cuenta.
- Haz clic en Crear nueva clave secreta, asígnale una etiqueta y guarda.
- Copia la clave antes de salir de la página. OpenAI no la mostrará de nuevo. Pégala en el campo Clave API de OpenAI.
Claude antrópico
- Visita console.anthropic.com e inicia sesión o regístrate.
- Dirígete a Claves API en el menú de navegación de la izquierda.
- Haz clic en Crear clave, asígnale un nombre y cópiala.
- Péguelo en el campo Clave API de Claude. También hay un enlace directo a la consola de Anthropic disponible en el módulo.
Google Géminis
- Visita aistudio.google.com e inicia sesión con una cuenta de Google.
- Haz clic en Obtener clave API en la parte superior izquierda.
- Selecciona un proyecto y genera la clave.
- Cópialo y pégalo en el campo Clave API de Gemini.
5.3 Selección de modelo para la extensión de análisis del back office de OpenCart
IA abierta:
- GPT-4o Mini, respuesta rápida, menor coste de API, adecuado para preguntas administrativas diarias rutinarias.
- GPT-4o ofrece un razonamiento más potente para consultas que abarcan varias tablas unidas.
- GPT-5.5, el nivel más capaz para preguntas analíticas complejas o por capas.
Claude Antrópico:
- Claude Haiku 4.5, rápido y económico, funciona bien para los controles matutinos en las tiendas.
- Claude Sonnet 4.6 es un punto intermedio útil entre velocidad y profundidad analítica.
- Claude Opus 4.7 es la mejor opción cuando las consultas involucran múltiples fuentes de datos.
- Gemini 3.5 Flash, rápido y potente, la opción estándar de partida para la mayoría de las tiendas.
- Gemini 3.1 Flash-Lite, la opción más económica por consulta, ideal cuando es importante mantener bajos los costos de la API.
Controla la coherencia y la variabilidad de las respuestas de la IA. Con un valor de 0, las respuestas son más precisas. Con un valor de 1, hay mayor variación en la formulación. Para consultas de datos almacenados, 0.3 es el punto de partida práctico. Utilice 0.0 cuando la precisión fáctica estricta sea la prioridad.
Haga clic en Guardar configuración del proveedor Aplicar.
6.0 Pestaña de diseño de widgets
La pestaña Diseño del widget controla la apariencia del widget de chat dentro del panel de administración de OpenCart. Cada ajuste se muestra en el panel de vista previa en tiempo real a la derecha antes de guardar los cambios.
Posición: La esquina de la pantalla donde aparece la burbuja de chat. La esquina inferior derecha es la predeterminada.
Nombre del chatbot: El nombre en el encabezado del widget. Asistente de administración inteligente por defecto.
Mensaje de saludo: El primer mensaje que se muestra al abrir el widget. Predeterminado: ¡Hola! Pregúntame lo que quieras sobre tu tienda.
Icono de burbuja: Reemplaza la imagen de burbuja predeterminada. PNG cuadrado, 64×64 píxeles, límite de 2 MB.
Avatar del chatbot: La imagen que aparece junto a cada respuesta del bot. PNG cuadrado, 48×48 píxeles, límite de 2 MB.
Ancho y alto del widget: Tamaño del panel de chat abierto en píxeles. El valor predeterminado es de 400 píxeles de ancho por 560 de alto.
Configuración de color: Seis controles de color, encabezado, burbuja de chat, mensaje de usuario, mensaje del bot, fondo y texto. No se requieren conocimientos de CSS. Los cambios se reflejan inmediatamente en la vista previa.
Haga clic en Guardar diseño Aplicar.
7.0 Pestaña Vistas de la base de datos
7.1 Cómo funcionan las vistas de la base de datos en este chatbot de IA para administración de OpenCart
Se creó un conjunto de vistas MySQL predefinidas para la extensión de informes de IA de OpenCart, que organiza y simplifica los datos relevantes para cada dominio. Las consultas se ejecutan únicamente sobre estas vistas; la IA no tiene acceso a las tablas originales y todas las vistas son de solo lectura. Los datos de la tienda no se pueden modificar, eliminar ni escribir a través del chat bajo ninguna circunstancia.
Al desmarcar una vista, ese dominio se elimina de la lista de consultas permitidas del asistente. La vista permanece intacta en la base de datos y se puede volver a habilitar en cualquier momento.
7.2 Vistas de base de datos disponibles
- Resumen de pedidos: Pedidos combinados con detalles del cliente, moneda, estado y totales.
- Artículos de la línea de pedido: Líneas de productos individuales por pedido con cantidades y precios.
- Clientes: Registros completos de clientes con información sobre grupo, género y fecha de la última visita.
- Productos: Datos del catálogo con información sobre nombre, stock, precio, categoría e imagen.
- Precios específicos / Descuentos en productos: Anulación de precios por producto y por combinación. Desactivada por defecto.
- Categorías: Nombres de las categorías y su jerarquía.
- Carritos de compra: Carritos de compra activos y abandonados con detalles del cliente y la moneda.
- Reglas del carrito / Cupones: Reglas de descuento con datos de uso y bandera de envío gratuito.
- La disponibilidad de stock: Niveles de existencias por producto y combinación, con nombres legibles.
- Empleados: Cuentas de administrador y sus datos de perfil.
- Direcciones de clientes: Registros de direcciones con datos de país, estado y cliente resueltos.
- Transportistas / Métodos de envío: Transportistas activos con mensaje de retraso en la entrega. Desactivado por defecto.
- Fabricantes / Marcas: Registros de marcas con descripciones y cantidades de productos.
- Combinaciones/variantes de productos: Datos de variantes con nombres de stock, referencia y atributos.
- Atributos y valores del producto: Agrupar atributos como Color y Tamaño con sus respectivos valores.
Haga clic en Guardar y crear vistas para aplicar. La extensión Knowband crea las vistas MySQL para cualquier dominio activado.
8.0 Pestaña de control de acceso
La pestaña Control de acceso permite configurar qué miembros del personal administrativo de OpenCart pueden abrir el asistente.
Garrapata: Restringir el chatbot a perfiles de empleados específicos. Para activar el acceso basado en roles. Cuando esta opción está desactivada, todos los administradores que hayan iniciado sesión pueden usar el asistente sin restricciones.
Cuando el acceso basado en roles está activo, aparece una lista de perfiles a continuación. El acceso de Superadministrador es permanente y no aparece en la lista. Marque cualquier otro perfil (Logístico, Vendedor, Traductor o roles personalizados) que deba tener acceso. Los perfiles que no estén marcados no verán al asistente al iniciar sesión. Si deja todos los perfiles sin marcar mientras el acceso basado en roles está activado, el asistente solo tendrá acceso de Superadministrador.
Haga clic en Guardar configuración de acceso Aplicar.
9.0 Pestaña de chips predefinidos
Los chips predefinidos son accesos directos a preguntas integrados en el widget de chat. Cada chip envía una pregunta almacenada a la IA en el momento en que se pulsa, sin necesidad de escribir ni navegar.
9.1 Chips predeterminados en el plugin de información de pedidos de OpenCart
Diez patatas fritas vienen listas para usar:
- Pedidos de hoy: ¿Cuántos pedidos se realizaron hoy?
- Ingresos (30 días): ¿Cuáles fueron los ingresos totales en los últimos 30 días?
- Pedidos cancelados: ¿Cuántos pedidos se cancelaron en los últimos 30 días?
- Carros Abandonados: ¿Cuántos carritos de compra fueron abandonados en los últimos 30 días?
- Clientes activos: ¿Cuál es el número actual de clientes activos?
- Fuera de stock: ¿Qué productos no tienen existencias disponibles en este momento?
- Pocas unidades disponibles (menos de 5): ¿Qué productos tienen menos de 5 unidades disponibles?
- Productos sin SKU: ¿A cuántos productos les falta una referencia SKU?
- Cupones de envío gratis: ¿Qué cupones activos ofrecen envío gratuito hoy?
- Nuevos clientes (este mes): ¿Cuántos clientes se han registrado este mes hasta el momento?
9.2 Agregar un chip personalizado
Haga clic en Agregar chip para abrir el formulario del chip.
Etiqueta: Texto breve para el botón. Que no supere las tres palabras. Por ejemplo: Ingresos semanales.
Pregunta: La pregunta que recibe la IA al pulsar este chip. Escríbela del mismo modo que la escribirías directamente en el chat. Por ejemplo: ¿Cuáles son los ingresos totales de los últimos 7 días?
Posición: La posición del chip en la lista del panel. Los números más bajos aparecen primero.
Activo: Sí, muestra el chip en el widget. No, lo mantiene guardado pero oculto.
Haga clic en Ahorrar chip Para finalizar, aparecen los botones Editar y Eliminar en cada fila para realizar cambios posteriores.
10.0 Pestaña Historial de consultas
La pestaña Historial de consultas registra todas las preguntas enviadas a través de esta herramienta. Cada entrada del registro muestra:
- Fecha: La hora en que se envió la consulta.
- Empleado: ¿Qué cuenta de administrador lo ejecutó?
- Pregunta: El texto completo de lo que se preguntó.
- Filas: Número de filas de datos que devolvió la consulta.
- Tiempo (ms): El tiempo que tardó en ejecutarse la consulta.
- Proveedor: El servicio de IA que lo gestionó se muestra como una insignia etiquetada.
- Estatus Verde para éxito, rojo para errores.
- SQL: La consulta ejecutada, visible en línea.
Filtre por estado y rango de fechas en la parte superior. Exporte los resultados visibles a CSV o Excel usando los botones encima de la tabla. Haga clic Eliminar registros antiguos para eliminar inmediatamente las entradas anteriores al período de retención de registros configurado.
Pestaña Sesiones 11.0
La pestaña Sesiones contiene el historial completo de conversaciones por empleado. Cada fila muestra el nombre del empleado, la hora de inicio de la sesión y el número de mensajes. Haga clic Ver Permite abrir el hilo completo, con preguntas y respuestas en orden cronológico, en una ventana emergente. Resulta útil para revisar los datos consultados, comprobar el uso del asistente o continuar la conversación de una sesión anterior.
12.0 Preguntas frecuentes
P: ¿Qué es el Asistente de Administración Inteligente con IA de Knowband OpenCart y cómo funciona?
Este es un chatbot de IA para administradores de OpenCart que permite a los administradores de tiendas formular preguntas en lenguaje natural y obtener respuestas al instante a partir de datos reales de la tienda. Se conecta a la base de datos de la tienda mediante vistas MySQL predefinidas de solo lectura, envía cada pregunta al proveedor de IA seleccionado (OpenAI, Anthropic Claude o Google Gemini), que crea y ejecuta una consulta SQL y, finalmente, entrega el resultado en lenguaje natural. Compatible con OpenCart 3.x.
P: ¿Qué proveedores de IA trabajan con la herramienta de análisis de back office de OpenCart?
El asistente de administración inteligente con IA de Knowband OpenCart es compatible con OpenAI (GPT-4o Mini, GPT-4o, GPT-5.5), Anthropic Claude (Haiku 4.5, Sonnet 4.6, Opus 4.7) y Google Gemini (Gemini 3.5 Flash, Gemini 3.1 Flash-Lite). Cada proveedor se conecta mediante su propia clave API sin necesidad de suscripción adicional. Solo paga por lo que la IA procesa.
P: ¿Puede el asistente administrativo de IA inteligente de OpenCart modificar o eliminar algún dato de la tienda?
No. La herramienta de análisis de ventas con IA de OpenCart lee los datos únicamente a través de vistas MySQL predefinidas. Ninguna consulta enviada a través del chat puede actualizar, eliminar ni escribir nada en la base de datos. Cada respuesta es una recuperación de solo lectura de tu tienda en línea.
P: ¿Qué datos puedo consultar utilizando el chatbot de IA del administrador de OpenCart?
Se pueden consultar pedidos, clientes, ingresos, existencias, carritos abandonados, cupones de descuento, combinaciones de productos, cuentas de empleados, transportistas, marcas y categorías. La pestaña Vistas de la base de datos controla qué dominios están activos. Active un dominio para permitir su acceso y desactívelo para restringirlo.
P: ¿Cómo funcionan los chips predefinidos en la herramienta OpenCart Smart Store Analytics?
Los chips son botones de preguntas que se pueden pulsar con un solo toque en el widget. Al pulsar uno, la pregunta guardada se envía directamente a la IA. El conjunto de chips predeterminado abarca pedidos, ingresos, carritos abandonados, existencias bajas, artículos agotados, clientes activos, clientes nuevos, pedidos cancelados, cupones de envío gratuito y productos sin SKU. Se pueden añadir, editar o eliminar nuevos chips desde la pestaña Chips predefinidos.
P: ¿Qué hace la función de visibilidad SQL en la herramienta de análisis de back office de OpenCart?
Activa la opción Mostrar consulta SQL y el código SQL de cada respuesta aparecerá en el chat debajo del resultado. Activa también la opción Permitir edición y reejecución de SQL para que este código se pueda editar directamente en el chat. Cambia una fecha, un filtro o un umbral y vuelve a ejecutarlo sin necesidad de hacer una nueva pregunta. Esta herramienta de análisis de ventas con IA de OpenCart hace que esta funcionalidad sea accesible para cualquier administrador, no solo para aquellos con conocimientos de SQL.
P: ¿Cómo funciona el control de acceso basado en roles en el chatbot de administración de IA de OpenCart?
Abra la pestaña Control de acceso y marque la opción Restringir el chatbot a perfiles de empleados específicos. El acceso de Superadministrador no se puede eliminar. Para los demás perfiles (Logista, Vendedor, Traductor o cualquier rol personalizado), marque los que deban tener acceso. Los perfiles que no estén marcados no verán al asistente después de iniciar sesión.
P: ¿Qué es la caché de esquema en la herramienta de análisis del back office de OpenCart?
La caché de esquema almacena el mapa estructural de la base de datos de la tienda para que la IA pueda generar consultas precisas sin necesidad de leer la base de datos completa en cada solicitud. La primera sesión de chat la genera automáticamente. Se actualiza según la configuración de TTL de la caché de esquema. Tras instalar una nueva extensión, actualizar OpenCart o realizar cualquier cambio en la base de datos, utilice la opción Actualizar esquema ahora para reconstruirlo al instante.
P: ¿Cómo conecto un proveedor de IA al Asistente de administración de IA inteligente de OpenCart?
Dirígete a la pestaña «Proveedor de IA». Selecciona el proveedor que prefieras: OpenAI, Anthropic Claude o Google Gemini. Para OpenAI, inicia sesión en platform.openai.com, ve a «Claves de API» y genera una nueva clave secreta. Para Anthropic, inicia sesión en console.anthropic.com, abre «Claves de API» y crea una. Para Gemini, inicia sesión en aistudio.google.com, haz clic en «Obtener clave de API» y genera una para tu proyecto. Pega la clave en el campo correspondiente y guarda.
P: ¿Es compatible el Asistente de administración inteligente con IA de OpenCart con OpenCart 3.x?
Sí. El asistente administrativo inteligente Knowband OpenCart funciona con OpenCart 3.x. Visite la página del producto para obtener información sobre la compatibilidad y las notas de la versión.
Conclusión 13.0
El Asistente administrativo inteligente con IA para OpenCart de Knowband Ofrece análisis de back office de OpenCart con IA para cualquier tienda OpenCart sin necesidad de conocimientos de SQL, soporte de desarrolladores ni plataformas de informes de terceros. Consulta en lenguaje natural, obtén respuestas a partir de datos en tiempo real, visualiza el código SQL de cada resultado y ajústalo al instante.
Los chips predefinidos reducen el tiempo de verificación diaria de la tienda a menos de un minuto. El acceso basado en roles pone la información correcta al alcance de las personas adecuadas. El historial de consultas mantiene un registro completo de cada pregunta formulada y cada resultado obtenido.
Para obtener asistencia, resolver requisitos personalizados o solicitar trabajos de desarrollo para OpenCart, póngase en contacto directamente con el equipo de Knowband.
