Workflows

Los Workflows son flujos visuales que definen lo que tu agente hace por su cuenta: qué agente responde, qué decisión toma según lo que escribe el cliente, cuánto espera antes de dar seguimiento y cuándo avisa a otro sistema.

Esta página explica la lista de workflows: cómo se organizan, cómo se activan y cómo ver si funcionan. Para construir uno, ve a El editor y sus nodos.

Qué quieres hacer

Quiero…	Ve a…
Ver cuántos flujos tengo activos y cómo van	Los cuatro indicadores
Activar, pausar o eliminar un flujo	Estados y acciones
Publicar un cambio	Guardar borrador vs. publicar
Probar un flujo antes de activarlo	Probar el flujo
Revisar qué pasó en cada ejecución	Ejecuciones
Armar el flujo con nodos	El editor y sus nodos

Workflows

Los cuatro indicadores

Arriba de la lista verás un resumen de cómo está funcionando tu automatización:

Indicador	Qué te dice
Flujos activos	Cuántos de tus flujos están activos, del total que tienes
Ejecuciones este mes	Cuántas veces se ejecutaron tus flujos desde el día 1 del mes en curso, comparado con el mes pasado
Terminaron con éxito	Porcentaje de ejecuciones terminadas que llegaron al final (completadas ÷ completadas + fallidas), contando desde el día 1 del mes en curso. Indica también cuántas están en espera o detenidas por respuesta del cliente
Última ejecución	Qué flujo se ejecutó más recientemente

Proyectos y flujos

Tus workflows se organizan en dos niveles:

Proyecto: una carpeta que agrupa los flujos de una misma cuenta o línea de negocio. Cada carpeta indica cuántos de sus flujos están activos.
Flujo (workflow): la automatización en sí.

Los canales se conectan por proyecto. Eso significa que dos flujos del mismo proyecto no pueden atender el mismo canal a la vez.

Crear un proyecto

Haz clic en Nuevo Proyecto.
Escribe el Nombre del proyecto.
Haz clic en Crear.

Crear un workflow

Dentro del proyecto, haz clic en Nuevo workflow en [nombre del proyecto].
Escribe el nombre del flujo y agrégalo.
Se abre el editor para que lo armes.

Si el proyecto está vacío, verás “Carpeta vacía · crear un workflow”. Y si aún no tienes ningún proyecto: “Crea un proyecto para comenzar”.

Los tres estados de un flujo

Estado	Qué significa
Activo	Está atendiendo mensajes del canal que tiene conectado
En pausa	Está publicado pero no recibe mensajes
Borrador	Aún no se ha publicado

Activar o pausar un flujo

Cada flujo tiene un interruptor Activar en la lista. Hay dos reglas:

Ver el detalle de un flujo

Al seleccionar un flujo en la lista, aparece un panel con su detalle:

Ejecuciones · 30 días y su porcentaje de Éxito.
Los pasos que lo componen. Si aún no tiene pasos, verás “Ábrelo en el editor para armarlo”.
El botón Abrir editor.

Eliminar un workflow

En la lista de Workflows, selecciona el flujo y usa Eliminar en su panel de detalle (junto a Abrir editor). Al eliminar un workflow se pierden todos sus nodos, conexiones y versiones publicadas. Esta acción no se puede deshacer.

Qué sigue

El editor y sus nodos: arma el flujo.
Publicar, probar y revisar ejecuciones: ponlo en marcha.

Publicar, probar y revisar ejecuciones

Armar el flujo es la mitad del trabajo. Esta página explica cómo ponerlo en marcha, cómo probarlo y cómo entender qué hizo.

Guardar borrador vs. publicar

Acción	Qué hace
Guardar Borrador	Guarda tu avance. No afecta lo que está funcionando en producción
Publicar	Convierte el borrador en una nueva versión y la pone en uso

Al publicar, Peaking te pide confirmar: “Se guardará el borrador actual y se publicará como v{n}. La versión publicada será usada por el motor de ejecución.”

Si el canal ya está en otro proyecto

Si el canal del Trigger pertenece a otro proyecto, al publicar verás “Mover el canal a este proyecto”. Si aceptas con Mover y publicar, el otro proyecto deja de recibir mensajes de ese canal y este workflow empieza a atenderlos.

Conversaciones que ya están en curso

Las conversaciones que ya iniciaron un flujo continúan con la versión con la que empezaron. Las nuevas usan la versión publicada más reciente.

Historial de versiones

El ícono de historial junto al número de versión muestra las versiones publicadas. Si aún no has publicado ninguna, verás “Aún no hay versiones publicadas”.

Probar el flujo

El botón Probar abre el Chat de Prueba, donde simulas una conversación sin afectar a clientes reales.

Escribe un mensaje de prueba y envíalo.
Si el flujo llega a un Delay, el chat indica “Workflow pausado por un nodo de delay”.
La Traza de Nodos muestra por qué nodos pasó la conversación.

El chat de prueba es una conversación de prueba aislada (no escribe a clientes reales) y conserva en memoria las variables que el flujo va capturando durante la sesión (no se guardan en tu cuenta); no hay un formulario para definirlas a mano. Con el botón de reiniciar empiezas una conversación nueva, sin variables.

Ejecuciones

El panel Ejecuciones muestra las ejecuciones recientes del workflow. Se abre con el botón Ejecuciones de la barra.

Estado	Qué significa
Completado	El flujo llegó al final
Ejecutando	Está corriendo ahora
Pausado	Está en espera, por ejemplo dentro de un Delay
Fallido	Terminó con un error

Si todavía no hay ninguna, verás “Las ejecuciones aparecerán aquí cuando los mensajes activen este workflow”.

Dos formas de ver el detalle

Al abrir una ejecución puedes alternar entre:

Ver línea de tiempo: los pasos agrupados por conversación, con el número de mensajes de cada una.
Ver crudo: el registro completo, tal como lo guarda el sistema.

En la línea de tiempo, cada paso muestra su Entrada, su Salida y su Duración. Cuando un nodo esperó, aparece indicado como Esperó.

Preguntas frecuentes

¿Puedo usar el mismo prompt en varios nodos Agente? Sí. Cada nodo puede tener sus propias herramientas, aunque compartan el prompt.

¿Qué pasa si ninguna rama de una Condición es verdadera? El flujo puede quedarse sin continuar. Conecta siempre la salida de “falso” a una respuesta genérica o a un escalamiento a humano.

¿Los Delays se cuentan en tiempo real? Sí, desde que el flujo llega al nodo. Con Cancelar si el usuario responde activo, el delay se cancela si el cliente escribe antes.

¿Por qué no puedo activar mi flujo? Hay dos causas posibles: aún no lo has publicado, o ya hay otro flujo activo en el mismo proyecto atendiendo ese canal. Revisa Workflows.