Les conditions de workflows dans 4escape
À quoi servent les conditions de workflows ?
Les conditions de workflows vous permettent d'automatiser et de personnaliser vos communications en fonction de critères spécifiques. Cette fonctionnalité est particulièrement utile pour :
Envoyer des confirmations personnalisées selon la salle réservée
Adapter la langue de communication (français/anglais)
Personnaliser les messages selon le résultat de la session
Gérer différemment les types de produits (bons cadeaux, ventes additionnelles...)
Comment trouver l'ID d'une room/produit ?
Pour utiliser les conditions, vous aurez souvent besoin de l'ID de l'élément ciblé. Vous pouvez le trouver dans la barre de recherche de votre navigateur lorsque vous visualisez la fiche de la room ou du produit. Par exemple :
Structure générale des conditions
Les conditions utilisent un format JSON avec deux structures possibles :
{ "all": [] }: toutes les conditions doivent être remplies{ "any": [] }: une seule condition suffit
Une fois la structure choisie, vous pouvez copier-coller les conditions à l'intérieur des crochets, en les séparant par des virgules.
Conditions liées aux salles
Pour envoyer un mail de confirmation spécifique à une salle
{
"all": [
{
"fact": "room",
"path": "._id",
"operator": "inMongoIds",
"value": [
"5cfa73ca4a0f120b4212053c"
]
}
]
}Pour plusieurs salles, ajoutez les IDS séparés par des virgules
{
"all": [
{
"fact": "room",
"path": "._id",
"operator": "inMongoIds",
"value": [
"5cfa73ca4a0f120b4212053c",
"5cfa73ca4a0f120b4212053c"
]
}
]
}
Conditions liées aux produits
Vous souhaitez être informé lorsqu'un certain produit est commandé
{
"all": [
{
"fact": "_id",
"operator": "inMongoIds",
"value": [
"6242ca05ae692c89d16a26b7"
]
}
]
}Pour plusieurs salles, ajoutez les IDS séparés par des virgules
{
"all": [
{
"fact": "_id",
"operator": "inMongoIds",
"value": [
"5cfa73ca4a0f120b4212053c",
"5cfa73ca4a0f120b4212053c"
]
}
]
}
Conditions liées aux bons cadeaux
Configurer un workflow pour les bons cadeaux en général
{
"all": [
{
"fact": "_type",
"operator": "in",
"value": [
"gift voucher"
]
}
]
}Configurer un workflow pour les bons cadeaux imprimés
Créez un workflow spécifique lorsque le bon cadeau est destiné à la personne qui l'imprime et qui l'offre.
{
"all": [
{
"fact": "offered_method",
"operator": "equal",
"value": "email:me"
}
]
}Configurer un workflow pour les bons cadeaux envoyés directement à un tiers
Activez un workflow lorsque le bon cadeau est envoyé directement à la personne qui en bénéficiera.
{
"all": [
{
"fact": "offered_method",
"operator": "equal",
"value": "email:to"
}
]
}Configurer un workflow pour un bon cadeau spécifique
Personnalisez un workflow pour un bon cadeau particulier en utilisant son identifiant unique.
{
"all": [
{
"fact": "product",
"path": "._id",
"operator": "inMongoIds",
"value": [
"607551218f98e14eebe8798a"
]
}
]
}Configurer un workflow pour les ventes additionnelles
Déclenchez un mail automatique lorsqu'un produit de type "vente additionnelle" est commandé.
{
"all": [
{
"fact": "_type",
"operator": "in",
"value": [
"additional sales"
]
}
]
}Configurer un workflow pour les produits en Click & Collect
Activez un workflow spécifique pour les produits gérés en mode Click & Collect.
{
"all": [
{
"fact": "is_shippable",
"operator": "isBoolean",
"value": true
}
]
}Configurer un workflow pour les sessions pleinement réussies
Envoyez un mail de remerciement avec les liens des réseaux sociaux si la session s'est parfaitement déroulée.
{
"all": [
{
"fact": "session",
"path": ".rating_game_master",
"operator": "isBoolean",
"value": true
}
]
}Configurer un workflow pour les sessions non satisfaisantes
Envoyez un mail de remerciement sans les liens des réseaux sociaux si les joueurs ne sont pas entièrement satisfaits.
{
"all": [
{
"fact": "session",
"path": ".rating_game_master",
"operator": "isBoolean",
"value": false
}
]
}Configurer un workflow pour les mails en anglais
Adaptez vos workflows pour envoyer des mails en anglais à votre clientèle anglophone.
{
"all": [
{
"fact": "customer",
"path": ".language",
"operator": "in",
"value": [
"en"
]
}
]
}Configurer un workflow pour les mails en français
Personnalisez vos workflows pour envoyer des mails en français à votre clientèle francophone.
{
"all": [
{
"fact": "customer",
"path": ".language",
"operator": "in",
"value": [
"fr",
"fr-FR"
]
}
]
}Configurer un workflow pour les mails en anglais basés sur la variation de langue
Si vos clients ont la possibilité de choisir entre une session en anglais ou en français, vous pouvez configurer vos workflows pour qu'ils s'adaptent automatiquement à leur choix linguistique. Pour cela, créez deux workflows distincts : un pour l'anglais et un pour le français.
Cette approche permet une personnalisation précise des communications en fonction des préférences linguistiques de vos clients, améliorant ainsi leur expérience.
Pour le workflow en anglais
Utilisez une condition qui inclut la valeur associée à l'anglais dans votre variation de langue. Cela garantit que le mail est envoyé uniquement aux clients ayant sélectionné l'anglais.
{
"all": [
{
"fact": "room_attributes",
"operator": "bookingFindAttributeValueIn",
"value": [
"XXXXXXXXXXXXXXXXXXXXXXXX",
"XXXXXXXXXXXXXXXXXXXXXXXX",
"XXXXXXXXXXXXXXXXXXXXXXXX"
]
}
]
}
Pour le workflow en français
Appliquez une condition qui exclut la valeur de l'anglais. Ainsi, le mail en français sera envoyé aux clients ayant choisi cette langue ou ayant laissé le français par défaut.
{
"all": [
{
"fact": "room_attributes",
"operator": "bookingFindAttributeValueNotIn",
"value": [
"XXXXXXXXXXXXXXXXXXXXXXXX",
"XXXXXXXXXXXXXXXXXXXXXXXX",
"XXXXXXXXXXXXXXXXXXXXXXXX"
]
}
]
}Configurer un workflow pour les missions réussies
Invitez les joueurs à revenir pour d'autres aventures lorsqu'ils ont réussi leur mission.
{
"all": [
{
"fact": "session",
"path": ".success",
"operator": "isBoolean",
"value": true
}
]
}Configurer un workflow pour les missions échouées
Proposez aux joueurs de retenter leur chance après un échec.
{
"all": [
{
"fact": "session",
"path": ".success",
"operator": "isBoolean",
"value": false
}
]
}Configurer un workflow pour les relances de checkin
Envoyez un mail de rappel si les joueurs n'ont pas complété leur checkin.
{
"all": [
{
"fact": "order",
"path": ".source",
"operator": "equal",
"value": "public"
},
{
"fact": "is_checkin_ready",
"operator": "isBoolean",
"value": false
}
]
}Configurer un workflow pour les relances de paiement
Activez un mail de relance automatique si le paiement n'a pas été entièrement finalisé.
{
"all": [
{
"fact": "order",
"path": ".source",
"operator": "equal",
"value": "public"
},
{
"fact": "order",
"path": ".status",
"operator": "equal",
"value": "on-hold"
}
]
}Configurer un workflow basé sur un template 4escape
Personnalisez vos workflows en utilisant un template spécifique de 4escape pour des relances automatiques.
{
"all": [
{
"fact": "template",
"operator": "inMongoIds",
"value": [
"NUMERO DE TEMPLATE 4escape"
]
}
]
}
Comment cumuler plusieurs conditions dans un workflow ?
Vous pouvez cumuler plusieurs conditions en les séparant par des virgules. Par exemple, pour envoyer un mail en français pour une mission réussie sur une salle précise :
{
"all": [
{
"fact": "session",
"path": ".success",
"operator": "isBoolean",
"value": true
},
{
"fact": "customer",
"path": ".language",
"operator": "in",
"value": [
"fr",
"fr-FR"
]
},
{
"fact": "room",
"path": "._id",
"operator": "inMongoIds",
"value": [
"5bfbe990e15b535aab0b1195"
]
}
]
}
Comment valider la structure de mes conditions ?
En attendant l'implémentation d'un validateur JSON directement dans 4escape, nous vous recommandons de vérifier la structure de vos conditions avant de les utiliser dans vos workflows.
Pour cela, vous pouvez utiliser des outils en ligne gratuits comme JSON Formatter. Il suffit de :
Copier votre condition
La coller dans l'éditeur du site
Cliquer sur "Process"
Si votre condition est correctement structurée, vous obtiendrez un message de validation en vert. Dans le cas contraire, l'outil vous indiquera précisément où se trouve l'erreur dans votre code.
⚠️ Important : Une structure JSON invalide empêchera le bon fonctionnement de votre workflow. Prenez donc le temps de valider vos conditions avant de les mettre en production.
💡 Astuce : En cas d'erreur, vérifiez particulièrement :
Les accolades et crochets fermants
Les virgules entre les conditions
Les guillemets autour des valeurs textuelles