Conditions, aiguillages et délais

Avec les étapes du groupe Logique, vous décidez dans quelle direction un flux va et quand : le « si » et le « attends un peu ». Par exemple : si la facture est toujours impayée après une semaine, créez une tâche. Elles pilotent les actions qui suivent. Seule l'étape Demander une décision crée elle-même quelque chose, une tâche.

Si / sinonCopier le lien vers cette section

Sépare le flux en deux chemins selon les données. Le principe est le même que le filtre Uniquement si du déclencheur, mais au milieu du flux.

L'étape a deux sorties : Oui (les conditions sont remplies) et Non (elles ne le sont pas).

1. Ajoutez une étape Si / sinon
2. Sous Conditions, cliquez sur Ajouter une condition
3. Choisissez le champ avec le bouton Variable, ou saisissez vous-même le chemin, par exemple invoice.paymentStatus
4. Choisissez la comparaison (est, n'est pas, contient, est supérieur à, est inférieur à, est l'un de, est vide ou n'est pas vide) et saisissez la valeur
5. Reliez la sortie Oui et éventuellement Non à une étape suivante

Une étape Si / sinon a besoin d'au moins une condition. Sinon, Tillor affiche Ajoutez une condition. Avec plusieurs conditions, vous choisissez entre Toutes doivent correspondre et Au moins une doit correspondre. Les comparaisons fonctionnent comme décrit sous Uniquement si.

Vous n'êtes pas obligé de relier les deux sorties. Si une sortie ne mène nulle part, l'exécution se termine à cet endroit. Un flux qui ne fait quelque chose que sur Oui convient donc parfaitement.

Vous pouvez aussi utiliser les champs des étapes précédentes. Après une Requête API, vous pouvez par exemple regarder response.status ou response.data.paymentStatus.

AiguillageCopier le lien vers cette section

Choisissez Aiguillage quand il vous faut plus de deux chemins. L'étape regarde la valeur d'un seul champ et choisit la branche correspondante.

1. Sous Champ, choisissez le champ à examiner, par exemple occupation.occupationType
2. Sous Branches, cliquez sur Ajouter une branche. Saisissez la Branche (le nom qui apparaîtra sur la sortie) et Égal à (la valeur que le champ doit avoir)
3. Répétez l'opération pour chaque branche
4. Reliez chaque sortie à une étape suivante

Chaque branche reçoit sa propre sortie sous l'étape. Il y a en plus toujours une sortie Par défaut, utilisée quand aucune branche ne correspond.

• Le champ doit correspondre exactement à la valeur, majuscules comprises
• Si plusieurs branches correspondent, la première de la liste l'emporte
• Une branche sans valeur sous Égal à n'est pas prise en compte
• Vous pouvez configurer au maximum 8 branches, plus Par défaut
• Si le champ est vide ou n'existe pas, le flux passe par Par défaut

Les valeurs des champs à choix sont écrites selon la notation de Tillor. Une occupation de type caravane de location a par exemple la valeur RENTAL_CARAVAN, une facture payée PAID.

DélaiCopier le lien vers cette section

Avec Délai, vous faites attendre le flux avant qu'il continue. Vous l'utilisez pour des choses comme revérifier une semaine plus tard.

Sous Attendre, vous choisissez l'une des deux manières.

Pendant une durée fixeCopier le lien vers cette section

Choisissez Pendant une durée fixe et saisissez sous Durée un nombre et une unité : secondes, minutes, heures, jours ou semaines. Les secondes ne sont pas exactes. Le flux peut continuer quelques secondes plus tard.

Un délai de 0 ne fait rien, c'est pourquoi Tillor affiche Un délai de 0 ne fait rien.

Jusqu'à une dateCopier le lien vers cette section

Choisissez Jusqu'à une date quand la durée d'attente dépend d'une date issue des données, comme l'échéance d'une facture ou la date de fin d'une réservation.

Exemples :

• Date invoice.dueDate, Après, Décalage 1 jour : le flux continue un jour après l'échéance
• Date reservation.checkIn, Avant, Décalage 2 jours : le flux continue deux jours avant l'arrivée

Si ce moment est déjà passé, ou si la date est vide, le flux continue immédiatement.

Ce qui se passe pendant l'attenteCopier le lien vers cette section

• L'exécution prend le statut En attente. Dans l'onglet Exécutions, vous voyez quand elle reprend (Reprend …). Les longues attentes, comme des semaines, ne posent aucun problème
• Après le délai, Tillor relit les données, de sorte que les étapes suivantes voient l'état actuel. Voir ci-dessous
• Si vous mettez l'automatisation en pause pendant l'attente, l'exécution s'arrête dès que le temps d'attente est écoulé. Elle ne continue pas et prend le statut Annulée. Si vous réactivez l'automatisation avant la fin du temps d'attente, l'exécution continue normalement
• Si vous supprimez l'automatisation, les exécutions en attente s'arrêtent
• Si vous modifiez le flux pendant qu'une exécution attend, cette exécution se termine avec le flux tel qu'il était à son démarrage

Les données sont reluesCopier le lien vers cette section

Une exécution retient les données du moment de l'événement, mais relit les enregistrements associés avant de continuer. Il s'agit de l'enregistrement de l'événement (par exemple la facture) et des enregistrements auxquels il renvoie (par exemple le client).

Un exemple : une automatisation envoie une relance pour une facture, attend 7 jours, puis vérifie avec Si / sinon que invoice.paymentStatus n'est pas PAID. Si la facture a été payée dans la semaine, la condition voit la facture payée et le flux passe par Non.

Il y a deux exceptions :

• Si l'enregistrement n'existe plus, par exemple parce qu'une occupation a été supprimée, l'exécution garde la copie du moment de l'événement
• Les données produites par une étape précédente, comme la réponse d'une requête API, ne sont pas récupérées à nouveau. Si vous voulez ces données actualisées après un délai, faites une nouvelle requête API

Ouvert maintenant ?Copier le lien vers cette section

Vérifie si votre organisation est ouverte en ce moment et sépare le flux en Ouvert et Fermé. Il n'y a rien à configurer. Tillor utilise les heures sous Paramètres > Heures d'ouverture, avec les périodes saisonnières, les jours fériés et les exceptions. Voir Paramètres de l'organisation.

Utilisez-la par exemple pour envoyer un autre texte ou créer une tâche en dehors des heures d'ouverture. Si vous préférez attendre d'être de nouveau ouvert, utilisez Attendre l'ouverture. Si vous voulez attendre jusqu'à la fermeture, utilisez Attendre la fermeture.

Attendre l'ouvertureCopier le lien vers cette section

Met le flux en pause jusqu'à la prochaine heure d'ouverture, puis il continue. Votre organisation est déjà ouverte ? Alors le flux continue immédiatement. Il n'y a rien à configurer.

• L'heure d'ouverture provient de Paramètres > Heures d'ouverture, dans le fuseau horaire de votre organisation
• S'il n'y a aucune heure d'ouverture dans le mois à venir, le flux continue immédiatement au lieu de rester en attente
• Pendant l'attente, l'exécution prend le statut En attente. Ce qui se passe alors est décrit sous Délai

Attendre la fermetureCopier le lien vers cette section

Met le flux en pause jusqu'à la prochaine heure de fermeture, puis il continue. Votre organisation est déjà fermée ? Alors le flux continue immédiatement. Il n'y a rien à configurer.

• L'heure de fermeture provient de Paramètres > Heures d'ouverture, dans le fuseau horaire de votre organisation
• Les plages qui se suivent, comme 9:00–12:00 et 12:00–17:00, comptent pour un seul bloc. Le flux attend la fin de ce bloc
• Pendant l'attente, l'exécution prend le statut En attente. Ce qui se passe alors est décrit sous Délai

Au plus une fois par périodeCopier le lien vers cette section

Ne laisse passer le flux que s'il n'a pas déjà franchi cette étape pour le même enregistrement pendant la période. Ainsi, vous n'envoyez pas chaque jour la même relance à un client.

L'étape a deux sorties : Continuer si le flux n'est pas encore passé par là pendant la période, et Déjà exécuté si c'est le cas. Reliez Déjà exécuté à une autre étape, ou laissez-la vide pour que l'exécution se termine à cet endroit.

À noter :

• Seules les exécutions de la même automatisation comptent, et uniquement si elles ont franchi cette étape par Continuer
• Si vous ne reliez pas Supprimé à quelque chose, Tillor arrête les flux en attente de cet enregistrement et supprime les tâches que le flux a créées et que seul le flux pouvait terminer. Si vous reliez la sortie, le flux continue à cet endroit
• Si le flux démarre sans enregistrement, par exemple avec Chaque jour à une heure, saisissez vous-même une variable sous Par. Sans cette valeur, chaque exécution est nouvelle et l'étape n'empêche rien
• L'exécution en cours ne compte pas elle-même

Un exemple : Période 7 jours et Par {invoice.customerId} ne laisse passer qu'une relance par semaine au plus pour chaque client, même si ce client a plusieurs factures échues.

Rechercher un enregistrementCopier le lien vers cette section

Charge un enregistrement à partir de son identifiant, afin que les étapes suivantes puissent utiliser ses champs. C'est pratique quand l'événement ne fournit qu'un identifiant, comme le message dans une conversation de la boîte de réception.

L'étape a deux sorties : Trouvée et Introuvable. Si l'enregistrement n'existe pas ou si l'identifiant est vide, le flux passe par Introuvable.

Après Trouvée, les champs de l'enregistrement se trouvent dans des variables qui commencent par found suivi du type : {foundCustomer.firstName}, {foundInvoice.displayId}, {foundReservation.checkIn}, {foundTerrain.name}, {foundInboxMessage.direction}. Les autres types s'appellent foundOccupation, foundPayment, foundTask, foundAccessMethod, foundNfcTag, foundMeter et foundInboxThread. Les enregistrements auxquels il renvoie y figurent aussi, sur un niveau de profondeur, comme {foundReservation.customer.firstName}. Tout se trouve dans la liste derrière le bouton Variable.

Une deuxième recherche du même type remplace la première. Attention pour Tâche : elle utilise le même nom foundTask que Rechercher une tâche, et la dernière des deux l'emporte. Il en va de même pour Document et foundDocument de Rechercher un document.

Mapper des variablesCopier le lien vers cette section

Copie des valeurs vers de nouveaux noms de variables, afin que les étapes suivantes puissent utiliser une seule forme. C'est pratique quand un même flux démarre par Webhook entrant ({body.…}) et par Facture échue ({invoice.…}).

L'étape a une seule sortie : Suivant. Si la source est exactement une variable entre accolades, par exemple {foundInvoice}, Tillor copie l'enregistrement entier (objet). Sinon, Tillor remplit la source comme du texte, comme Facture {foundInvoice.displayId} dans meta.label.

Test de webhook moyen : Webhook entrant → Rechercher un enregistrement (Facture, identifiant {body.invoiceId}) → Mapper des variables (invoice ← {foundInvoice}) → les mêmes conditions et la même approbation que pour le déclencheur de planification.

Exécuter du codeCopier le lien vers cette section

Exécute un morceau de TypeScript sur les variables du flux et conserve ce qu'il renvoie dans une nouvelle variable. Pour la logique que vous ne pouvez pas exprimer avec des champs et des conditions : quelles sous-tâches créer, calculer un montant ou une date, remodeler un corps de webhook.

L'étape a une seule sortie : Suivant. Voici comment cela fonctionne :

• Le code ne voit que les variables qu'il nomme. Une variable que le flux n'a pas vaut null ; une date arrive sous forme de texte (2026-07-01T10:00:00.000Z)
• Les formats et décalages de dates ({bedrag|currency}, {datum + 1 day}) ne fonctionnent pas ici : calculez-les dans le code
• Renvoyez une liste, un texte, un nombre ou un objet. Vous lisez ensuite un objet champ par champ : {result.total}
• Le code ne peut rien récupérer ni envoyer : pas d'internet, pas de base de données. Il se contente de calculer. Un calcul trop long (plus de 50 ms) est interrompu
• Si le code lève une erreur, l'exécution s'arrête avec cette erreur et le numéro de ligne. Vous les voyez dans l'onglet Exécutions
• À droite du code, vous voyez tout de suite ce qu'il renvoie sur l'exemple ; lors du test, il s'exécute aussi

Un exemple : après un départ, vous voulez des sous-tâches qui dépendent du terrain. Placez une étape Exécuter du code avec :

const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;

Remplissez ensuite, dans Créer une tâche, le champ Sous-tâches avec uniquement {result} : chaque texte de la liste devient une sous-tâche.

Pour chaqueCopier le lien vers cette section

Exécute les étapes après Pour chaque une fois pour chaque élément d'une liste, par exemple pour chaque facture impayée d'un client. Le flux lui-même continue par Terminé.

L'étape a deux sorties qui ont chacune leur sens :

• Pour chaque mène aux étapes que vous voulez faire pour chaque élément
• Terminé est la façon dont le flux lui-même continue

Voici comment cela fonctionne :

• Chaque élément reçoit sa propre exécution, qui parcourt les étapes après Pour chaque jusqu'à la fin de cette branche. Vous les voyez dans l'onglet Exécutions, qui n'affiche que les 20 dernières
• L'élément se trouve dans la variable item, par exemple {item.id}. Les variables de l'événement et des étapes précédentes restent disponibles
• Le flux n'attend pas que les éléments soient terminés. Dès qu'ils sont lancés, il continue par Terminé. Vous ne pouvez donc pas utiliser le résultat d'un élément dans les étapes après Terminé
• Au maximum 100 éléments sont traités, les plus anciens d'abord. S'il y en a davantage dans la liste, les autres ne sont pas traités
• Si la liste est vide ou si le champ De est vide, rien ne démarre et le flux continue immédiatement par Terminé
• Les Factures impayées d'un client sont des factures comptabilisées dont il reste quelque chose à payer. Les Réservations à venir d'un client sont des réservations avec le statut Réservé

Un exemple : une facture arrive à échéance et vous voulez créer un lien de paiement pour chaque facture impayée de ce client. Choisissez Factures impayées d'un client, saisissez {invoice.customerId} sous De et placez après Pour chaque une étape Créer un lien de paiement avec {item.id} comme facture.

Attendre jusqu'àCopier le lien vers cette section

Vérifie des conditions encore et encore jusqu'à ce qu'elles soient remplies, ou s'arrête après un certain temps. Utilisez-la quand vous ne savez pas quand quelque chose se produira mais que vous savez ce que vous attendez, par exemple qu'une facture soit payée.

L'étape a deux sorties : Rempli (les conditions sont remplies) et Délai dépassé (le temps d'attente est écoulé sans que les conditions le soient).

À noter :

• La première vérification a lieu immédiatement. Si les conditions sont déjà remplies, le flux continue directement par Rempli. Si vous n'avez saisi aucune condition, elle est toujours remplie
• À chaque vérification, Tillor relit les enregistrements de l'événement, comme pour un délai. Une condition comme invoice.paymentStatus est PAID voit donc le paiement dès qu'il est là
• Un intervalle inférieur à 5 minutes devient 5 minutes
• Pendant l'attente, l'exécution prend le statut En attente. Pour la mise en pause et la modification du flux, la même chose s'applique que pour Délai

Attendre un événementCopier le lien vers cette section

Met le flux en pause jusqu'à ce qu'il se passe quelque chose dans Tillor, par exemple que la facture soit payée.

L'étape a deux sorties : Reçu (l'événement est arrivé) et Délai dépassé (le temps d'attente est écoulé sans événement). Si Uniquement pour le même enregistrement est activé, une troisième sortie s'ajoute, Supprimé. Vous l'utilisez quand l'enregistrement du flux a été supprimé pendant que le flux attendait.

À noter :

• Avec Uniquement pour le même enregistrement activé, seul compte par exemple le paiement de la facture avec laquelle le flux a démarré. Si vous le désactivez, chaque événement de ce type fait continuer le flux
• Si vous ne reliez pas Supprimé à quelque chose, Tillor arrête les flux en attente de cet enregistrement et supprime les tâches que le flux a créées et que seul le flux pouvait terminer. Si vous reliez la sortie, le flux continue à cet endroit
• Si le flux démarre sans enregistrement, par exemple avec Chaque jour à une heure, chaque événement de ce type compte
• Un événement qu'une étape d'une automatisation provoque elle-même compte aussi. Les flux en attente continuent donc aussi grâce au travail de Flux de travail
• Après Reçu, les données de l'événement que vous attendiez se trouvent dans les variables, sans le collègue qui l'a provoqué. Si vous attendez invoice:paid, {invoice.paymentStatus} donne ensuite le nouvel état
• Pendant l'attente, l'exécution prend le statut En attente. Pour la mise en pause et la modification du flux, la même chose s'applique que pour Délai

Demander une décisionCopier le lien vers cette section

Crée une tâche avec des boutons que vous définissez vous-même, et attend que quelqu'un choisisse un bouton. Vous prévoyez ainsi un moment où un humain vérifie, par exemple avant que le flux bloque un client ou comptabilise une facture. Chaque option est un bouton sur la tâche et une sortie de l'étape.

Configurer les optionsCopier le lien vers cette section

1. Sous Options, cliquez sur Ajouter une option et saisissez le nom, par exemple Approuver. Ce nom figure sur le bouton et sur la sortie
2. Cliquez sur la petite case colorée à gauche du nom (Icône et couleur) pour choisir une couleur et une icône. Une icône n'est pas obligatoire
3. Activez Demander une note si le collègue doit indiquer une raison pour ce choix
4. Activez Demander une confirmation si le collègue doit d'abord confirmer. Vous saisissez alors un Titre de confirmation et un Message de confirmation, et vous choisissez sous Gravité entre Info, Avertissement ou Destructif. Vous pouvez utiliser des variables dans ces textes
5. Répétez l'opération pour chaque option. Vous pouvez créer au maximum 8 options

Si la liste est encore vide, le bouton Approuver / Refuser prépare tout de suite deux options : un Approuver vert et un Refuser rouge. Chaque option a besoin d'un nom, sinon Tillor affiche Chaque option a besoin d’un nom. Sans options, Tillor affiche Ajoutez au moins une option.

SortiesCopier le lien vers cette section

L'étape a une sortie par option, avec le nom et la couleur de cette option, plus toujours Délai dépassé.

À noter :

• Les boutons figurent sur la carte de la tâche, dans la liste des tâches et dans la tâche elle-même. Une telle tâche n'a pas de case à cocher : vous ne pouvez pas simplement la terminer, seulement choisir un bouton. Après le choix, la tâche passe à Terminée et indique quelle option a été choisie. Voir Tâches avec boutons de choix
• Peut choisir toute personne assignée à la tâche, y compris via un groupe, ainsi que les administrateurs. Si vous n'assignez personne, toute personne qui voit la tâche peut choisir
• La tâche reçoit la priorité Élevé. Elle est au nom de Flux de travail
• Si la tâche est supprimée avant que quelqu'un ait choisi, le flux continue par Délai dépassé. Après Délai dépassé à cause du temps d'attente, la tâche reste en place
• Les étapes suivantes peuvent utiliser {approvalTask.id}, {approval.decision}, {approval.label}, {approval.note} et {approval.decidedBy.name}. {approval.label} est le nom de l'option choisie et {approval.note} la note saisie par le collègue
• Pendant l'attente, l'exécution prend le statut En attente. Pour la mise en pause et la modification du flux, la même chose s'applique que pour Délai

Que se passe-t-il ensuite ?Copier le lien vers cette section

• Une sortie que vous ne reliez pas fait se terminer l'exécution à cet endroit.
• Pour une étape d'attente, l'exécution prend le statut En attente et continue plus tard. Une automatisation en pause arrête les exécutions en attente dès que le temps d'attente est écoulé.
• Après un temps d'attente, Tillor relit les données, de sorte que les étapes voient l'état actuel.

Un problème ?Copier le lien vers cette section