Crear un Workflow
- Como navegar al formulario de creacion de workflow
- Como completar cada campo: nombre, toggle de activacion, nivel de log, trigger y pasos
- Como guardar y probar tu nuevo workflow
Crear un workflow te permite automatizar una serie de acciones que se ejecutan siempre que se cumple una condicion especifica -- ya sea un horario programado, un evento del sistema o un boton presionado manualmente.
Paso a paso: crear un nuevo workflow
1. Abre la lista de workflows
Navega a Automatizaciones > Workflows en la barra lateral. Esto abre la pagina de lista de workflows, que muestra todos tus workflows existentes.
2. Haz clic en el boton agregar
Haz clic en el boton workflow_add en la parte superior de la pagina. Esto abre el formulario de creacion de workflow.
3. Ingresa el nombre del workflow (Nome)
En el campo Name, escribe un nombre descriptivo para tu workflow. Elige algo que describa claramente lo que hace el workflow, como "Mensaje de bienvenida para nuevos clientes" o "Recordatorio diario de citas."
4. Habilita o deshabilita el workflow (Ativado)
Usa la casilla de verificacion Ativado para controlar si el workflow esta activo. Cuando esta marcada, el workflow esta habilitado y se ejecutara cuando se cumpla su condicion de trigger. Dejala desmarcada mientras estes construyendo y probando.
5. Establece el nivel de log (Log Level)
Selecciona un Log Level del dropdown. Esto controla cuanta informacion se registra cada vez que el workflow se ejecuta. Un nivel de log mas alto captura mas informacion, lo cual es util durante pruebas y resolucion de problemas. Un nivel mas bajo reduce el ruido cuando el workflow esta funcionando bien en produccion.
6. Configura el trigger (Gatilho)
En la seccion Gatilho, elige un Tipo del dropdown. Hay tres opciones:
| Tipo de trigger | Cuando usarlo |
|---|---|
| temporal | Quieres que el workflow se ejecute en un cronograma (ej.: cada manana, una vez por semana) |
| hook | Quieres que el workflow se dispare cuando ocurra un evento especifico (ej.: se recibe un nuevo mensaje, se crea un cliente) |
| manual | Quieres que un profesional inicie el workflow manualmente cuando sea necesario |
Despues de seleccionar el tipo de trigger, pueden aparecer campos de configuracion adicionales dependiendo de tu eleccion. Consulta Tipos de trigger para detalles completos sobre cada opcion.
7. Agrega pasos (Etapas)
En la seccion Etapas, haz clic en el boton Add passo (Agregar paso) para agregar tu primer paso. Cada paso representa una accion que el workflow ejecutara. Puedes agregar tantos pasos como necesites, y se ejecutaran en orden de arriba hacia abajo.
La seccion Etapas tambien proporciona dos botones utilitarios:
- Debug all -- Ejecuta todos los pasos en modo de depuracion para que puedas inspeccionar como se comporta cada uno
- Limpar todos os itens (Limpiar todos los elementos) -- Elimina todos los pasos a la vez, permitiendote empezar de nuevo
Consulta Pasos del workflow para detalles sobre la configuracion de pasos individuales.
8. Guarda el workflow
Una vez que hayas configurado el nombre, trigger y pasos, guarda el workflow. Despues de guardar, opciones adicionales quedan disponibles, incluyendo el boton executeManual para probar workflows con trigger manual.
Probar tu workflow
Manten tu workflow deshabilitado (Ativado desmarcado) mientras construyes y pruebas. Cuando estes seguro de que funciona correctamente, marca la casilla Ativado para activarlo para uso en produccion.
- Para workflows manuales: Despues de guardar, haz clic en el boton executeManual para activar el workflow bajo demanda. Este boton solo esta disponible despues de que el workflow haya sido guardado.
- Para workflows hook: Activa el evento relevante en el sistema (ej.: crea un cliente de prueba) y luego verifica el historial de ejecucion para confirmar que el workflow se ejecuto.
- Para workflows temporales: Espera al horario programado, o ajusta temporalmente el cronograma a un horario cercano para pruebas.
Usa el boton Debug all en la seccion Etapas para recorrer tu workflow e inspeccionar como cada paso procesa datos antes de ponerlo en operacion.