Activité d’entrée workflow

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 l’entrée.
    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 d’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 téléphonique. Le script doit spécifier une answer variable en tant qu’objet JavaScript avec le 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”
  }
};

    L’écriture peut spécifier une chaîne de synthèse vocale et un code de langue à l’aide de l’attribut speak ou de l’URL de la musique à jouer à 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 vient 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 téléphonique. Chaque condition est une option du menu téléphonique. 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 préfixant le message avec le 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 de la condition surparseInt(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 à prononcer 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 Les chiffres saisis par l’appelant, sous forme de chaîne.
    Nom workflow.scratchpad.menu<activity > La variable entière answer , si vous utilisez l’option de script avancé. Vous pouvez accéder à ce menu à partir d’autres activités après l’exécution réussie de cette activité.
    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.