Workflow-Aktivität Eingabe

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Die Aktivität Eingabe erstellt ein Telefonmenü, indem eine Liste mit Optionen für einen Notify-Anruf angezeigt wird.

    Eingabevariablen

    Eingabevariablen bestimmen das anfängliche Verhalten der Aktivität.

    Tabelle : 1. Eingabevariablen
    Variable Beschreibung
    Anzahl an Ziffern Geben Sie an, wie viele Ziffern der Anrufer maximal eingeben darf. Ein Anrufer kann weniger Ziffern eingeben als die Höchstzahl und die Taste Beenden-Taste drücken, um die Eingabe abzuschließen.
    Beenden-Taste Geben Sie die Taste an, die ein Anrufer an seinem Telefon drücken kann, wenn er mit der Auswahl einer Menüoption fertig ist.
    Timeout (in Sekunden) Geben Sie die Wartezeit vor dem automatischen Schließen des Menüs an, wenn der Anrufer keine Menüoption auswählt.
    Erweitert Aktivieren Sie dieses Kontrollkästchen, um ein Skript zum Erstellen des Telefonmenüs zu verwenden, anstatt die Aktivitätsbedingungen zu verwenden.
    Skript Definieren Sie das Skript zum Erstellen des Telefonmenüs. Das Skript muss eine answer-Variable als JavaScript-Objekt mit folgendem Format vorgeben:
     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”
  }
};

    Das Skript kann entweder eine Text-zu-Sprache-Zeichenfolge und einen Sprachcode mit dem Attribut speak oder die URL der wiederzugebenden Musik mit dem Attribut play ] angeben. Sie können auch optionale Attribute hinzufügen, um verwandte Informationen zu speichern, wie myCustomData im obigen Beispiel.

    Hinweis:
    Das Skriptobjekt unterstützt weiterhin das Attribut say für Abwärtskompatibilität.

    Bedingungen

    Die Bedingungen bestimmen den Übergang, der nach dieser Aktivität erfolgt.

    Die Eingabe-Aktivität gibt standardmäßig keine Bedingungen an. Sie müssen Bedingungen definieren, um das Telefonmenü aufzubauen. Jede Bedingung ist eine Option im Telefonmenü. Notify liest den Text von jedem Bedingungs-Namen dem Anrufer vor - bis zu 100 Zeichen pro Bedingung.

    Sie können für jede Bedingung eine Sprache angeben, indem Sie der Nachricht den Sprachcode im Format xx-XX:<Message> voranstellen. Fügen Sie beispielsweise fr-CA: für kanadisches Französisch hinzu. Die verfügbaren Sprachen werden in der Notify-Sprachentabelle [notify_language] gespeichert.

    Die Bedingung, die die Aktivität durchläuft, hängt von den vom Anrufer eingegebenen Ziffern ab. Stellen Sie den Wert der Bedingung auf parseInt(workflow.scratchpad.digits) == <expected digits> ein. Um beispielsweise eine Bedingung zu durchlaufen, wenn der Anrufer die Nummer 3 drückt, setzen Sie die Bedingung auf parseInt(workflow.scratchpad.digits) == 3.

    Sie können dieser Aktivität eine Fehlerbedingung hinzufügen. Die Aktivität geht durch die Fehlerbedingung, wenn das erweiterte Skript einen ungültigen Wert ausgibt oder wenn der Text für eine Bedingung leer ist.

    Scratchpad-Einträge

    Die Aktivität verwendet das Workflow-Scratchpad, um persistente Werte zu schreiben.

    Tabelle : 2. Werte, die in das Scratchpad geschrieben werden
    Eingabe Beschreibung
    workflow.scratchpad.digits Die vom Anrufer eingegebenen Ziffern als Zeichenfolge.
    workflow.scratchpad.menu<activity name> Die ganze answer-Variable, wenn die erweiterte Skriptoption verwendet wird. Sie können auf dieses Menü aus anderen Aktivitäten zugreifen, nachdem diese Aktivität erfolgreich ausgeführt wurde.
    Zum Beispiel, wenn der Aktivitätsname Wahlmöglichkeiten lautet, können Sie über das Menü auf Werte zugreifen
    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.