Un workflow d’actions est un workflow automatisé défini par l’utilisateur. Chaque workflow d’actions consiste en un déclencheur de workflow d’actions, qui lance le workflow, et d’une ou plusieurs actions.
Vous pouvez utiliser des déclencheurs de workflows d’actions prédéfinis, ou les administrateurs peuvent définir des déclencheurs de workflow d’actions personnalisés. Cet article explique comment créer un déclencheur de workflows d’actions personnalisé pour capturer une requête HTTP provenant d’un système externe spécifique.
Après avoir créé un déclencheur de workflows d’actions, vous pouvez l’utiliser dans n’importe quel workflow d’actions. Consultez Création de workflows d’actions.
Création d’un déclencheur de workflow d’actions personnalisé
La création et la gestion des déclencheurs de workflows d’actions se font dans le créateur d’actions.
- Dans le Centre d’administration, cliquez sur Applications et intégrations (
) dans la barre latérale, puis sélectionnez Actions > Workflows d’actions. - Créez ou modifiez un workflow d’actions.
- Cliquez sur + Ajouter un déclencheur.
- Dans la barre latérale de l’étape, sous Déclencheurs personnalisés, cliquez sur Créer un déclencheur.
- Saisissez un nom unique et facilement identifiable pour votre déclencheur.
La longueur maximale est de 255 caractères.
- (facultatif) Saisissez un exemple de charge utile pour la requête HTTP que vous attendez que le déclencheur reçoive.
Il doit s’agir d’une requête POST avec un corps JSON valide. La charge utile ne doit pas dépasse 200 Ko.
L’exemple de charge utile doit inclure toutes les propriétés, avec le type de données approprié, que vous voulez utiliser ultérieurement dans un workflow d’actions initié par ce déclencheur.
- Cliquez sur Suivant.
- Si vous fournissez un exemple de charge utile, mappez les données en cliquant sur Ajouter en regard de chaque paire clé-valeur que vous voulez capturer comme sortie dans votre workflow d’actions, puis en cliquant sur Suiv.
Si besoin est, vous pouvez utiliser le menu des options pour modifier le nom et le type d’une paire clé-valeur ou la supprimer du déclencheur. Les noms des sorties doivent être uniques au sein du déclencheur et ne doivent pas dépasser 255 caractères.
Les types de données suivants sont pris en charge comme sorties des déclencheurs personnalisés :- Texte
- Numéro
- Décimal
- Vrai/faux
- Date (
AAAA-MM-JJ) - Date et heure (
AAAA-MM-JJTHH:MM:SS[.sss]ZouAAAA-MM-JJTHH:MM:SS[.sss]+/-hh:mm) - Les matrices et les objets sont convertis en chaînes.
- Utilisez l’URL Webhook personnalisée générée pour le déclencheur pour configurer un webhook dans un système externe qui enverra les requêtes au déclencheur personnalisé pour initier un workflow d’actions.
De plus, si vous en avez la possibilité, configurez la stratégie de nouvelle tentative du système externe pour qu’elle utilise une temporisation exponentielle avec variation aléatoire pour trois nouvelles tentatives (20 secondes, 120 secondes et 300 secondes après une demande de limite de débit).
Remarque –- Traitez l’URL Webhook du déclencheur de workflows d’actions personnalisé comme confidentielle et ne la partagez avec personne.
- Les restrictions IP de votre compte sont appliquées pour l’URL Webhook.
- Ajoutez le déclencheur de workflow d’actions à un workflow d’actions. Consultez Création de workflows d’actions.
Utilisation des sorties des déclencheurs de workflows d’actions personnalisés
-
Sorties textuelles :
- Toutes les valeurs numériques, décimales, vrai/faux, de date ou de date/heure sont converties en texte.
- Si la clé est manquante dans le corps de la requête, elle est représentée comme nulle.
-
Sorties numériques :
- Les valeurs décimales sont arrondies au nombre entier le plus proche (au nombre supérieur pour les valeurs de ,5).
- Pour les valeurs vrai/faux, vrai est converti en 1 et faux en 0.
- Une chaîne représentant un nombre est convertie en nombre.
- Une chaîne représentant une valeur décimale est arrondie au nombre entier le plus proche (au nombre supérieur pour les valeurs de ,5).
- Toutes les autres chaînes sont converties en valeurs nulles.
- Si la clé est manquante dans le corps de la requête, elle est représentée comme nulle.
-
Sorties décimales :
- Les valeurs numériques sont transférées sans modification.
- Pour les valeurs vrai/faux, vrai est converti en 1 et faux en 0.
- Une chaîne représentant un nombre est convertie en valeur décimale.
- Une chaîne représentant une valeur décimale est convertie en valeur décimale.
- Toutes les autres chaînes sont converties en valeurs nulles.
- Si la clé est manquante dans le corps de la requête, elle est représentée comme nulle.
-
Sorties vrai/faux :
- Les valeurs nulles sont converties en faux.
- Les valeurs numériques et décimales de zéro (0, -0, 0,0, -0,0) sont converties en faux.
- Les chaînes vides ("", "''" et "``") sont converties en faux.
- Toutes les autres valeurs numériques, décimales, de chaîne, de date et date/heure sont converties en vrai.
- Si la clé est manquante dans le corps de la requête, elle est représentée comme nulle.