Automations
Una automation es un flujo que corre sin que nadie lo ejecute a mano: completa campos, manda emails, crea o actualiza registros, llama a un sistema externo, genera un PDF. Se arman en un builder visual con nodos, condiciones, loops y fórmulas. Necesitás manage_automations (y manage_steppers para los Steppers). Viven en Configuración → Automatización → Procesos.
Tres tipos
| Tipo | Se dispara | Para |
|---|---|---|
| Evento de registro | Cuando se crea, edita o elimina un registro de una entidad — desde la pantalla, una importación, la API, un formulario público o un Stepper | Completar o validar datos, avisar, sincronizar, crear registros relacionados |
| Endpoint de API | Cuando un sistema externo hace una llamada HTTP a una URL de tu workspace | Webhooks entrantes: “cuando me llegue un pago, creá la donación” |
| Stepper | Cuando una persona lo lanza desde un registro; avanza por pantallas que piden datos | Procesos guiados: alta de un cliente, carga de un caso completo. Ver Steppers |
Conceptos
| Concepto | Qué es |
|---|---|
| Trigger | Qué lo dispara. Para eventos de registro: la operación (crear / actualizar / eliminar) y el momento (antes o después de guardar) |
| Nodo | Una acción del flujo: asignar valor, condición, loop, enviar email, llamar integración… |
| Variable | Un valor con nombre y tipo que viaja por el flujo (texto, número, booleano, registro, lista, objeto) |
{{referencia}} | Cómo se usa un valor en la configuración de un nodo: {{record.name}}, {{miVariable.campo}} |
| Contexto de ejecución | Con qué identidad corre: el usuario que disparó, uno fijo o el sistema |
Antes vs. después. Una automation antes de guardar corre en el mismo guardado: puede modificar los campos del registro (y esos cambios pasan por la validación) o cancelarlo; si falla, el guardado falla. Una después de guardar corre en segundo plano con el registro ya guardado: si falla, el registro queda igual y el error aparece en los logs. El orden completo está en Qué pasa al guardar un registro.
Crear una automation
- Procesos → Nueva. Elegí el tipo.
- Para un evento de registro: nombre, entidad, las operaciones (crear / actualizar / eliminar, una o varias) y el momento (antes / después). Antes de eliminar no existe.
- Se abre el builder.
El builder
- Paleta (izquierda): los nodos, agrupados y con buscador. Se arrastran al canvas.
- Canvas (centro): el flujo. Los nodos se conectan por cualquier lado; las ramas de una condición salen por abajo. Seleccioná un nodo y Supr lo elimina (el anterior se reconecta con el siguiente).
- Inspector (derecha): la configuración del nodo seleccionado, con pestañas Configurar, Test (para integraciones) y Ayuda.
- Barra superior: nombre, entidad y evento, Variables, Condiciones de entrada (filtros sobre el registro para que el flujo ni arranque si no aplican), Logs, Configuración (contexto de ejecución, orden, esquemas de entrada/salida en endpoints), el interruptor Activa y Guardar.
Al guardar se valida el grafo (nodos conectados, referencias válidas, configuraciones completas); un flujo inválido no se puede activar.
Seguir leyendo
| Página | Qué cubre |
|---|---|
| Triggers y nodos | Cada trigger y cada nodo, con sus opciones |
| Variables y referencias | Tipos de variable, {{…}}, autocompletado y navegación por relaciones |
| Fórmulas | Calcular valores: operadores y funciones |
| Conditions y loops | Bifurcar e iterar |
| Debugging y límites | Logs por paso, orden de ejecución, límites, errores comunes |
| Steppers | Procesos guiados con pantallas |