Disparadores
Elige cuándo empieza una automatización, también en una fecha como la llegada, filtra los casos y limítala a una vez por registro
Última actualización el
El disparador es el momento de inicio de una automatización: el "cuándo". Está en la parte superior de cada flujo, bajo el nombre Cuando ocurra esto. Un ejemplo: empieza cuando termina una ocupación. También determina qué datos pueden usar los pasos siguientes. Un flujo puede tener varios disparadores. Cada disparador inicia una ejecución propia, con su propio filtro. Añades uno desde la lista de la izquierda. El último disparador no se puede eliminar.
Cuándo empieza la automatización
En Empieza por eliges uno de los siete momentos de inicio.
| Opción | Empieza cuando |
|---|---|
| Cuando ocurre algo | Ocurre un evento en Tillor, como una ocupación que termina o una factura que se paga |
| Factura vencida | Una factura contabilizada sigue pendiente después de la fecha de vencimiento |
| Webhook entrante | Otro sistema envía un mensaje a la dirección propia de la automatización |
| Se elige una acción de tarea | Alguien elige en una tarea un botón de opción vinculado a esta automatización |
| Se alcanza una fecha | Se alcanza una fecha de un registro, opcionalmente un tiempo antes o después. Por ejemplo, un día antes de la llegada de una reserva |
| Cada día a una hora | Es la hora elegida de cada día |
| Según una expresión cron | Le toca el horario que indicas |
Primero eliges, por tanto, el tipo de momento de inicio y después los detalles. Si eliges otro momento de inicio, los filtros de Solo cuando se vacían. Estaban escritos para la elección anterior y ya no encajan.
Cuando ocurre algo
En Evento eliges qué debe iniciar la automatización. Haz clic en el campo y escribe para buscar, por ejemplo occupation o invoice. Los eventos aparecen con la notación de Tillor, como occupation:ended: primero de qué trata y después qué ocurrió.
Estos son los eventos que necesitarás con más frecuencia:
| Evento | Empieza cuando |
|---|---|
occupation:ended | Termina una ocupación |
reservation:created | Se crea una reserva |
reservation:updated | Se modifica una reserva |
customer:created | Se crea un cliente |
customer:updated | Se modifica un cliente |
invoice:created | Se crea una factura |
invoice:updated | Se modifica una factura |
invoice:paid | Una factura está pagada |
payment:created | Entra un pago |
task:created | Se crea una tarea |
task:status-changed | Cambia el estado de una tarea |
task:assigned | Se asigna una tarea a alguien |
task:action-chosen | Alguien elige un botón de opción en una tarea |
integration-alarm:created | Un contador emite una alarma |
comment:created | Se publica un comentario |
document:created | Se añade un documento |
signatureRequest:updated | Se actualiza una solicitud de firma |
signatureRequest:completed | Todos los firmantes de una solicitud de firma han firmado |
mandate-agreement:signed | Un cliente ha firmado un mandato SEPA |
mandate-agreement:activated | Un mandato SEPA se ha activado |
mandate-agreement:expired | Una solicitud de mandato SEPA ha caducado sin firma |
mandate-agreement:failed | La activación de un mandato SEPA ha sido rechazada o ha fallado |
productPriceChange:applied | Entra en vigor un precio de producto programado |
Es la misma lista que la de los webhooks. Por tanto, puedes usar cualquier evento para el que Tillor pueda enviar un webhook. Algunos eventos que ocurren con muchísima frecuencia, como el estado físico de las barreras, la escritura en la bandeja de entrada, los registros de controladores y la presencia de vehículos, no figuran en la lista.
¿Falta un evento?
Bajo el campo Evento está el enlace ¿Falta un evento? Solicítalo. Consulta Solicitar un paso o un evento.
Qué datos recibes
La mayoría de los eventos llevan asociado un registro, como una ocupación, una factura o una tarea. Ese registro, más los registros a los que se refiere, están disponibles después como variables en los pasos. En occupation:ended, por ejemplo, puedes usar:
{occupation.terrain.name}para el nombre de la parcela{occupation.customer.firstName}para el nombre del cliente{occupation.reservation.displayId}para el número de la reserva. No toda ocupación tiene una reserva: en ese caso queda vacío
Además, siempre están {triggeredBy.name} y {triggeredBy.id}: el compañero que provocó el evento. Si el evento lo provocó el sistema, por ejemplo una sincronización bancaria, esos campos están vacíos.
Bajo los ajustes del disparador está Datos que proporciona este evento. Ahí ves exactamente qué variables puedes usar. En un evento cuyos datos no están descritos, Tillor indica que no hay nada que elegir. Las variables que escribas tú mismo siguen funcionando. Consulta Variables y plantillas.
Se elige una acción de tarea
Algunas tareas tienen botones de opción en lugar de una casilla, por ejemplo de Pedir una decisión. Un botón puede estar vinculado a una automatización. Con este disparador, esa automatización empieza en cuanto alguien elige ese botón. Consulta también Tareas con botones de opción.
Vincular un botón a una automatización no se hace en el editor de flujos. Si lo necesitas, pídeselo al administrador de Tillor o a soporte.
Los pasos reciben los datos de la tarea, por ejemplo {task.name} y {task.id}, además de {action.label} (el nombre del botón elegido) y {note} (la nota que rellenó el compañero, si el botón la pedía). Bajo Datos que proporciona este evento ves la lista completa.
Factura vencida
Este disparador se activa para cada factura que:
- está contabilizada (los borradores y las facturas canceladas no cuentan)
- no es una nota de crédito
- aún tiene un importe pendiente
- tiene una fecha de vencimiento anterior a hoy
Para cada una de esas facturas empieza una ejecución propia. Los datos de la factura y del cliente están disponibles como {invoice.…}, por ejemplo {invoice.displayId}, {invoice.amountOutstanding} y {invoice.customer.firstName}.
Si desactivas Ejecutar una vez por registro, la automatización empieza para la misma factura como máximo una vez al día mientras esté vencida. Si lo dejas activado, empieza exactamente una vez por factura. Normalmente es lo que quieres para un recordatorio.
En Pendiente de recordatorio eliges cuánto tiempo debe llevar abierta la factura, con la misma regla que en la lista de facturas. Activa Omitir clientes excluidos de recordatorios automáticos para saltarte a los clientes que lo tienen indicado en sus ajustes de facturación. Una factura que se ha excluido de los recordatorios automáticos tampoco inicia el flujo.
Webhook entrante
Un webhook es un mensaje que un sistema envía a una dirección. Con este disparador, ese sistema inicia la automatización, por ejemplo tu sitio web, un formulario o una plataforma de reservas. Cada automatización recibe una dirección propia y secreta.
- En Empieza por elige Webhook entrante
- Guarda la automatización. En Dirección aparece la URL
- Haz clic en Copiar y configura la dirección en el otro sistema
- Activa la automatización
El otro sistema envía un POST con JSON a esa dirección. El contenido queda disponible después como {body.…}, por ejemplo {body.email} o {body.reservering.nummer}, y los parámetros de la URL como {query.…}. Con Solo cuando también puedes filtrar por esos campos.
Así funciona además:
- La dirección es el secreto. Quien la conozca puede iniciar la automatización. Compártela, por tanto, solo con el sistema que la necesita
- Si la dirección se filtra, haz clic en Nueva dirección y guarda. La dirección anterior deja de funcionar desde ese momento
- Una automatización desactivada o una dirección incorrecta devuelve un error
404 - El contenido puede ser de 100 KB como máximo
- Cada llamada inicia una ejecución por disparador de webhook del flujo. La dirección pertenece al primer disparador de webhook. Nueva dirección en ese disparador la sustituye
- No hay ningún registro vinculado, así que Ejecutar una vez por registro no tiene efecto
Ignorar repeticiones
Si el otro sistema envía a veces la misma llamada dos veces, con Ignorar repeticiones evitas que el flujo empiece dos veces. Tillor recuerda una clave de la llamada. Si vuelve la misma clave, no empieza nada.
| Opción | Cuál es la clave |
|---|---|
| Cada llamada inicia el flujo | No hay clave. Predeterminado |
| Desde una cabecera | El valor de una cabecera que eliges en Nombre de la cabecera, por ejemplo Idempotency-Key |
| Desde el cuerpo JSON | El valor de un campo del JSON, que eliges en Campo, como id o data.eventId |
| El mismo cuerpo JSON | Todo el contenido. Una llamada con exactamente el mismo contenido cuenta como repetición |
En Recordar la clave durante eliges cuánto tiempo vale la clave, en horas, días o semanas. Pasado ese tiempo, la misma clave vuelve a iniciar el flujo. Con 0, la clave vale hasta que elimines la automatización. Una llamada sin la cabecera elegida o sin el campo elegido se rechaza.
Se alcanza una fecha
Este disparador empieza en una fecha de un registro. En Fecha eliges cualquier campo de fecha de un registro que Tillor también envía con los eventos, escrito como registro y campo. Algunos ejemplos:
| Fecha | Registro |
|---|---|
reservation.checkIn | La fecha de llegada de una reserva |
reservation.checkOut | La fecha de salida de una reserva |
invoice.dueDate | La fecha de vencimiento de una factura |
task.dueDate | La fecha límite de una tarea |
occupation.paidUntil | Hasta cuándo está pagada una ocupación |
accessMethod.periodTo | El fin de la validez de un código QR, una matrícula u otro método de acceso |
nfcTag.activatedUntil | Hasta cuándo está activada una etiqueta NFC |
mandateAgreement.expiresAt | Cuándo caduca una solicitud para firmar un mandato SEPA |
customer.birthday | La fecha de nacimiento de un cliente |
contact.birthday | La fecha de nacimiento de una persona de contacto |
De forma predeterminada, el disparador empieza una vez, en la propia fecha. Activa Repetir cada año para que solo cuenten el día y el mes: el flujo empieza entonces cada año de nuevo, como en el cumpleaños con contact.birthday. Un 29 de febrero cae en otros años el 28 de febrero.
También puedes elegir datos que se guardan en un registro como campos adicionales. document.userMetadata.insuranceExpiryDate es la fecha de vencimiento de un documento, como el justificante de pago del seguro. Una fecha así, sin hora, cuenta como medianoche (UTC, la hora estándar internacional). Con Solo cuando limitas entonces el disparador a un tipo, por ejemplo document.userMetadata.documentType es INSURANCE_PAYMENT_PROOF, y a documentos activos con document.status es ACTIVE.
Con Cuánto tiempo y Antes o después desplazas el momento. 1 día y Antes en reservation.checkIn inicia el flujo un día antes de la llegada. Con 0 empieza en la propia fecha. Una fecha sin hora cuenta como medianoche.
Con Hora eliges en qué momento de ese día empieza el flujo. La hora de la fecha usa el momento que figura en el campo, como la hora de llegada de una reserva. Hora fija del día empieza el día de la fecha a la hora y el minuto que elijas, en la zona horaria de tu organización. Así, contact.birthday con Repetir cada año empieza cada año a las 09:00 en el cumpleaños. Cuánto tiempo cuenta entonces desde esa hora: 1 día y Antes empieza el día anterior a las 09:00, aunque esa noche cambie la hora del reloj.
Para cada registro empieza una ejecución propia, con los datos de ese registro como variables, por ejemplo {reservation.displayId} y {reservation.customer.firstName}. Con Solo cuando lo limitas, por ejemplo a reservas con estado confirmado.
Así funciona además:
- Por registro y por momento, el flujo empieza una vez. Si la fecha se desplaza a más tarde, por ejemplo porque un huésped llega más tarde, vuelve a empezar en el nuevo momento
- Si el momento ya había pasado cuando guardaste o activaste la automatización, ya no empieza por él
- Los momentos perdidos, por ejemplo durante un mantenimiento, Tillor los recupera hasta una hora después
Cada día a una hora
En Hora elige una hora (de 0 a 23) y en Minuto un minuto de 0 a 59. La hora es la de la zona horaria de tu organización.
Los pasos reciben {now}: el momento en que empezó la ejecución.
Según una expresión cron
Elige un ritmo, como cada día, cada lunes a las 08:00 o los lunes impares (el 1.º, 3.º y 5.º). En Personalizado configuras el intervalo, los días de la semana y la hora, hasta el minuto. En Expresión cron escribes tú mismo el horario.
Una expresión cron es una notación corta para una hora repetida. Tiene cinco partes, separadas por un espacio: minuto, hora, día del mes, mes y día de la semana.
| Expresión | Significado |
|---|---|
0 8 * * 1 | Cada lunes a las 08:00 |
7 8 * * 1 | Cada lunes a las 08:07 |
30 7 * * 1-5 | Cada día laborable a las 07:30 |
0 9 1 * * | El primero de cada mes a las 09:00 |
0 8 * * 1#1,1#3,1#5 | Cada lunes impar (1.º, 3.º y 5.º del mes) a las 08:00 |
0 8 * * 1L | El último lunes del mes a las 08:00 |
0 8 * * 1 W2:2026-10-05 | Cada dos semanas en lunes a las 08:00, desde la semana del 5 de octubre de 2026 |
*/15 * * * * | Cada cuarto de hora |
* * * * * | Cada minuto |
En cada parte puedes usar un número, una lista con comas (8,17), un rango (1-5), un paso (*/15) o un asterisco (*, cualquier valor). El día de la semana 0 y 7 son ambos domingo. 1#2 es el segundo lunes, 1L el último. Un sexto campo W2:2026-10-05 repite cada dos semanas, contadas desde esa semana. Nombres como MON o JAN no funcionan. Si rellenas tanto un día del mes como un día de la semana, la automatización empieza en uno de los dos.
Si la expresión no es válida, Tillor lo indica en el disparador. Las horas valen en la zona horaria de tu organización.
A qué hora empieza exactamente un horario
Un horario empieza en el minuto en que le toca
Tillor comprueba cada minuto qué horarios le tocan. Una automatización que debe empezar a las 08:07 empieza en ese minuto. Esto vale para Factura vencida, Se alcanza una fecha, Cada día a una hora y Según una expresión cron.
Por minuto, un horario empieza como máximo una vez. Una comprobación que se ejecuta recién en el minuto siguiente ya no recupera el minuto anterior.
Los eventos empiezan de inmediato, sin este retraso.
Solo cuando
Con Solo cuando haces que la automatización empiece únicamente si los datos cuadran. Así empiezas, por ejemplo, solo para caravanas estáticas, o solo para facturas por encima de un importe. Déjalo vacío para empezar en cada evento de este tipo.
- Haz clic en Añadir condición
- Elige el campo con el botón Variable (o escribe la ruta, por ejemplo
invoice.status) - Elige cómo comparar
- Rellena el valor. En campos con una elección fija, como un estado, un tipo de parcela o un compañero, eliges de una lista
Puedes usar las siguientes comparaciones:
| Opción | Se cumple cuando |
|---|---|
| es | El campo es igual al valor |
| no es | El campo no es igual al valor |
| contiene | El valor aparece en algún lugar del campo |
| es mayor que | El campo es mayor que el valor (en números y fechas) |
| es menor que | El campo es menor que el valor (en números y fechas) |
| es uno de | El campo es igual a uno de los valores elegidos |
| está vacío | El campo está vacío |
| no está vacío | El campo no está vacío |
Las mayúsculas no importan. Los números se comparan como números, así que 10 es mayor que 9.
Si tienes más de una condición, eliges cómo se combinan: Deben cumplirse todas o Basta con que se cumpla una.
Los eventos que detiene el filtro no inician ninguna ejecución y, por tanto, tampoco dejan rastro en la pestaña Ejecuciones. Si quieres ver si tu filtro es correcto, usa la Ejecución de prueba: ahí ves por cada condición si se cumplió.
Ejecutar una vez por registro
Con Ejecutar una vez por registro, la automatización empieza como máximo una vez por factura, reserva u otro registro, por muchas veces que ocurra el evento para él.
Es útil sobre todo con eventos que se repiten a menudo, como invoice:updated: una factura se modifica decenas de veces, pero solo quieres enviar un recordatorio. Tillor recuerda por registro que la automatización ya ha empezado. Ese recuerdo desaparece si eliminas la automatización.
Solo funciona con eventos que llevan asociado un registro, y con Factura vencida y Se alcanza una fecha. Con Se alcanza una fecha significa: aunque la fecha se desplace más tarde, el flujo no vuelve a empezar. Con un horario como Cada día a una hora no tiene efecto.
¿Qué ocurre después?
- Cada vez que se produce el momento de inicio y el filtro se cumple, empieza una ejecución con los datos de ese momento como variables.
- Un evento empieza de inmediato. Una fecha, una hora o un horario empieza en el minuto en que le toca.
- Si el filtro no encaja, no empieza nada y no queda rastro en la pestaña Ejecuciones.