Déclencheurs — comment un objet entre dans un processus

Où trouver les déclencheurs d'un processus ? #

Dans le module Workflow, ouvrez le dessin du processus, puis cliquez sur le bouton Déclencheurs en haut de l'écran. Un volet Déclencheurs d'entrée s'ouvre sur la droite et décrit comment un objet entre dans ce processus. Échap le ferme.

Le volet présente trois blocs :

• l'Événement interne, actif dès que le processus est activé ;
• les Webhooks entrants, pour qu'un logiciel externe ouvre ou fasse avancer un suivi ;
• la Planification, annoncée à venir — elle n'est pas disponible aujourd'hui.

Comment un objet entre-t-il tout seul dans le processus ? #

Dans le module Workflow, le bloc Événement interne du volet Déclencheurs décrit le fonctionnement par défaut : tout processus activé observe sa famille.

• Un suivi s'ouvre dès qu'un objet de la famille est créé.
• Il avance à chaque changement d'un champ liste référencé par une étape du dessin.
• Si le processus est restreint à un pipeline, seuls les objets de ce pipeline sont observés.

Le bloc affiche En observation quand le processus est actif, et Inactif quand il est en brouillon — dans ce cas, rien n'est observé tant que le processus n'est pas activé.

Comment permettre à un logiciel externe d'ouvrir ou de faire avancer un suivi ? #

Dans le module Workflow, un webhook entrant donne à un logiciel externe une adresse à appeler pour agir sur un suivi. Depuis le dessin du processus, bouton Déclencheurs, bloc Webhook entrant :

1. Cliquez sur Ajouter un webhook.
2. Saisissez un Libellé (par exemple « ERP — commandes »).
3. Indiquez le Chemin dans la charge utile — en notation pointée, par exemple payload.reference. C'est la valeur qui identifiera l'objet.
4. Choisissez le champ de rapprochement : le suivi s'ouvrira sur l'objet dont ce champ porte la valeur reçue. Seuls les champs texte ou nombre de la famille sont proposés.
5. Facultatif — ajoutez des Valeurs à recopier : chaque ligne associe un Alias et un Chemin dans la charge utile.
6. Cliquez sur Créer le webhook.

Une fenêtre affiche alors l'Adresse et le Secret partagé à donner au logiciel appelant, avec le format de signature attendu. Copiez-les immédiatement : ils ne sont affichés qu'une seule fois.

⚠️ Pour qu'un appel fasse avancer le suivi, l'alias d'une valeur recopiée doit porter le code du champ liste référencé par une étape du dessin. Les autres alias sont ignorés. L'écran vous propose la liste des codes référencés par le dessin.

Que faire si j'ai perdu le secret d'un webhook ? #

Dans le module Workflow, le secret d'un webhook n'est jamais réaffiché après sa création. La seule issue est de le régénérer :

1. Ouvrez le dessin du processus, puis le volet Déclencheurs.
2. Sur le webhook concerné, cliquez sur Régénérer.
3. Confirmez, puis copiez le nouveau secret dans la fenêtre qui s'affiche.

L'ancien secret cesse de fonctionner immédiatement : le logiciel appelant doit basculer sur le nouveau avant son prochain appel. L'adresse ne change pas : réutilisez celle donnée à la création. L'adresse non plus n'est pas récupérable depuis cet écran.

Comment arrêter un webhook devenu inutile ? #

Dans le module Workflow, ouvrez le dessin du processus, puis le volet Déclencheurs, et cliquez sur Révoquer sur le webhook concerné.

L'adresse cesse de répondre. Le webhook reste listé, marqué Révoqué avec sa date, pour garder la trace de ce qui a existé. Un appel sur un webhook révoqué est refusé ; créez-en un nouveau si le besoin revient.

Le nombre de webhooks actifs par processus est limité : l'écran affiche « Actifs : N / M ». Si la limite est atteinte, révoquez-en un avant d'en créer un autre.

Comment savoir ce qu'un appel entrant a vraiment fait ? #

Dans le module Workflow, le volet Déclencheurs affiche la date du dernier appel reçu, mais il ne dit pas si cet appel a été appliqué : la ligne parle d'un accusé de réception et renvoie au journal du suivi. C'est volontaire — un appel reçu n'est pas un appel appliqué.

Ouvrez le journal du suivi pour connaître l'issue réelle, qui est l'une des deux :

• Webhook appliqué — les champs écrits sont nommés, ainsi que les valeurs ignorées, celles que le dessin ne regarde pas.
• Webhook refusé — avec son motif en clair : sortie bloquée par des champs requis manquants, condition non remplie (le verdict réel et la branche demandée sont donnés), valeur refusée par l'objet, ou objet introuvable.

Quand un appel est refusé, rien ne bouge : ni l'objet, ni le suivi.

Pourquoi mes webhooks ne font-ils rien ? #

Dans le module Workflow, la cause la plus fréquente est que le processus est en brouillon. Le volet Déclencheurs l'affiche en clair : « Processus en brouillon : webhooks inertes ». Un appel reçu est accusé mais n'ouvre aucun suivi tant que le processus n'est pas activé.

Les autres causes à vérifier :

• le webhook a été révoqué ;
• le secret a été régénéré et le logiciel appelant utilise encore l'ancien ;
• la signature est fausse ou périmée — elle a une durée de validité courte ;
• la valeur lue au chemin indiqué ne correspond à aucun objet de la famille ;
• l'alias d'une valeur recopiée ne porte pas le code du champ liste référencé par le dessin : la valeur est alors ignorée.

Le bouton Envoyer un appel de test est affiché mais pas encore disponible : il est annoncé pour une version ultérieure.

Puis-je programmer l'entrée dans un processus à date fixe ? #

Pas aujourd'hui. Dans le module Workflow, le volet Déclencheurs montre un bloc Planification — « À date fixe, ou tous les X jours » — marqué À venir. Il annonce une fonction prévue pour une version ultérieure ; elle n'est pas utilisable pour le moment.

En attendant, un objet entre dans un processus par l'événement interne (création de l'objet, changement du champ référencé) ou par un appel entrant.