PRD técnico — InventBot

Resumen

InventBot es un sistema operativo conversacional para ecommerce. Gestiona catálogo, inventario, promociones, usuarios y consultas de negocio mediante WhatsApp.

El usuario es el comerciante o su equipo, no el comprador final. InventBot no es un bot de ventas ni forma parte del CRM: opera y explica la tienda.

Problema

La gestión de una tienda vive entre el panel del ecommerce, reportes, hojas de cálculo y aplicaciones adicionales. Tareas frecuentes como subir un producto, corregir stock o revisar ventas consumen tiempo y generan errores operativos.

InventBot reduce esa fricción, pero no puede convertir WhatsApp en un canal inseguro: los cambios deben ser trazables, estar limitados por permisos y requerir confirmación cuando tengan impacto.

Objetivo y propuesta de valor

Objetivo. Ejecutar operaciones frecuentes de una tienda y consultar su desempeño desde WhatsApp, con permisos, confirmación, auditoría e integración por plataforma.

Objetivos de la primera versión comercial

1. Conectar una tienda WooCommerce o Shopify por organización.
2. Crear, consultar y editar productos desde WhatsApp.
3. Consultar ventas, pedidos, inventario y productos destacados.
4. Registrar cada solicitud, confirmación y resultado.
5. Confirmar toda acción que publique, altere datos relevantes o elimine información.

Fuera de alcance inicial

• Atención automática a compradores finales.
• Pagos, reembolsos y métodos de pago.
• Campañas publicitarias, logística, facturación o contabilidad.
• Reemplazar completamente el panel de cada plataforma.

Usuarios y permisos

Cada número autorizado se asocia a una organización. El propietario designa administradores desde WhatsApp; estos pueden invitar operadores y lectores. Cada invitación muestra rol, tienda y permisos, requiere aceptación desde el número invitado y genera auditoría. Nadie puede elevar sus propios privilegios ni designar un propietario.

Alcance funcional

Conexión de tiendas

• Alta de organización y usuarios autorizados.
• Conexión segura, validación de permisos y revocación desde un panel administrativo.
• Una tienda activa por conversación.

Catálogo y productos

• Crear productos con texto, audio, imágenes o la combinación de estos.
• Extraer un borrador con nombre, precio, categoría, SKU, inventario, estado e imágenes.
• Generar título SEO, slug, metadescripción, texto alternativo, descripción corta, descripción larga y especificaciones por nicho.
• Generar cuatro propuestas de variación basadas en el nicho y catálogo. Solo se crean variantes reales si color, talla, capacidad, presentación, precio y stock son confirmados.
• Preguntar por información faltante y bloquear afirmaciones no sustentadas: precio, medidas, material, garantía, compatibilidad, certificaciones, ingredientes o stock.
• Buscar por nombre, SKU, enlace o referencia reciente; editar nombre, descripción, precio, SKU, inventario, imágenes, categorías, etiquetas, estado y visibilidad.

Inventario

• Consultar y ajustar existencias; distinguir entre sumar unidades y fijar una cantidad final.
• Avisar cuando un ajuste deja el inventario en cero o negativo.
• Identificar existencias bajas según un umbral configurable.
• Enviar una alerta inmediata al alcanzar el mínimo y otra al agotarse; incluir producto, variante, stock y umbral.

Ocultar y eliminar

Ocultar o despublicar es la opción predeterminada para dejar de ofrecer un producto. Eliminar es una acción de alto riesgo: se muestra el producto exacto, se advierte la irreversibilidad y se exige una segunda confirmación explícita.

Promociones programadas

• Crear promociones por precio promocional, porcentaje, valor fijo o cupón.
• Aplicarlas a producto, variante, categoría, colección o tienda completa según la plataforma.
• Definir inicio, fin y zona horaria de la tienda.
• Validar solapamientos y precios finales antes de confirmar.
• Activar y finalizar mediante jobs idempotentes; preservar y restaurar el precio o regla anterior.
• Notificar antes de iniciar, al iniciar, antes de terminar y al finalizar.

Ventas, pedidos y estadísticas

• Ventas brutas y netas, cuando la plataforma entregue el dato de forma confiable.
• Pedidos pagados/completados y pendientes, siempre separados.
• Ticket promedio, productos más vendidos, productos sin ventas, inventario bajo y agotados.
• Comparaciones de hoy vs. ayer, semana vs. semana anterior y mes vs. mes anterior.

Reportes, alertas e historial

• Resúmenes bajo demanda, diarios o semanales para usuarios autorizados.
• Alertas configurables de inventario bajo y agotados.
• Historial de solicitud, interpretación, confirmación, acción, resultado y recurso afectado.

Experiencia conversacional

El lenguaje debe ser directo y natural. Si hay ambigüedad o faltan datos, InventBot pregunta; antes de un cambio sensible, muestra exactamente lo que hará.

Crear un producto

1. El comerciante envía foto, audio o texto.
2. InventBot genera el borrador y pide los datos obligatorios faltantes.
3. Presenta el resumen e indica si se publicará o quedará como borrador.
4. El comerciante confirma o corrige.
5. InventBot crea el producto y devuelve el enlace y estado final.

Editar o eliminar

1. Identifica un único producto o muestra coincidencias.
2. Expone los valores anteriores y nuevos.
3. Solicita confirmación y ejecuta.
4. Para eliminar, exige una segunda confirmación literal.

Administrar roles

1. El propietario solicita la designación de administrador con número y tienda.
2. InventBot muestra permisos y pide confirmación.
3. El invitado acepta desde su propio WhatsApp.
4. Se activa el rol, se registra el evento y se notifica al propietario.
5. El administrador repite el flujo únicamente para operadores y lectores.

Consultar ventas

1. Resuelve el periodo usando la zona horaria de la tienda.
2. Consulta la fuente conectada.
3. Devuelve un resumen breve y ofrece el desglose solicitado.

Requisitos de seguridad y operación

• Verificar la firma de cada webhook de WhatsApp.
• Cifrar secretos y nunca exponerlos en chat o registros de error.
• Aplicar permisos por organización, tienda y número autorizado.
• Guardar auditoría inmutable para operaciones críticas.
• Usar confirmación obligatoria para publicar, editar precio/inventario, ocultar y eliminar.
• Usar cola durable, reintentos e idempotencia para evitar productos duplicados.
• Persistir sesiones y deduplicación fuera de la memoria del proceso.
• Aislar datos y credenciales de cada organización.
• Resolver el rol antes de ejecutar una intención; no inferir permisos desde el texto.
• Ejecutar promociones y alertas como jobs programados con zona horaria explícita e idempotencia.
• Preservar la regla o el precio anterior antes de una promoción para restaurarlo al finalizar.

Integraciones y arquitectura

Conectores nativos, núcleo centralizado

InventBot conserva un único backend: identifica a la organización, aplica permisos y confirmaciones, interpreta la solicitud, registra auditoría y llama al conector de la plataforma. No se duplica el agente ni sus reglas dentro de WordPress o Shopify.

• WooCommerce — InventBot Connect. Un plugin propio y ligero puede facilitar una conexión guiada, comprobaciones de compatibilidad, webhooks y diagnóstico. Es recomendable para el producto comercial, aunque no bloquea el MVP: WooCommerce puede conectarse inicialmente por su API y flujo de autorización externo.
• Shopify — app de InventBot. El equivalente es una aplicación instalada y autorizada con OAuth, con permisos mínimos para usar la Admin API y webhooks.
• Experiencia unificada. En ambos casos el comerciante verá “Conectar InventBot”, aprobará permisos y recibirá confirmación de que la tienda quedó conectada.

Estado actual de la base

La PoC existente ya recibe mensajes de WhatsApp, valida el webhook, procesa foto y audio, transcribe, genera un borrador con IA, pide confirmación y crea un producto simple de WooCommerce con imagen.

Aún no están implementados Shopify, multiempresa, roles/permisos, edición y eliminación, variantes, analítica, alertas, historial persistente, cola durable, Redis, pruebas automatizadas ni despliegue de producción.

Roadmap recomendado

Métricas de éxito

Adopción

• Tiendas conectadas y activas semanalmente.
• Usuarios autorizados activos por tienda.
• Retención tras la primera semana.

Valor operativo

• Acciones de catálogo confirmadas y completadas.
• Tiempo desde solicitud hasta resultado.
• Porcentaje de borradores confirmados sin corrección.
• Consultas y reportes por tienda por semana.

Calidad y confianza

• Tasa de fallos por integración.
• Productos duplicados o cambios revertidos por error.
• Acciones críticas con confirmación y auditoría.
• Tiempo de recuperación ante falla de proveedor.

Criterios de aceptación del MVP

1. Un usuario autorizado conecta una tienda WooCommerce de forma segura.
2. Puede crear un producto simple con datos completos y publicación confirmada.
3. Al crear desde imágenes, genera contenido SEO, especificaciones y cuatro propuestas de variación; ninguna variante no confirmada se publica como inventario real.
4. Puede buscar un producto y modificar precio o inventario tras confirmar el cambio.
5. Puede ocultar un producto y eliminarlo solo mediante doble confirmación.
6. Un propietario puede designar un administrador y este operadores o lectores desde WhatsApp; toda invitación requiere aceptación y queda auditada.
7. Una promoción se inicia y termina en la zona horaria configurada, no se ejecuta dos veces y restaura el precio o regla anterior.
8. Las alertas de stock bajo y agotado se emiten una sola vez por transición e incluyen producto, variante, stock y umbral.
9. Puede consultar ventas de hoy, semana y mes con estados de pedido claros.
10. El sistema guarda el historial y no ejecuta dos veces el mismo mensaje.
11. Si ocurre un error, InventBot no comunica éxito y deja registro para soporte.
12. Una organización no puede consultar ni operar los datos de otra.

Decisiones pendientes

• Modelo comercial: suscripción por tienda, usuario, número de WhatsApp o volumen.
• Países, monedas e impuestos prioritarios.
• Un solo administrador por tienda o equipos desde el inicio.
• Campos obligatorios por tipo de comercio.
• Límites y cobro del uso de IA, audio e imágenes.
• Definición exacta de “venta” y estados de pedido para cada plataforma.