Les connecteurs Robin permettent d'interagir directement avec les données et objets de la plateforme — actifs, formulaires, appareils IoT — depuis un workflow. Ils se divisent en deux catégories : les déclencheurs (triggers) qui initient le workflow, et les actions qui s'exécutent en réponse.
Version requise : les connecteurs et options signalés par 🆕 (version 2026.6) nécessitent Robin 2026.6 ou ultérieure. Ils ne sont pas disponibles sur une version antérieure.
¶ Déclencheurs
¶ Asset Modified
Rôle : Déclenche le workflow dès qu'un actif est créé, modifié ou archivé dans Robin.
Configuration
- Sélectionner le type d'actif concerné : seules les modifications sur ce type déclencheront le workflow.
- Sélectionner un actif spécifique (optionnel) : laisser vide pour déclencher sur tous les actifs du type.
- 🆕 Sélectionner les Fields to watch (obligatoire, au moins un champ) : le workflow ne se déclenche que si au moins l'un des champs sélectionnés est modifié. La liste contient les champs du type d'actif, ainsi que
position(localisation) etarchived(statut d'archivage) et, pour les types ordre et tâche,precedence(etroutingpour les types tâche).
Ce connecteur est particulièrement utile pour réagir en temps réel à un changement d'état métier, par exemple pour mettre à jour un bon de travail côté ERP dès qu'une phase de maintenance change de statut, ou pour alerter un responsable qualité lors de la modification d'un lot en cours de fabrication. Il renvoi la date de modification, les champs actuels de l'actifs, et, pour les champs modifiés leur valeur précédente.
🆕 Disponible à partir de la version 2026.6 de Robin : le filtre Fields to watch et les données supplémentaires ci-dessous n'existent pas sur les versions antérieures.
Données supplémentaires renvoyées (2026.6+)
archived: statut d'archivage courant de l'actif.position: localisation courante (latitude,longitude,altitude;altitudepeut être nulle si l'information n'est pas disponible).- Pour les types ordre et tâche :
precedence(liste desasset_iddes ordres/tâches prédécesseurs). - Pour les types tâche :
routing(gamme de la tâche : stock et ressources).
Lorsque l'un de ces éléments (archived, position, precedence, routing) fait partie des modifications, il apparaît aussi dans changes, avec la même structure que les autres champs :
{
"asset_id": "A12345",
"update_date": "2026-05-26T22:31:53Z",
"archived": true,
"position": { "latitude": 48.8570, "longitude": 2.3530, "altitude": 36.0 },
"fields": { "text_1": "lorem ipsum", "num_2": 10 },
"changes": {
"archived": { "previous_value": false, "new_value": true },
"position": {
"previous_value": { "latitude": 48.8566, "longitude": 2.3522, "altitude": 35.2 },
"new_value": { "latitude": 48.8570, "longitude": 2.3530, "altitude": 36.0 }
}
}
}
¶ Form Submitted
Rôle : Déclenche le workflow lorsqu'un formulaire Robin est soumis par un opérateur.
Prérequis : le widget formulaire concerné doit avoir l'option "Déclencher les flux à la soumission" activée côté Robin.
Configuration
Sélectionner le formulaire ciblé dans la liste des formulaires avec le trigger activé.
Ce connecteur permet de brancher un processus automatisé directement sur une action opérateur, par exemple pour lancer une tâche de contrôle qualité dès la soumission d'un formulaire de fin d'inspection, ou pour créer un actif de traçabilité à la validation d'un formulaire de pesée en début de batch. Il renvoi l'actif créé ou édité par le formulaire, avec tous ses champs ainsi que la date de soumission.
¶ Geofencing Event
Rôle : Déclenche le workflow lorsqu'un appareil IoT génère un événement de geofencing, c'est-à-dire lorsqu'un équipement suivi entre dans une zone de geofencing configurée ou en sort.
🆕 Disponible à partir de la version 2026.6 de Robin. Cette fonctionnalité n'est pas disponible sur les versions antérieures.
Configuration
- Sélectionner les zones de geofencing à surveiller (optionnel) : liste à choix multiple affichant le nom des zones. Laisser vide pour déclencher sur toutes les zones configurées, à l'exception des zones de type BLE Snapping (jamais proposées ni prises en compte).
Seuls les appareils provisionnés sur le secteur client rattaché à la connexion du workflow déclenchent le flux ; les événements d'un autre secteur sont ignorés. Le connecteur se déclenche une fois par événement correspondant à la configuration.
Données renvoyées
| Champ | Type | Description |
|---|---|---|
device_uid |
texte | UID de l'appareil à l'origine de l'événement. |
device_serial |
texte | Numéro de série de l'appareil. |
geofencing_id |
texte | Identifiant de la zone de geofencing concernée. |
geofencing_name |
texte | Nom de la zone de geofencing concernée. |
paired_asset_ids |
liste de textes | Identifiants des actifs associés à l'appareil au moment de l'événement (liste vide si aucun actif n'est associé). |
{
"device_uid": "001BC50C7100A513",
"device_serial": "WZL-123456",
"geofencing_id": "geo_42",
"geofencing_name": "Warehouse Entrance",
"paired_asset_ids": ["asset_123", "asset_456"]
}
Ce connecteur permet de réagir automatiquement aux déplacements d'équipements, par exemple pour prévenir le magasin outillage lorsqu'un outil MRO équipé d'un tag entre dans la zone atelier, ou pour mettre à jour un actif dès qu'un chariot quitte une ligne de production cosmétique.
¶ Device Button Press
Rôle : Déclenche le workflow lorsqu'un appui sur un bouton est détecté sur un appareil IoT.
🆕 Disponible à partir de la version 2026.6 de Robin. Cette fonctionnalité n'est pas disponible sur les versions antérieures.
Configuration
- Choisir le mode de sélection des appareils (obligatoire) :
uidouserial. Il détermine si la liste des appareils affiche et enregistre l'UID ou le numéro de série. - Sélectionner les appareils à surveiller (optionnel) : liste à choix multiple des appareils provisionnés compatibles avec les événements bouton. Laisser vide pour déclencher sur tous les appareils compatibles du secteur client.
Seuls les appareils provisionnés sur le secteur client rattaché à la connexion du workflow déclenchent le flux. Les appareils à un ou plusieurs boutons sont pris en charge.
Données renvoyées
| Champ | Type | Description |
|---|---|---|
device_uid |
texte | UID de l'appareil. |
device_serial |
texte | Numéro de série de l'appareil. |
paired_asset_ids |
liste de textes | Identifiants des actifs associés à l'appareil au moment de l'appui (liste vide si aucun actif n'est associé). |
press_duration |
short, medium ou long |
Durée de l'appui. |
button_position |
top, bottom, left ou right |
Bouton utilisé ; top pour les appareils à un seul bouton. |
{
"device_uid": "001BC50C7100A513",
"device_serial": "BTN-000123",
"paired_asset_ids": ["asset_123", "asset_456"],
"press_duration": "short",
"button_position": "top"
}
Ce connecteur permet de brancher un workflow sur une interaction physique, par exemple pour déclarer un problème sur un poste de travail par un appui long sur un tag, ou pour signaler qu'un bac est prêt à être collecté par un appui court.
¶ Actions Robin
Note commune aux actions Robin : les champs marqués en rouge dans le panneau de configuration sont obligatoires. Les options Continue on Failure et Retry on Failure (jusqu'à 4 tentatives) sont disponibles sur toutes les actions et permettent de gérer la résilience du workflow en cas d'erreur ponctuelle (timeout, donnée manquante, etc.).
¶ Create Asset
Rôle : Crée un nouvel actif Robin d'un type donné, avec la possibilité de renseigner directement ses champs à la création.
Configuration
- Sélectionner le type d'actif à créer.
- Renseigner un Custom ID : obligatoire si le type d'actif n'est pas configuré en auto-incrément, optionnel sinon.
- Renseigner les champs de l'actif, organisés par type :
- Text fields : valeurs texte.
- Number fields : valeurs numériques.
- Date fields : valeurs de date et heure, saisies via le sélecteur natif ou en ISO8601 (voir https://en.wikipedia.org/wiki/ISO_8601).
- Enum fields : valeurs issues d'une liste fermée — les options disponibles pour chaque champ sont listées directement dans le libellé du champ.
- Pour chaque champ, cliquer sur + Add Item, sélectionner le Field cible et renseigner la Value — statique ou mappée dynamiquement depuis une étape précédente via le Data Selector.
- Les types d'actif ordre et tâche ne peuvent pas être créés avec cette action (elle échoue avec l'erreur
ASSET_TYPE_NOT_ALLOWED) : utiliser Create Order et Create Task.
Cette action est typiquement utilisée en réponse à une soumission de formulaire, par exemple pour générer automatiquement une déclaration de non-conformité pré-renseignée à la réception d'une pièce défectueuse en MRO, ou pour créer un actif "Lot" avec ses champs de localisation et de référence produit au démarrage d'une production cosmétique.
¶ Update Asset
Rôle : Met à jour un ou plusieurs champs d'un actif Robin existant.
Configuration
- Sélectionner le type d'actif ciblé : la liste des actifs disponibles est filtrée selon ce type.
- Identifier l'actif à modifier (obligatoire) : sélectionner un actif spécifique ou mapper dynamiquement l'identifiant depuis une étape précédente (ex. : Loop on Items item id).
- Renseigner les champs à mettre à jour, organisés par type :
- Text fields : valeurs texte.
- Number fields : valeurs numériques.
- Date fields : valeurs de date et heure, saisies via le sélecteur natif ou en ISO8601 (voir https://en.wikipedia.org/wiki/ISO_8601).
- Enum fields : valeurs issues d'une liste fermée — les options disponibles pour chaque champ sont listées directement dans le libellé du champ.
- Pour chaque champ à modifier, cliquer sur + Add Item, sélectionner le Field cible et renseigner la Value — statique ou mappée dynamiquement depuis une étape précédente.
Seuls les champs explicitement ajoutés via + Add Item seront modifiés. Les autres champs de l'actif restent inchangés.
🆕 À partir de la version 2026.6 de Robin :
Elle peut désormais modifier des actifs de type ordre ou tâche. Le sélecteur Field propose alors, en plus des champs personnalisés du type :
- pour un ordre :
scheduling_id,name,id,due_date,precedence;- pour une tâche :
asset_id,order,name,start_date,start_lock,duration,precedence,priority,quantity_to_produce,quantity_produced,routing.Le comportement et les validations de ces propriétés sont identiques à ceux de Create Order et Create Task (détection des cycles de précédence, format de
routing, durée en heures, etc.).L'archivage et l'association d'appareil restent réservés aux actions Archive Asset, Pair Asset et Unpair Asset.
C'est l'action la plus courante dans un workflow Robin, utilisée par exemple pour mettre à jour le statut d'un bac cosmétique après chaque étape de fabrication, ou pour synchroniser la date de fin réelle d'une phase de maintenance MRO vers un champ exploitable par un système tiers.
¶ Archive Asset
Rôle : Archive un actif Robin (équivalent d'une suppression logique : l'actif n'est plus actif mais reste traçable).
Configuration
- Sélectionner le type d'actif à archiver : la liste des actifs disponibles est filtrée selon ce type.
- Identifier l'actif ciblé (obligatoire).
🆕 À partir de la version 2026.6 de Robin : cette action fonctionne aussi pour les actifs de type ordre.
Cette action permet d'automatiser la fin de vie d'un actif sans intervention manuelle, par exemple pour archiver un outil MRO dès qu'il atteint sa limite d'heures de vol, ou pour retirer un contenant cosmétique du pool actif après confirmation de son élimination en fin de ligne.
¶ Pair Asset
Rôle : Associe un appareil IoT (tag, ancre) à un actif Robin.
Configuration
- Sélectionner le type d'actif cible.
- Identifier l'actif auquel associer l'appareil.
- Choisir le Pairing Mode : détermine si l'appareil est identifié par son UID ou son numéro de série.
- Sélectionner l'appareil à associer (liste filtrée selon le mode de pairing).
🆕 À partir de la version 2026.6 de Robin : cette action fonctionne aussi pour les actifs de type ordre et tâche.
Ce connecteur est utile dès qu'un appareillage IoT doit être assigné dynamiquement à un actif, par exemple pour associer automatiquement un tag BLE à un outil à sa réception atelier en MRO, ou pour appairer un tag UWB à un chariot lors de son affectation à une ligne de production cosmétique.
¶ Unpair Asset
Rôle : Dissocie l'appareil IoT actuellement associé à un actif Robin.
Configuration
- Sélectionner le type d'actif concerné.
- Identifier l'actif dont dissocier l'appareil (obligatoire).
🆕 À partir de la version 2026.6 de Robin : cette action fonctionne aussi pour les actifs de type ordre et tâche.
Cette action complète naturellement Pair Asset dans les scénarios de rotation d'équipements, par exemple pour libérer le tag d'un outil envoyé en maintenance externe afin de le réassigner à un outil de remplacement, ou pour dissocier le tag d'un contenant cosmétique à son archivage.
¶ Filter Assets
Rôle : Récupère une liste filtrée d'actifs Robin selon des critères définis, pour les utiliser dans les étapes suivantes du workflow.
Configuration
- Sélectionner le type d'actif à filtrer (VZO). 🆕 Depuis la version 2026.6, les types ordre et tâche sont également pris en charge.
- Définir le statut d'archivage :
False (active)= actifs actifs,True= actifs archivés. - Renseigner les Field filters (expert mode) (optionnel) : objet JSON où chaque clé est un identifiant de champ et la valeur est le critère de correspondance. Laisser
{}pour ne filtrer que par type et statut.
Le champ Field filters accepte un liste avec les éléments suivants :
- Date (
date_X):{ "field", "from"?, "to"? }— au moins une limite, ISO 8601 avec fuseau horaire, les deux incluses. - Nombre (
num_X):{ "field", "min"?, "max"? }— au moins une limite, les deux incluses. - Texte (
text_X):{ "field", "operator", "value" }— operator ∈equals(égal) |contains(contient) |starts_with(commence par) |ends_with(se termine par) |regex. Insensible à la casse par défaut.regexest validé côté serveur ; les motifs non sûrs sont rejetés. - Énumération (
enum_X, plus spécialeszoneetid):{ "field", "values": [...] }— au moins une valeur.zone→ tableau d'identifiants de zone ;id→ tableau d'identifiants d'actif.
Exemple :
[
{
"field": "date_30",
"from": "2026-05-01T00:00:00Z",
"to": "2026-05-31T23:59:59Z"
},
{
"field": "num_1",
"min": 10,
"max": 50
},
{
"field": "text_86",
"operator": "contains",
"value": "BIN"
},
{
"field": "enum_1",
"values": [
"Container",
"Plateau"
]
},
{
"field": "zone",
"values": [
282,
315
]
},
{
"field": "id",
"values": [
"BIN-000154",
"BIN-000155"
]
}
]
🆕 Disponible à partir de la version 2026.6 de Robin : les filtres avancés et les données supplémentaires ci-dessous n'existent pas sur les versions antérieures. Les listes de filtres existantes continuent de fonctionner sans modification.
Filtres avancés (2026.6+)
- Combinaisons logiques : Field filters peut aussi être un objet JSON, soit un filtre unique, soit un groupe
{ "operator": "and" | "or", "conditions": [...] }ou{ "operator": "not", "condition": {...} }. Les groupes peuvent être imbriqués (5 niveaux maximum recommandés). Une liste simple reste équivalente à unandimplicite. - Date (
date_X) : nouvelle optionis_set(booléen).{ "field": "date_30", "is_set": false }retourne les actifs sans valeur,is_set: trueceux qui ont une valeur quelconque.is_set: falsene peut pas être combiné avecfrom/to. Au moins un critère parmifrom,toetis_setest requis. - Énumération (
enum_X,zone,id) : nouvelle optionoperator—in(par défaut) ounot_inpour exclure des valeurs.
Exemple de combinaison : (type Container ou Plateau) et date_30 à partir du 1er mai 2026 et pas dans la zone 282.
{
"operator": "and",
"conditions": [
{
"operator": "or",
"conditions": [
{ "field": "enum_1", "values": ["Container"] },
{ "field": "enum_1", "values": ["Plateau"] }
]
},
{ "field": "date_30", "from": "2026-05-01T00:00:00Z" },
{
"operator": "not",
"condition": { "field": "zone", "values": [282] }
}
]
}
Une structure invalide (opérateur inconnu, conditions / condition manquant, is_set: false combiné à from / to, etc.) fait échouer l'action.
Données supplémentaires renvoyées (2026.6+)
position: localisation de l'actif dansfields(latitude,longitude,altitude;altitudepeut être nulle).- Pour les types ordre et tâche :
precedence(liste desasset_iddes prédécesseurs). - Pour les types tâche :
routing(gamme de la tâche, voir Create Task).
Cette action est généralement utilisée en amont d'une boucle Loop on Items, par exemple pour récupérer tous les outils MRO dont le statut est "En attente de maintenance" afin de les traiter séquentiellement, ou pour lister les batchs actifs d'une ligne cosmétique et calculer un indicateur de charge en temps réel.
¶ Create Order
Rôle : Crée un ordre (order) dans un planning d'ordonnancement Robin, sans saisie manuelle dans le widget d'ordonnancement.
🆕 Disponible à partir de la version 2026.6 de Robin. Cette fonctionnalité n'est pas disponible sur les versions antérieures.
Configuration
- Sélectionner le planning (
scheduling_id) dans lequel créer l'ordre : la liste contient les plannings du site (obligatoire). - Renseigner le nom de l'ordre (
name, obligatoire). - Renseigner l'identifiant public de l'ordre (obligatoire) : il doit être unique.
- Renseigner la date d'échéance (
due_date, obligatoire) : format ISO 8601 avec fuseau horaire, par exemple2026-05-21T09:09:16.392Z. - Sélectionner les ordres prédécesseurs (
precedence, optionnel) : liste à choix multiple des ordres existants du planning. L'ordre ne peut démarrer qu'une fois ces ordres terminés. - Renseigner des champs personnalisés (
additional_fields, optionnel) : cliquer sur + Add Item, sélectionner le Field cible parmi les champs de l'ordre (chaque champ ne peut être utilisé qu'une fois) et renseigner la Value.
Données renvoyées : success, asset_id (identifiant de l'ordre créé, réutilisable par exemple comme prédécesseur dans une autre étape) et name.
L'action échoue notamment si le planning est introuvable, si l'identifiant est vide ou déjà utilisé, si la date d'échéance n'a pas de fuseau horaire, si un prédécesseur n'existe pas dans le planning, si les prédécesseurs créeraient une dépendance cyclique, ou si un champ personnalisé est inconnu, en double ou de type incompatible avec sa valeur.
C'est le seul moyen de créer un ordre depuis un workflow (Create Asset ne l'accepte pas). Cette action est typiquement utilisée pour générer automatiquement les ordres à planifier, par exemple à la réception d'une commande dans l'ERP ou à la soumission d'un formulaire. Pour modifier ensuite l'ordre, utiliser Update Asset.
¶ Create Task
Rôle : Crée une tâche (étape) rattachée à un ordre existant d'un planning d'ordonnancement Robin.
🆕 Disponible à partir de la version 2026.6 de Robin. Cette fonctionnalité n'est pas disponible sur les versions antérieures.
Configuration
- Renseigner l'identifiant public de la tâche (
asset_id, obligatoire) : il doit être unique. - Sélectionner l'ordre (
order, obligatoire) auquel appartient la tâche, parmi les ordres existants. - Renseigner le nom de la tâche (
name, obligatoire). - Renseigner la date de début (
start_date, obligatoire) : ISO 8601 avec fuseau horaire. Avecstart_lockactivé (désactivé par défaut), le solveur respecte strictement cette date. - Renseigner la durée (
duration, obligatoire) : en heures, nombre strictement positif (ex.2.5). - Sélectionner les tâches prédécesseurs (
precedence, optionnel) : uniquement des tâches du même ordre. - Choisir la priorité (
priority, optionnel) :P0,P1,P2ouP3(par défautP3). - Renseigner la quantité à produire (
quantity_to_produce, obligatoire) et, si besoin, la quantité déjà produite (quantity_produced,0par défaut). - Renseigner la gamme (
routing, obligatoire) : objet JSON décrit ci-dessous. - Renseigner des champs personnalisés (
additional_fields, optionnel) via + Add Item, comme pour Create Order.
Structure de la gamme (routing)
{
"stock": {
"consumption": [ { "asset_id": "RAW-001", "qty": 10 } ],
"production": [ { "asset_id": "FG-001", "qty": 5 } ]
},
"resources": [
{
"vzo_id": 131,
"qty": 1,
"shared_with": ["TASK-02"],
"conditions": [ { "id_field": "enum_5", "choices": ["TT4", "TT5"] } ],
"assignments": [ { "asset_id": "687916e538a5fe9baf40b3c8", "locked": true } ]
}
]
}
stock: stocks consommés (consumption) et/ou produits (production) par la tâche. Chaque entrée nécessiteasset_id(actif de stock) etqty.resources: liste de créneaux de ressources. Chaque créneau nécessitevzo_id(type de ressource) etqty. Options :shared_with(autres tâches partageant le créneau),conditions(valeurs acceptées pour un champ énumération de la ressource) etassignments(ressources affectées ;locked: true= affectation imposée au solveur,false= simple suggestion).
Données renvoyées : success, asset_id (identifiant de la tâche créée) et name.
L'action échoue notamment si l'ordre est introuvable, si l'identifiant est vide ou déjà utilisé, si la date n'a pas de fuseau horaire, si la durée n'est pas strictement positive, si la priorité est invalide, si un prédécesseur n'appartient pas au même ordre, si les prédécesseurs créeraient une dépendance cyclique, ou si la gamme n'est pas un objet JSON valide (stock ou ressource inconnu, champ obligatoire manquant).
C'est le seul moyen de créer une tâche depuis un workflow (Create Asset ne l'accepte pas). Elle est typiquement utilisée avec Create Order pour générer automatiquement les opérations d'un ordre de fabrication. Pour la modifier ensuite, utiliser Update Asset.
¶ API Robin
Rôle : Appelle directement un endpoint de l'API Robin depuis un workflow, sans passer par une action dédiée. Utile pour couvrir un besoin qu'aucune action Robin ne prend (encore) en charge.
🆕 Disponible à partir de la version 2026.6 de Robin. Cette fonctionnalité n'est pas disponible sur les versions antérieures.
Configuration
- Renseigner l'endpoint (obligatoire) : chemin relatif au serveur Robin, par exemple
/public/v2/sectors/123/assets/153. Un endpoint vide ou commençant parhttp:///https://est refusé. Les paramètres de chemin tels quesector_idne sont pas ajoutés automatiquement : les inclure dans l'endpoint. - Choisir la méthode HTTP (obligatoire) :
GET,POST,PATCH,PUTouDELETE. - Renseigner le body (optionnel) : objet JSON envoyé avec la requête. Il n'est utilisé que pour
POST,PATCHetPUT(ignoré pourGETetDELETE) et doit être un objet JSON valide.
L'adresse du serveur Robin et l'authentification sont gérées automatiquement, avec la même connexion que les autres connecteurs Robin : aucun hôte ni en-tête d'authentification n'est à renseigner.
Exemple
{
"endpoint": "/public/v2/sectors/123/assets/153/search",
"method": "POST",
"body": {
"archived": false,
"field_filters": [
{ "field": "text_86", "operator": "contains", "value": "BIN" }
]
}
}
Données renvoyées : status_code (code HTTP renvoyé par Robin), body (réponse, en JSON lorsque c'est possible) et headers.
Cette action transmet la réponse de Robin telle quelle : un code HTTP
4xxou5xxn'est pas considéré comme un échec de l'étape. Pour réagir à une erreur, testerstatus_codedans une étape suivante. L'étape n'échoue qu'en cas d'entrée invalide (endpoint, méthode ou body), de problème de connexion au serveur Robin ou d'identifiants Robin invalides.
Cette page ne te semble pas claire ou tu as besoin d'aide ? N'hésite pas à nous contacter à support@zozio.tech !