Activité d’entrée workflow

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 de 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 la valeur maximale et appuyer sur la touche Terminer 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 pas d’option de menu.
    Avancée Activez cette case à cocher 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”
  }
};

    Le script peut spécifier soit une chaîne de synthèse vocale et un code de langue utilisant l’attribut speak , soit 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é.

    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 la condition surparseInt(workflow.scratchpad.digits) == <chiffres attendus>. Par exemple, pour effectuer une transition entre une condition lorsque l’appelant appuie sur le nombre 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.
    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 que cette activité s’exécute avec succès.
    Par exemple, si le nom de l’activité est Choix, vous pouvez accéder aux valeurs à partir 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.