Activité d’entrée workflow

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 Notify.

    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 Fin pour terminer la saisie.
    Touche de fin Spécifiez la touche sur laquelle un 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 le délai d’attente avant de fermer automatiquement le menu lorsque l’appelant ne sélectionne aucune option de menu.
    Avancé 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 suit cette activité.

    L’activité d’entrée ne spécifie aucune condition par défaut. 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 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 condition sur parseInt(workflow.scratchpad.digits) == <chiffres attendus>. Par exemple, pour passer d’une condition à une 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 Chiffres saisis par l’appelant sous forme de chaîne.
    workflow.scratchpad.menu<nom de l’activité> La variable entière answer , si l’option de script avancé est utilisée. Vous pouvez accéder à ce menu à partir d’autres activités une fois l’exécution de cette activité réussie.
    Par exemple, si le nom de l’activité est des choix, vous pouvez accéder aux valeurs à partir du menu en utilisant
    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.