Disparadores de workflows
Cada workflow tiene un disparador: a mano, programado, por webhook, por un evento, una señal, una ficha u otro workflow. Cuatro necesitan el workflow en Live.
Para elegir o cambiar el de un workflow hace falta un administrador de la cuenta.
Workflows aún no está abierto en Filmo: la barra lateral lo muestra como próximamente y sus páginas no se pueden abrir. Este artículo describe cómo funciona cuando esté disponible en tu cuenta.
Toda automatización responde primero a una pregunta: ¿cuándo debe empezar? Después de una reserva, cada día laborable a las ocho, cuando tu web envía un formulario o cuando alguien pulsa un botón.
En Filmo, el es esa respuesta. Cada workflow tiene exactamente uno, que eliges al crearlo y puedes cambiar en el primer bloque del editor. El que cuenta es el de la : cambiarlo en el borrador no cambia nada hasta que publiques.
El workflow de Landmark Venues usa el disparador «Evento» con «Pedido reservado». Un segundo workflow, “Enviar recordatorio de entrega”, usa sobre pedidos, para que alguien lo lance desde la ficha del pedido.
Los siete disparadores
| Disparador | Cuándo arranca | Qué reciben los pasos | ¿Necesita Live? |
|---|---|---|---|
| «Manual» | Cuando alguien hace clic en «Ejecutar workflow» en el editor o en «Ejecutar» en el widget de inicio, o por la API pública. | Los campos del formulario de ejecución, si tiene. | No |
| «Programado» | Según una programación, en una zona horaria. | La fecha y la hora de esa ocurrencia. | Sí |
| «Webhook» | Cuando otro sistema envía una petición POST con JSON a la dirección del workflow. | El cuerpo de la petición. | Sí |
| «Evento» | Cuando pasa algo en Filmo o en una aplicación conectada. | El registro afectado y sus campos. | Sí |
| «Señal» | Cuando otro workflow lanza esa señal. | Los datos que declara la señal. | Sí |
| «Ejecución manual» | Cuando alguien hace clic en «Ejecutar workflow» en una ficha de ese tipo. | Esa ficha. | No |
| «Desde otro workflow» | Solo cuando lo llama el paso «Disparar workflow» de otro workflow. | Los campos de su formulario, que rellena el paso que lo llama. | No |
La última columna quiere decir que el workflow debe estar en , tener una versión publicada y no estar archivado. Pausar un workflow detiene su programación, sus eventos, sus y la dirección de su ; los otros tres disparadores siguen arrancando aunque esté pausado.
Cada disparador en detalle
Ejecuta un workflow de forma programada
Un arranca el workflow a horas fijas. Elige una opción predefinida («Cada minuto», «Cada 5 minutos», «Cada 15 minutos», «Cada 30 minutos», «Cada hora», «Cada día», «Cada día a las 08:00», «Laborables a las 08:00», «Cada semana», «Cada mes») o «Personalizada» para tu propia expresión, y una zona horaria.
- Filmo revisa las programaciones una vez por minuto, y cada ocurrencia se ejecuta como mucho una vez.
- Las ocurrencias que se pierden mientras el workflow está pausado no se recuperan después.
- Si Filmo no entiende una expresión personalizada, la publicación falla con «La expresión cron no es válida».
Manual, con formulario de ejecución
El disparador «Manual» puede pedir datos antes de arrancar con un : campos con «Etiqueta», «Nombre de la variable» y «Tipo» (sí/no, número, texto o fecha). Sin campos, arranca directamente; con campos, Filmo los pide en un diálogo. Los siguientes leen cada campo como una .
El nombre de una variable empieza por una letra, solo usa letras, números o guiones bajos, y no se puede repetir.
Ejecución manual sobre una ficha
«Ejecución manual» ejecuta el workflow sobre la ficha desde la que lo lanzas: un pedido, proyecto, presupuesto, factura, proforma, abono, orden de compra, factura de proveedor, subalquiler, contacto, oportunidad, artículo, unidad serializada, kit, miembro del personal, vehículo, servicio, incidencia, ticket de reparación, cuenta de tesorería, tarea y más. La ficha es la entrada, así que no hay formulario. El tipo de registro no se puede cambiar una vez elegido, porque los pasos se refieren a él.
Desde otro workflow
Este disparador no se puede lanzar a mano. Solo lo llama el paso de otro workflow, que rellena su formulario; ese paso también puede llamar a un workflow «Manual». A diferencia de una señal, es una llamada directa a un único workflow.
Eventos, webhooks y señales
Cada uno tiene su página: Inicia un workflow cuando pasa algo en Filmo, Inicia un workflow desde un webhook y Lanza workflows con señales.
Conviene saber
- Un workflow no arranca por los eventos que provocan sus propios pasos, ni por los de un workflow anterior de la misma cadena.
- Las cadenas de workflows que se arrancan entre sí se cortan en 10.
- Cambiar el disparador en el borrador no cambia lo que arranca el workflow hasta que publiques.
Si ves un error
| Mensaje | Qué significa |
|---|---|
| Este workflow solo se dispara desde otro workflow | Intentaste lanzar a mano un workflow con el disparador «Desde otro workflow». Lánzalo desde un paso «Disparar workflow». |
| Desde un paso solo se puede disparar un workflow manual o con trigger «Desde otro workflow» | El paso «Disparar workflow» apunta a un workflow con otro disparador. Cambia el destino o su disparador. |
| Se alcanzó el límite de 10 workflows encadenados… | Hay workflows que se arrancan entre sí en bucle. Revisa la cadena. |
| La expresión cron no es válida | La programación «Personalizada» no se entiende. Corrígela. |
| El webhook responde 404 | El workflow no está en «Live», no tiene versión publicada o su disparador ya no es un webhook. |
Siguiente paso
Reacciona a la reserva de un pedido: Inicia un workflow cuando pasa algo en Filmo.