Activité d’entrée workflow

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • L’activité Entrée crée un menu téléphonique en présentant une liste d’options lors d’un appel Notification.

    Variables d'entrée

    Les variables d'entrée déterminent le comportement initial de l'activité.

    Tableau 1. Variables d'entrée
    Variable Description
    Nombre de chiffres Spécifiez le nombre maximal de chiffres que l’appelant peut saisir. Un appelant peut saisir moins de chiffres que le maximum et appuyer sur la touche Terminer pour terminer la saisie.
    Touche de fin Spécifiez la touche sur laquelle l’appelant peut appuyer sur son téléphone lorsqu’il a terminé de sélectionner une option de menu.
    Délai (en secondes) Spécifiez la durée d’attente avant de fermer automatiquement le menu lorsque l’appelant ne sélectionne pas une option de menu.
    Avancés Cochez cette case pour utiliser un script afin de créer le menu du téléphone, au lieu d’utiliser les conditions d’activité.
    Script Définissez le script pour créer le menu du téléphone. Le script doit spécifier une answer variable en tant qu’objet JavaScript au format suivant :
     answer = {
  “1": {
      “play”: “https://some_url.com/options/one.mp3“,
      “myCustomData”: “some data here”
  },
  “2”: {
      “play”: “https://some_url.com/options/two.mp3”,
      “myCustomData”: “some other data here”
  },
“3”: {
      “speak”: “type 3 to speak to a representative”,
      “language”: “en-US”,
      “myCustomData”: “some more data here”
  }
};

    Le script peut spécifier soit une chaîne de synthèse vocale et un code de langue à l’aide de l’attribut speak , soit l’URL de la musique à lire à l’aide de l’attribut play . Vous pouvez également ajouter des attributs facultatifs pour stocker des informations connexes, comme myCustomData dans l’exemple ci-dessus.

    Remarque :
    L’objet script continue de prendre en charge say l’attribut pour la rétrocompatibilité.

    Conditions

    Les conditions déterminent la transition qui survient après cette activité.

    Par défaut, l’activité d’entrée ne spécifie aucune condition. Vous devez définir des conditions pour créer le menu du téléphone. Chaque condition est une option dans le menu du téléphone. Notification lit le texte de chaque nom de condition à l’appelant, jusqu’à 100 caractères par condition.

    Vous pouvez spécifier une langue pour chaque condition en faisant précéder le message du code de langue, au format xx-XX :<Message>. Par exemple, ajoutez fr-CA : pour le français canadien. Les langues disponibles sont stockées dans la table Langue de notification [notify_language].

    La condition par laquelle passe l’activité dépend des chiffres saisis par l’appelant. Définissez la valeur Condition de la condition sur parseInt(workflow.scratchpad.digits) == <chiffres attendus>. Par exemple, pour passer d’une condition à l’autre lorsque l’appelant appuie sur le chiffre 3, définissez la condition sur parseInt(workflow.scratchpad.digits) == 3.

    Vous pouvez ajouter une condition d’erreur à cette activité. L’activité passe par la condition d’erreur si le script avancé renvoie une valeur non valide ou si le texte à indiquer pour une condition est vide.

    Entrées de bloc-notes

    L’activité utilise le bloc-notes du workflow pour écrire des valeurs persistantes.

    Tableau 2. Valeurs écrites dans le bloc-notes
    Entrée Description
    workflow.bloc-notes.chiffres Chiffres entrés par l’appelant, sous forme de chaîne.
    workflow.scratchpad.menu<nom de l’activité> La variable entière answer , si vous utilisez l’option de script avancé. Vous pouvez accéder à ce menu à partir d’autres activités une fois cette activité exécutée avec succès.
    Par exemple, si le nom de l’activité est Choix, vous pouvez accéder aux valeurs du menu à l’aide de
    var previousActivity = "choices";
var choicesMenu = workflow.scratchpad.menu[previousActivity];
var menuItem = choicesMenu[workflow.scratchpad.digits];  // Selects the menu item based on the caller's input.
var selectedValue = menuItem.myCustomData; //get the custom data for the selected menu item.