Scripts de génération

Engendre un script vous permet d’exécuter un script manuellement. Cette méthode est également utilisée pour démarrer un script à partir d’autres scripts ou de processus externes. Vous pouvez également l’utiliser pour tester un script. Lors des tests, il peut être utilisé avec les traces de script.

Pour tester les scripts, vous pouvez lancer des scripts à partir de Studio en utilisant l'option de traçage trace option.

Pour lancer des scripts à partir d’autres scripts ou processus :

• Utilisez l’ SPAWN action dans le script d’appel.
• Utilisation de l’API POST /scripts/start . C’est la solution recommandée pour engendrer un script à partir d’un processus externe.

Paramètres de script

Les paramètres de script permettent de transmettre des données aux scripts. Les données peuvent provenir d’autres scripts, y compris des scripts système, ou de sources externes telles que des systèmes CRM Systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de l’assistance et les historiques de cas. ou des API. Ils sont transmis aux scripts dans les variables pX, p1 à pN, où N est le nombre maximum de paramètres pris en charge par la méthode Engendrer. Vous pouvez spécifier les données à transmettre au script lorsque vous créez un script à l’aide de l’une des options énumérées dans la section précédente.

Si vous souhaitez modifier les noms des variables des paramètres, vous pouvez configurer l’action Begin dans le script engendré avec de nouveaux noms. Lorsque le script traite l’action BEGIN, les variables pX sont converties en nouveaux noms. Si vous ne spécifiez pas de nouveaux noms, les variables conservent les noms de pX.

Lorsque des données sont transmises à un script, vous pouvez les voir dans une trace. Sélectionnez l’action BEGIN pour voir les variables des paramètres dans la liste des variables de la sortie de la trace. Si vous avez configuré l’action BEGIN avec de nouveaux noms de variables, sélectionnez l’action qui vient après BEGIN dans la trace de script pour les voir. Les variables de paramètre sont présentes seulement si elles ont une valeur.

Comparaison des actions Studio

Il existe trois actions Studio qui permettent de lancer un nouveau script à partir du script en cours. Toutefois, il existe des différences entre ces deux types de produits :

• Runscript : Lorsque  déclenche un autre script, il ne retourne pas au premier script à partir du second.
• Runsub : Lorsque déclenche un sous-script, le script peut revenir au premier script, à condition que le sous-script ait une action . L’action renvoie une valeur à l’action lorsque le sous-script est terminé.
• SPAWN : Lance un deuxième script qui s’exécute en parallèle au premier script. Les scripts créés ne peuvent pas renvoyer de données au premier script, à moins que vous n’incluiez une action dans le script créé.

Engendrer un script à partir d’un autre script à l’aide de l’action ENGENDRER

Si vous n’avez pas besoin de transmettre des valeurs de paramètres au script enfant, il vous suffit d’ajouter et de configurer l’action SPAWN dans le script parent. Si vous devez transmettre des paramètres, vous devez effectuer les configurations suivantes :

• Apportez les modifications suivantes au script parent :
  • Placez l’action SPAWN à l’endroit où vous souhaitez engendrer le script enfant. Configurez la propriété Paramètres dans l’action SPAWN avec toutes les valeurs que vous devez transmettre au script enfant. Les valeurs sont transmises dans les variables p1 à p9.
  • Configurez les other properties de l’action SPAWN.

• Apportez les modifications suivantes au script enfant :

  • Configurez la propriété Paramètres dans l’action pour modifier le nom des variables des paramètres personnalisés. Si vous ne faites rien, les valeurs des paramètres personnalisés restent dans les variables .
  • Si vous devez renvoyer des valeurs au script parent ou à l’application appelante, ajoutez et configurez une actionaction .

Engendrer un script par API

Utilisez l’API POST /scripts/start pour engendrer un script.

Lorsque vous utilisez cette API, il est important de noter ce qui suit :

• Les paramètres suivants sont nécessaires :
  • skillId : La valeur doit être un entier lors de l’envoi en JSON, mais pas lors de l’envoi en tant que paramètres de requête. Les compétences doivent :
    • Être actives.
    • Correspondre au type de support de script. Par exemple, les scripts téléphoniques doivent être en corrélation avec les compétences en appel téléphonique. Vous trouverez le type de compétence dans l’onglet Détails d’une compétence. Les scripts de type Generic fonctionnent avec n’importe quelle compétence active.

  • scriptId ou scriptPath : L’utilisation de scriptPath est recommandée. L’ID du script change à chaque fois que des modifications du script sont enregistrées, il doit donc être mis à jour dans le paramètre.

• Vous pouvez inclure jusqu’à 20 paramètres.
• Les paramètres doivent être envoyés sous la forme d’une liste délimitée par barre verticale.
• L’API prend en charge un maximum de 32 ko pour tous les paramètres, y compris les barres verticales.
• Les paramètres ne peuvent pas inclure de barres verticales, sauf s’il s’agit de délimiteurs.
• Si vous envoyez la demande sous forme de JSON, les caractères réservés doivent être correctement échappés.
• Si vous envoyez la demande avec des paramètres de requête URL, les paramètres doivent être codés dans l’URL.