Editor y ciclo de vida
Crear
Desde Automatizaciones → Flujos, elegí crear desde cero o usar una plantilla. Definí nombre, descripción y si será de una sola ejecución por sujeto cuando esa protección corresponda.
Canvas
Agregá pasos desde la paleta, conectá una salida con el siguiente nodo y seleccioná cada elemento para editarlo en el inspector. El editor admite deshacer y rehacer.
Un workflow necesita al menos un trigger, un nodo de entrada válido y caminos alcanzables. Las conexiones de condición, espera por evento y aprobación deben conservar sus etiquetas de rama.
Contexto y variables
Los valores aceptan datos del sujeto, contacto, deal, trigger, variables y outputs previos. Ejemplos habituales:
- doble llave + contact.firstName para el nombre;
- doble llave + deal.id para la oportunidad;
- doble llave + nodes.qualifier.output.score para un resultado anterior;
- doble llave + vars.nombre para una variable declarada.
Usá el selector de variables cuando esté disponible. Si un valor puede faltar, agregá una condición o fallback.
Validar y guardar
La validación revisa configuración obligatoria, nodos huérfanos, ramas y referencias. Guardá como borrador mientras existan IDs pendientes o mensajes de prueba.
Preview y prueba
Los nodos compatibles pueden previsualizarse con un contacto, deal o ticket. La prueba completa permite un sujeto y payload controlado. Revisá tanto la salida mostrada como los efectos simulados o reales indicados por el diálogo.
Activar
Antes de activar:
- el trigger está acotado;
- todos los catálogos existen;
- mensajes y variables tienen fallback;
- éxito, error y timeout llegan a un final;
- el workflow tolera eventos repetidos;
- el usuario ejecutor tiene permisos;
- el plan habilita módulos usados.
Mantener
Pausá antes de cambios amplios. Revisá runs fallidos, duración, esperas y aprobaciones pendientes. Eliminá un workflow solo cuando su historial y referencias ya no sean necesarios.
Diseñar antes del canvas
Escribí el proceso como evento, criterios, datos, decisiones, efectos y finales. Identificá qué puede repetirse, esperar, fallar o requerir aprobación. Recién después representalo con nodos.
Inspector y campos
Los valores pueden ser fijos o expresiones. Nombrá nodos por propósito —calificar_contacto— para que sus referencias sean legibles. No renombres identificadores usados sin revisar consumidores.
Conexiones y ramas
Una conexión determina orden y significado. No intercambies Verdadero/Falso, Evento/Timeout o Aprobado/Rechazado. Todo camino alcanzable debe llegar a un efecto controlado o a Fin.
Cambiar un workflow activo
- Pausá si cambia comportamiento real.
- Revisá runs en espera y aprobaciones.
- Guardá la nueva versión como borrador.
- Probá casos principales y alternativos.
- Activá con alcance reducido.
- Supervisá las primeras ejecuciones.
Convenciones
- Workflow: objeto + evento + resultado.
- Nodo: verbo + objeto.
- Variables: camelCase y sin secretos.
- Finales: éxito, descarte, rechazo, timeout y error.
- Descripción: propósito, owner y dependencia externa.
Errores de diseño frecuentes
- Trigger sin filtro.
- Rama sin destino.
- Output tomado de una rama que no corrió.
- Comunicación sin consentimiento o fallback.
- Espera sin timeout.
- Creación o incremento sin idempotencia.
- IA conectada directamente a un efecto sensible.