Guia Demo automatizacion - ronalc90/koptup GitHub Wiki
Ruta
/demo/automatizacion· Modo de acceso: Abierta · Tipo: datos de ejemplo con motor real en el navegador (los flujos se ejecutan de verdad paso a paso sobre eventos de ejemplo; los conectores y la «IA» son simulados; no hay servidor) · Plan del producto: Automatización de procesos con IA
Resumen. Es un editor de flujos que funciona: una distribuidora ficticia («Distribuciones Nogal Andino S.A.S.», NIT 901.345.678-2) tiene tres procesos automatizados (facturas de proveedores al software contable, cobranza de cartera vencida y leads del sitio web al CRM) y se puede ejecutar cada uno con eventos de ejemplo, ver cada paso con sus datos de entrada y salida, editar el flujo (agregar pasos con clic o arrastrando, moverlos, borrarlos, configurarlos), resolver los casos que quedan para revisar, guardar y restaurar versiones, crear flujos desde plantillas, correr código JavaScript aislado y exportar el historial (CSV) o el flujo (JSON). Todo queda guardado en el navegador. La demo lo dice con los rótulos Datos de ejemplo y Conectores e IA simulados y con el desplegable ¿Qué es real y qué es simulado?.
En esta página: Recorrido sugerido · Pantallas y funciones · Datos de ejemplo · Qué es real y qué es simulado · Acceso · Limitaciones conocidas

Vista inicial a 1440 px: franja con «Volver a demos» y los rótulos, barra del editor, paleta de pasos a la izquierda, el flujo «Facturas de proveedores» en el lienzo, la configuración del paso elegido a la derecha y, abajo, las tarjetas de uso, versiones y casos para revisar y el historial de ejecuciones.
La historia: a la distribuidora le llegan por correo las facturas electrónicas de sus proveedores. El flujo las lee, las compara con la orden de compra, las registra como cuenta por pagar y avisa a tesorería. Lo que no cuadra no se pierde: queda en Para revisar para que una persona decida.

Recorrido completo en seis cuadros: el flujo, la ejecución, el detalle de la corrida, la excepción, la revisión del caso y el cambio de la regla.
flowchart LR
T["Correo de facturas<br/>(disparador)"] --> L["Leer factura<br/>(IA simulada)"]
L -->|"confianza ≥ 80 %"| B["Buscar orden de compra<br/>(hoja de ejemplo)"]
L -.->|"confianza baja"| R["Para revisar"]
B --> C{"¿Coincide con la orden?<br/>tolerancia 1 %"}
B -.->|"sin orden"| R
C -->|"sí"| P["Registrar cuenta por pagar<br/>(software contable simulado)"]
C -.->|"no"| R
P --> A["Avisar a tesorería<br/>(chat simulado)"]
R -->|"Aprobar y continuar"| P
El flujo «Facturas de proveedores» como lo ejecuta la demo. Las líneas punteadas son los casos que van a revisión.
Al abrir la demo está activo el flujo Facturas de proveedores y elegido el paso Leer factura. El lienzo se lee como una serpiente: la primera fila de izquierda a derecha, la segunda de derecha a izquierda, siempre siguiendo las flechas.

El flujo de seis pasos con el inspector abierto en «Leer factura».
- Flujo: menú para cambiar entre los tres flujos de ejemplo (y los que crees), renombrar, duplicar o eliminar.
- Ejemplo para ejecutar: los eventos de ejemplo del disparador (aquí, cuatro facturas que llegan por correo).
- Ejecutar: corre el flujo con el ejemplo elegido.
- Condición: «¿Coincide con la orden?» con su rama Si no: revisión.
- Configuración del paso elegido, en cuatro pestañas: Parámetros, Credencial, Reintentos y Probar.
Qué decir: «Cada caja es un paso; la flecha es el camino de los datos. Las cajas marcadas como Simulado son conectores que en tu proyecto se conectan a tus sistemas».
Deja elegida FE-5521 de Químicos La Sabana (cuadra) y pulsa Ejecutar.

A mitad de la ejecución: los pasos terminados con ✓ y el que está en curso parpadeando.
- Ejecutar se convierte en Detener mientras corre (detiene la ejecución en el paso en que vaya y la registra como «Detenida»).
- Paso terminado: marca verde y la flecha recorrida en azul.
- Paso en curso: ícono que gira.
Al terminar aparece un aviso («run-0009: Exitosa: 6 pasos») y la corrida queda arriba del historial. El motor de verdad leyó el XML, buscó la orden OC-2026-0141 en la hoja de ejemplo, comparó $ 2.618.000 contra $ 2.618.000, generó la cuenta por pagar CxP-2026-00414 (el consecutivo sigue a las dos facturas de ejemplo ya registradas hoy) y armó el mensaje a tesorería con esos datos. Los tiempos de cada paso son simulados.
La corrida nueva se abre sola. Pulsa el ojo de Leer factura.

La corrida nueva abierta con sus pasos y los datos de entrada y salida de «Leer factura».
- Corrida: identificador consecutivo, hora (Colombia), duración (la suma de sus pasos), estado, origen (Manual, Automática, Reintento, Aprobación o Repetición) y versión del flujo.
- Repetir con el mismo ejemplo: vuelve a ejecutar el flujo actual con ese evento.
- Paso: estado, barra proporcional a su duración, milisegundos y el mensaje de lo que hizo; el ojo muestra la entrada y la salida en JSON.
- Filtro por estado: Todas, Exitosa, Exitosa con reintento, En revisión, Fallida, Sin acción y Detenida (con el conteo de cada una).
- Exportar CSV: descarga las corridas filtradas del flujo.
Qué decir: «Cada ejecución deja rastro: qué entró, qué salió y cuánto tardó cada paso».
Elige FE-10234 de Papeles del Valle (no cuadra) y pulsa Ejecutar. Luego elige la condición y, en Probar, pulsa Probar este paso con el mismo ejemplo.

La factura de $ 4.284.000 contra una orden de $ 3.998.400: la condición no se cumple y el caso va a revisión.
- Condición con ícono de advertencia: ahí se detuvo la ejecución.
- Rama «Si no: revisión» resaltada.
- Probar: corre los pasos anteriores y la condición sin dejar rastro en el historial, y dice por qué no se cumple («diferencia de 7,1 %»), con la entrada y la salida del paso.
- Para revisar: el contador sube a 4 casos abiertos.
Pulsa Revisar casos (4).

La ventana con las excepciones y los fallos de todos los flujos.
- Caso: tipo (Excepción o Fallo), flujo (el nombre lleva al flujo), paso, corrida, motivo y ejemplo.
- Aprobar y continuar: retoma el flujo desde el paso siguiente a la condición con los mismos datos; se crea una corrida nueva («Aprobación de run-0010») y el caso pasa a Cerrados como «resuelto con run-0011».
- Marcar como atendido (alguien lo resolvió a mano) y Descartar.
- Dato que falta: en el fallo de cobranza del Hotel Brisas del Lago, que no tiene celular, se escribe uno válido (por ejemplo, 3005550199) y Reintentar termina el envío. Con un número inválido vuelve a fallar y el caso sigue abierto.
- Cerrados: los casos resueltos o descartados, con cuándo y cómo.
Qué decir: «La IA y las reglas hacen el trabajo repetitivo; las excepciones llegan a una persona, que decide».
Elige la condición, sube la Tolerancia a 10 y vuelve a ejecutar la factura FE-10234: ahora pasa. Guarda el cambio como versión.

La tolerancia en 10 %, el aviso de cambios sin guardar y el historial de versiones.
- Tolerancia (%): el motor usa este valor en la siguiente ejecución.
- Cambios sin guardar: el flujo ya no es igual a la última versión (las corridas quedan como «borrador»).
- Guardar versión: pide una nota y crea la versión v4.
- Historial de versiones: cada versión con nota, autor y fecha; Restaurar devuelve el lienzo a esa versión (con confirmación).
Cierra con el bloque azul del final de la página (Solicitar demo guiada): «¿Qué proceso te quita más tiempo? Lo armamos con tus sistemas».
La demo es una sola pantalla con paleta, lienzo e inspector, más ventanas para casos, plantillas, código, JSON y confirmaciones. Todas se cierran con la X, con Cancelar o con la tecla Escape.
| Elemento | Qué hace |
|---|---|
| Volver a demos | Lleva al catálogo /demo. |
| Datos de ejemplo · Conectores e IA simulados | Rótulos fijos. |
| ¿Qué es real y qué es simulado? | Despliega tres columnas: lo real, lo simulado y el recorrido sugerido. |
| Restablecer demo | Con confirmación, borra lo guardado y vuelve a los datos de ejemplo del día. |
| Flujo: … | Menú con tus flujos (con su número de pasos), Renombrar, Duplicar, Nuevo desde plantilla… y Eliminar flujo (con confirmación; no deja eliminar el último). Se maneja con el teclado (flechas y Escape). |
| Guardado como vN / Cambios sin guardar | Estado del flujo frente a su última versión. |
| Guardar versión | Igual que en la tarjeta de versiones. |
| Plantillas | Abre las plantillas. |
| Ejemplo + Ejecutar / Detener | Ejecuta el flujo con un evento de ejemplo del disparador. |
Veinte tipos de paso en seis grupos, con buscador. Un clic agrega el paso después del elegido; también se puede arrastrar al lienzo (aparece un punto azul donde quedará). Los disparadores reemplazan al del flujo, con confirmación, porque un flujo tiene uno solo.
| Grupo | Pasos | Qué hacen en la demo |
|---|---|---|
| Disparadores | Correo entrante, Formulario web, Programación, Mensaje de WhatsApp | Entregan el evento de ejemplo elegido (simulados). |
| IA (simulada) | Leer factura, Clasificar mensaje, Redactar texto, Preguntar al asistente | Reglas fijas: lectura del XML con confianza calculada, clasificación por palabras clave, plantilla con datos y búsqueda en cuatro políticas de ejemplo con su fuente. |
| Sistemas (simulados) | Buscar en hoja de cálculo, Registrar en software contable, Crear contacto en el CRM, Crear enlace de pago, Llamada HTTP | Buscan en las hojas de ejemplo o validan los datos y devuelven un resultado de ejemplo (número de documento, contacto, enlace pagos.example, eco HTTP). No salen del navegador. |
| Avisos (simulados) | Enviar mensaje (WhatsApp o chat del equipo), Enviar correo | Arman el mensaje final con los datos y validan el celular o el correo; no envían nada. |
| Lógica | Condición (si / si no), Esperar, Asignar por regla | Comparan valores (igual, distinto, mayor, menor, aproximadamente igual con tolerancia, contiene, tiene valor), registran la espera sin esperar y eligen responsable con una tabla «valor = responsable». |
| Código | Código JavaScript, Mapear campos | Ejecutan código propio en un Worker aislado o arman un objeto con «nombre = {{campo}}». |
- Las flechas siguen el orden de ejecución y nunca cruzan un nodo; en el celular los pasos quedan en una sola columna.
- Cada nodo muestra nombre, número y tipo, el rótulo Simulado si es un conector o IA, y su estado en la última ejecución: en espera, ejecutando, listo, reintentando, falló, en revisión, terminó aquí o detenido.
- Las condiciones muestran su rama Si no: revisión o Si no: termina, que se resalta cuando se toma.
- Un clic elige el paso; se puede arrastrar un paso para cambiarlo de lugar y Supr lo elimina (con Deshacer en el aviso). El disparador no se mueve ni se borra.
| Pestaña | Qué tiene |
|---|---|
| Parámetros | Qué hace el paso en la demo y en un proyecto real, su nombre y sus campos (con plantillas {{campo}}), los Datos disponibles en este paso (los que llegaron en la última ejecución) y Antes, Después, Duplicar y Eliminar. Todo cambio se guarda al instante y lo usa la siguiente ejecución. |
| Credencial | Credencial de ejemplo del conector (no hay secretos). Sin credencial, el paso falla al ejecutarse. |
| Reintentos | Reintentos (0 a 5), primera espera (1, 2, 5 o 10 s) y crecimiento exponencial o lineal, con el dibujo de las esperas. Si se agotan, la corrida falla y el caso queda para revisar. |
| Probar | Corre el flujo hasta ese paso con un ejemplo y muestra el resultado, la entrada y la salida, sin guardar la corrida. |

Reintentos de «Avisar a tesorería».
- Reintentos.
- Primera espera.
- Crecimiento de la espera.
- Esperas antes de cada reintento (por ejemplo, 2, 4 y 8 s).
El ejemplo FE-889 de Envases del Caribe hace que el software contable responda 429 una vez: con los reintentos por defecto la corrida queda «Exitosa con reintento» y el paso muestra «Esperó 2 s antes de reintentar». Con 0 reintentos, la misma factura falla y queda para revisar.

Las tres tarjetas, con el cálculo del ahorro abierto.
-
Uso y ahorro del mes (plan Básico, 10.000 ejecuciones al mes, como en el catálogo): ejecuciones del mes = un ritmo de ejemplo de cada flujo por los días corridos del mes más las que ejecutes. El conteo se reinicia el día 1 y Ver planes lleva a
/services#otras-soluciones. - ¿Cómo se calcula?: ahorro = ejecuciones exitosas × minutos de trabajo manual que evita cada una; los minutos se pueden cambiar por flujo.
- Historial de versiones del flujo activo, con Restaurar y Guardar versión.
- Para revisar: casos abiertos del flujo, fallos de las últimas 24 horas y Revisar casos.
Descrito en el paso 3. Muestra solo las corridas del flujo activo; la más reciente se abre sola. En el celular se ocultan las columnas de duración, origen y versión (aparecen al abrir la corrida).

Cinco plantillas con filtro por categoría.
- Categorías: Todas, Finanzas, Ventas, Servicio al cliente y En blanco (ninguna queda vacía).
- Pasos de la plantilla.
- Usar plantilla: crea un flujo nuevo con esos pasos y lo deja activo (sin versiones ni ejecuciones). La plantilla Respuestas por WhatsApp con el asistente no viene cargada: úsala para mostrar el asistente que cita la fuente y la pregunta que no sabe responder, que pasa a revisión.
Se abre con Abrir editor de código en un paso de Código JavaScript.

El código de ejemplo ejecutado con la factura FE-5521.
- Datos de entrada del ejemplo: el evento con el que se calcula la entrada del paso.
-
Código, Entrada (lo que recibe
datos) y Salida. - Resultado de la ejecución con su tiempo, o el error del código.
- Guardar: guarda el código en el paso (si cierras con cambios, pide confirmación).
- Ejecutar: corre el código de verdad en un Worker aislado, sin acceso a la página ni a internet, con un límite de 1,5 s (un ciclo infinito se corta).
En el pie de la demo.

El flujo activo en JSON.
- Importar JSON: crea un flujo nuevo desde un archivo (máximo 200 KB, 1 a 20 pasos, tipos conocidos y un disparador al inicio); si no cumple, dice por qué.
- Copiar al portapapeles.
- Descargar .json.

A 390 px. Izquierda: así abre la demo. Derecha: la configuración de un paso después de tocarlo.
- La paleta y la configuración empiezan cerradas. ☰ abre la paleta y el ícono de ajustes, la configuración; tocar un paso también la abre. Ambos paneles empiezan debajo de la barra del sitio, se cierran con la X, tocando fuera o con Escape.
- El lienzo queda en una columna y las tarjetas se apilan. No hay desbordes a lo ancho.
Todo es ficticio: empresas, personas, NIT (con dígito de verificación válido), correos (dominio reservado .example) y celulares (serie 300 555 01xx). Las fechas se arman con la fecha de hoy (las facturas son de ayer o antier; la revisión de cartera corre a las 8:00 de hoy, o de ayer si aún no son las 8:15) y nunca quedan en el futuro.
| Flujo | Ejemplos | Qué pasa |
|---|---|---|
| Facturas de proveedores (correo) | FE-5521 de Químicos La Sabana; FE-10234 de Papeles del Valle; FE-889 de Envases del Caribe; FE-3307 de Plásticos Altiplano | Exitosa; excepción por diferencia de 7,1 % con la orden; exitosa con un reintento (429); revisión porque al XML le faltan la fecha y el IVA (confianza 67 %). |
| Cobranza de cartera vencida (programación diaria) | Minimercado El Trébol (12 días, $ 3.450.000); Droguería Santa Inés (3 días); Hotel Brisas del Lago (sin celular) | Enlace de pago y recordatorio por WhatsApp (simulado); sin acción porque no pasa de 5 días; fallo por falta de celular, que se corrige en la revisión. |
| Leads del sitio web al CRM (formulario) | Catalina Restrepo, Medellín; Mauricio Pardo, Bogotá; Diana Ospina, Cali | Compra asignada a Valentina Ríos; compra asignada a Andrés Camacho; queja que va a revisión (servicio al cliente). |
| Respuestas por WhatsApp con el asistente (plantilla) | Envío gratis; producto roto; algo que no se vende | Respuesta con «Política de envíos 2026, sección 2»; respuesta con la política de devoluciones; revisión porque no hay respuesta en las políticas. |
Al abrir la demo por primera vez hay ocho ejecuciones de hoy, hechas con el mismo motor, y tres casos abiertos.
| Parte | Real o simulado | Detalle |
|---|---|---|
| Ejecución del flujo | Real (en el navegador) | El motor arma los datos paso a paso, llena las plantillas, evalúa condiciones, busca en las hojas, aplica las reglas, reintenta con espera y deja casos para revisar. La duración de cada paso es simulada y las esperas se acortan. |
| Edición del flujo, versiones, plantillas, casos, CSV y JSON | Real | Se guardan en este navegador (localStorage, una copia por idioma) hasta restablecer la demo. |
| Código JavaScript | Real | Se ejecuta en un Worker aislado (sin página ni red) con límite de 1,5 s. |
| Pasos de IA | Simulado | Reglas fijas; no se llama a ningún modelo. |
| Conectores (correo, hojas, software contable, CRM, pasarela de pagos, HTTP, WhatsApp, correo saliente) | Simulado | No se conectan a nada; no se envía ni se cobra nada. Las credenciales son nombres de ejemplo. |
| Uso del mes y ahorro | Datos de ejemplo | Ritmo de ejemplo más tus ejecuciones; los minutos por ejecución son editables. |
| Empresa, proveedores, clientes y prospectos | Ficticios | Ver Datos de ejemplo. |
-
Cómo la ve un visitante: la demo está en modo Abierta (
publico): cualquiera entra a/demo/automatizacionsin cuenta y sin pantalla de acceso. En el hub/demoaparece así:

Tarjeta «Automatización Workflows» en el hub, vista por un visitante sin sesión.
- Insignia Abierta (junto a «AI Ops»).
- Lo que Incluye según la tarjeta (ver la limitación 1).
-
Probar Demo abre
/demo/automatizacion. -
Solicitar demo guiada abre
/solicitar-demo?demos=automatizacion.
- Cómo se solicita: no hace falta solicitarla. Quien quiera verla con su propio proceso usa Solicitar demo guiada (en la tarjeta o en el bloque azul al final de la demo, que también ofrece Solicitar Cotización y Ver Planes y Precios).
-
Cómo la controla el admin: el modo sale del catálogo del servidor y se cambia en Admin › Catálogo de demos (
/admin/catalogo-demos). Si se pasa a «Con solicitud» o «Solo por invitación», los visitantes verán la pantalla de acceso y los accesos se conceden en Admin › Solicitudes de demo y Admin › Accesos a demos; si se desactiva, el visitante ve que la demo está «En mantenimiento» y el equipo de KopTup sigue entrando. Si el backend no responde, la demo sigue abierta porque así está en la tabla de respaldo. Detalle en el Manual del administrador y en Flujos del visitante.
flowchart LR
V["Visitante abre /demo/automatizacion"] --> C{"Modo en el catálogo"}
C -- "Abierta y activa" --> D["Demo completa, sin cuenta"]
C -- "Con solicitud o invitación" --> P["Pantalla de acceso"]
P --> F["/solicitar-demo?demos=automatizacion"]
D --> G["Bloque final: Solicitar demo guiada"]
G --> F
Hoy la demo toma la rama de arriba; las otras dos aplican solo si el admin cambia el modo.
- La tarjeta del hub todavía promete más que la demo («500+ integraciones», nodos de «STT/TTS», «SDK custom», «Versioning git-backed» y «environments»). La demo tiene 20 tipos de paso con conectores simulados, solo JavaScript (sin Python ni SDK) y versiones guardadas en el navegador, sin Git ni entornos. El cambio de textos de la tarjeta y de la descripción para buscadores está pedido aparte; mientras tanto, presenta la demo con esta guía.
- Conectores e IA simulados. Nada sale del navegador: no hay correos, mensajes, cobros ni llamadas a un modelo de IA. Los tiempos de cada paso son simulados y las esperas (paso Esperar y reintentos) no se hacen de verdad.
- Flujos lineales. Un flujo es una secuencia de hasta 20 pasos con un solo disparador; las condiciones tienen una sola rama alterna (revisión o terminar), sin ramas en paralelo ni ciclos.
- Ejemplos por disparador. Cada disparador tiene sus eventos de ejemplo; si cambias el disparador o armas un flujo con pasos que esperan otros datos, la ejecución falla diciendo qué dato falta (es el comportamiento esperado).
- Arrastrar y soltar funciona con mouse; en pantallas táctiles los pasos se agregan con un toque y se mueven con Antes y Después.
- Lo guardado vive en este navegador, una copia por idioma, con las últimas 120 ejecuciones; a los 21 días se vuelven a armar los datos de ejemplo. Otro navegador o una ventana privada empiezan de cero.
- El editor siempre se ve oscuro, también con el sitio en modo claro (como la mayoría de editores de flujos).