Contexto, variables y pruebas
Cómo usar los datos del contrato, propiedad e inquilino dentro de tus pasos y probar el flujo paso a paso con valores reales
Personaliza tus pasos con variables
Una automatización es útil cuando sus mensajes y acciones se adaptan a cada caso: el nombre del inquilino, la fecha de fin del contrato, el importe de la renta… Eso se consigue con variables, que son referencias a datos reales que Housely rellena en cada ejecución.
En lugar de escribir «Hola Juan», escribes Hola {{vars.tenant.firstName}} y, al ejecutarse, Housely lo sustituye por el nombre real del inquilino de ese contrato.
De dónde salen los datos: el contexto global
Cuando un flujo arranca, Housely carga el contexto global: toda la información de la entidad que lo disparó (el contrato, la propiedad, el inquilino, la incidencia o el gasto). Esos datos están disponibles para todos los pasos.
Los grupos de contexto más habituales son:
| Grupo | Ejemplos de campos |
|---|---|
| Evento del trigger | Datos del evento que disparó el flujo. |
| Contrato | Fechas de inicio y fin, renta, modalidad… |
| Propiedad | Dirección, estado, referencia… |
| Inquilino | Nombre, email, teléfono… |
| Propietario | Datos de contacto del propietario. |
| Incidencia | Título, categoría, gravedad… |
| Gasto | Importe, categoría, fecha… |
Además del contexto global, cada paso puede usar la salida del paso anterior: por ejemplo, el texto que generó el paso «Preguntar a la IA» puede usarse en el email que envías después.
Nota
Un paso solo puede leer datos del contexto global y de los pasos que van antes que él en el flujo. No puede leer resultados de pasos que aún no se han ejecutado.
Insertar variables en un paso
En el inspector, la columna «Datos de entrada» muestra dos secciones desplegables:
- «Salida del paso anterior»: el resultado del paso que precede a este.
- «Contexto global»: los campos del contrato, propiedad, inquilino, etc.
Tienes dos formas de usar esos datos en los campos de configuración:
Arrastrar y soltar: abre el árbol de datos, localiza el campo que quieres y arrástralo hasta el campo de texto del paso. Aparecerá como una etiqueta de variable.
Insertar variable: en un campo de texto, pulsa «Insertar variable», busca el dato con «Buscar variables…» y selecciónalo. Las categorías incluyen Contrato, Trigger, Pasos anteriores y Datos de prueba.
Internamente, las variables se guardan con la sintaxis de dobles llaves {{...}}, por ejemplo {{vars.tenant.email}} o {{steps.ia.content}}. No necesitas escribirlas a mano: el editor las inserta por ti, pero verás esa forma si revisas el contenido.
Nota
Puedes mezclar texto y variables libremente. Por ejemplo, un asunto de email como Recordatorio de pago del contrato {{vars.leaseId}} combina texto fijo con un dato real.
Probar un flujo
Antes de publicar, conviene probar el flujo con datos reales para ver exactamente qué ocurre. Las pruebas funcionan en modo seguro, así que no se envían comunicaciones reales ni se modifican tus datos.
Iniciar una prueba
Pulsa «Probar flujo» en la barra superior. Se abre la ventana «Probar este flujo».
Elige los datos reales: selecciona la Propiedad, Contrato, Incidencia, Gasto o Contacto sobre el que quieres simular el flujo (según el trigger).
Mantén el «Modo de prueba segura» activado para que los emails y mensajes se simulen en lugar de enviarse.
Pulsa «Iniciar prueba». El flujo queda listo para recorrerlo paso a paso.
Nota
En modo seguro, los emails se redirigen a tu propia dirección y los WhatsApp a tu número conectado, para que puedas comprobar el resultado sin molestar a inquilinos o propietarios.
Avanzar paso a paso
Durante una prueba puedes ejecutar el flujo de forma controlada y ver los resultados de cada paso:
- Desde cada nodo: usa el botón de play «Ejecutar este paso» (o «Volver a ejecutar este paso»). Cada paso muestra un estado: Pendiente, En ejecución, En espera, Hecho, Fallido u Omitido.
- Desde el cajón «Ejecución» (abajo): tienes una línea de tiempo de los pasos con sus estados y los botones «Siguiente paso» y «Ejecutar todos los pasos». Si estás ejecutando todo seguido, puedes «Cambiar a paso a paso».
Para los casos especiales, el cajón te ofrece las acciones adecuadas:
- Esperas de tiempo: se pueden acelerar para no tener que esperar de verdad («Acelerar temporizador» / «Avanzar a la fecha objetivo»).
- Esperas de evento: puedes simular el evento con «Entregar evento al nodo en espera» o «Activar evento».
- Revisión humana: puedes «Aprobar» o «Rechazar» desde la propia prueba.
Ver los valores reales
Aquí es donde las variables cobran sentido: durante una prueba activa, el selector de variables y la columna «Datos de salida» muestran los valores reales que toman los datos en esa ejecución concreta. Así compruebas que cada paso recibe lo que esperabas.
Nota
Si todavía no has lanzado una prueba, el selector de variables te avisará con «Ejecuta una prueba para ver los valores reales…» y un enlace para iniciar la prueba.
Retomar y revisar pruebas
- Si dejas una prueba a medias, al volver verás el aviso «Tienes una prueba en curso» con las opciones «Continuar prueba» o «Descartar».
- Desde «Ejecuciones» (barra superior) accedes al «Historial de ejecuciones», donde puedes ver una ejecución pasada en modo solo lectura, reanudar una prueba en curso o reintentar una ejecución.