# Dialogplan-Knoten

# Auswahl-Fragen

Auswahl-Fragen lassen sich nicht mit "ja" oder "nein" beantworten. Typischerweise gibt der Chatbot dem*der Chabotnutzer*in daher für eine offene Frage (eine oder) mehrere Antwortoptionen. Eine offene Frage muss mindestens eine Option haben, idealerweise zwei oder mehr.

Um eine Knoten des Typs Auswahl-Frage hinzuzufügen, wählen Sie diesen Typ bei der Anlage des Dialogplan-Knotens aus.

Ein Auswahl-Knoten wird im Dialog-Editor durch einen grünen Kasten repräsentiert. Sie können eine Antwort-Option hinzufügen, indem Sie im Dialogplan-Knoten auf das Plus-Symbol klicken. Geben Sie nun für die Option den Antworttext ein, der dem*der Chatbotutzer*in als Klickoption vorgeschlagen werden soll. Auch zusätzliche Optionen können so durch Klick auf das Plus-Symbol im Dialogplan-Knoten hinzugefügt werden.

Sie können eine Option löschen, indem Sie auf das Mülleimer-Symbol klicken. Beachten Sie bitte, dass dadurch auch der komplette Dialogplanverlauf unterhalb der entsprechenden Option gelöscht wird.

Eine Option bietet immer eine Reaktion durch den Chatbot. Die Reaktion auf eine Option wird als separates Feld unterhalb der Option angezeigt. Um den Reaktionstext zu bearbeiten klicken Sie auf das Bleistift-Symbol in der Reaktion.

Soll ein weiterer Dialogplan oder Dialogplan-Knoten verlinkt werden, folgen Sie der Beschreibung im Abschnitt Dialogplan-Knoten und Dialogpläne verlinken . Besitzt eine Reaktion eine Verlinkung, kann sie einen Reaktionstext beinhalten oder sie kann textuell leer sein. Besitzt eine Reaktion keine Verlinkung, muss sie einen Reaktionstext beinhalten.

Zusätzlich zu den oben beschriebenen freien Optionen können zu den Auswahl-Fragen auch sogenannte Default-Optionen hinzugefügt werden.

Eine Auswahl-Frage mit Optionen und dazugehörigen Reaktionen
Eine Auswahl-Frage mit Optionen und dazugehörigen Reaktionen

# Ja/Nein-Fragen

Ja/Nein-Fragen lassen sich mit "ja" oder "nein" beantworten. Die Antwortoptionen sind daher bei Ja/Nein-Fragen die beiden schon vorgegeben Optionen "ja" und "nein".

Bei Ja/Nein-Fragen können keine weiteren Optionen hinzugefügt werden. Sie können keine der beiden Optionen "ja" oder "nein" löschen und auch die Optionstexte "ja" und "nein" nicht verändern.

Eine Option bietet immer eine Reaktion durch den Chatbot. Die Reaktion auf eine Option wird als separates Feld unterhalb der Option angezeigt. Um den Reaktionstext zu bearbeiten klicken Sie auf das Bleistift-Symbol in der Reaktion.

Soll ein weiterer Dialogplan oder Dialogplan-Knoten verlinkt werden, folgen Sie der Beschreibung im Abschnitt Dialogplan-Knoten und Dialogpläne verlinken . Besitzt eine Reaktion eine Verlinkung, kann sie einen Reaktionstext beinhalten oder sie kann textuell leer sein. Besitzt eine Reaktion keine Verlinkung, muss sie einen Reaktionstext beinhalten.

Eine Ja-Nein-Frage mit Optionen und dazugehörigen Reaktionen
Eine Ja-Nein-Frage mit Optionen und dazugehörigen Reaktionen

# Parameter-Abfrage

Bei der Parameter-Abfrage wird dem*der Chatbotnutzer*in die Möglichkeit gegeben, einen Wert einzugeben, welcher gespeichert und weiterverwendet werden kann.

Ein neuer Dialogplan-Knoten mit Parameterabfrage
Ein neuer Dialogplan-Knoten mit Parameterabfrage

  1. Wenn Sie diesen Typ ausgewählt haben, können Sie wie auch bei offenen und Ja/Nein-Fragen einen Namen für den Dialogplan-Knoten und einen Einstiegstext definieren.
  2. Zusätzlich dazu müssen Sie zwei weitere Elemente definieren:
    • Parameter-Name: Dies ist der Name, den Sie Ihrem Parameter geben. Mithilfe dieses Schlüssels kann im späteren Verlauf Bezug genommen werden, indem $ mit dem Parameter-Namen kombiniert wird,
        1. $anzahl. Sie können den Namen frei wählen, benutzen Sie jedoch keine Sonder- oder Leerzeichen in dem Namen.
    • Parameter-Typ: Hier muss ein von Kauz vorgegebener Schlüssel eingegeben werden, anhand dessen geprüft werden kann, ob die Eingabe zu den Anforderungen des Parameters passt.
    • Optional kann noch eine Einheit für den Parameter angegeben werden. Diese wird jedoch in der Regel bereits durch den Parameter-Typ geprüft.
  3. Hinterlegen Sie die Reaktion auf einen validen Parameter (der Chatbot hat die Eingabe verstanden).
  4. Hinterlegen Sie die Reaktion auf einen invaliden Parameter (der Chatbot hat die Eingabe nicht verstanden).

Folgende Parameter-Typen stehen zur Auswahl (Erweiterungen sind auf Anfrage möglich):

Parameter-Typ Beschreibung Wert Beispiel-Input Hinweise
ANY Frei alles erlaubt
  • ddie332εδ
  • Zebrastreifen
INTEGER Ganze Zahl Positive und negative ganze Zahlen sowie Zahlwörter
  • 3
  • -3
  • drei
NUMBER Zahl Zahlen (auch negative und Dezimalzahlen)
  • 75
  • 156.8
  • -50
  • fünf
NUMBER_WITH_UNIT Zahl mit Einheit Zahlen mit Standardeinheiten
  • 3 kg
  • 3 Stunden
  • -50
  • 4 Meter
DATE Datum Datum im deutschen oder internationalen Format
  • 15.03.2020
  • 2020-03-15
  • 15.03.
  • 15. März
AGE Alter Alter zwischen 0 und 130 als Zahl oder Zahlwort. Angaben sind in Jahren, Monaten, Wochen und Tagen möglich.
  • 3 J. 4 Monate
  • 75
  • drei Wochen
PLZ Postleitzahl Deutsche Postleitzahl
  • 12345
  • 40237
FREQUENCY Frequenz Anzahl- oder Häufigkeitsangaben
  • 3x
  • dreimal
SIZE_OF_HOME Wohnfläche Fläche in m^2
  • 32 qm
  • 34m2
  • 34 Quadratmeter
FULL_NAME Vollständiger Name Vor- und Nachname
  • Max Mustermann
  • Mustermann, Max
PHONE_NUMBER Telefonnummer Telefonnummer mit Vorwahl
  • +49 0123 4567890
  • 12345 12345
Die Telefonnummer muss mindestens 7 Zeichen lang sein. Weisen Sie die Nutzer*innen in der Frage am besten darauf hin, dass die Vorwahl mit angegeben werden muss.
EMAIL_ADDRESS Email-Adresse Email-Adresse
TRAVEL_RELATION Reiseverbindung Start- und Zielort
  • Hamburg - München
  • Hamburg bis München
SIGN_OF_THE_ZODIAC Sternzeichen Westliches Tierkreiszeichen
  • Fische
  • Löwe
  • Waage
NUMBER_WITH_LETTER Zahl mit Buchstaben String, der mindestens eine Zahl und mindestens einen Buchstaben enthält (z. B. für IDs)
  • 45D
  • adh3b478jk
  • drei
Akzeptiert keine Leer- und Sonderzeichen. Erweiterung um ein kundenspezifisches Muster auf Anfrage möglich.
AMOUNT_OF_MONEY Geldbetrag Zahl mit Währung
  • 31 Euro
  • fünf Dollar
  • €10
  • 3 Euro und 50 Cent
  • 3k Euro
Nicht geeignet für Sätze, in denen die Währung weggelassen wird (z.B. "Ich verdiene 50000 im Jahr"). Wenn solche Eingaben erwartet werden, ist NUMBER der bessere Parametertyp.

Ein Dialogplan-Knoten mit Reaktionen auf einen validen und einen invaliden Parameter
Ein Dialogplan-Knoten mit Reaktionen auf einen validen und einen invaliden Parameter

# Parameter-Abfrage (Auswahl)

Alternativ zur freien Parameter-Abfrage können mit dem Typ Parameter-Abfrage (Auswahl) auch Antwortmöglichkeiten vorgegeben werden. Die Antwortoptionen werden hier wie bei einer offenen Frage angegeben. Der einzige Unterschied besteht darin, dass der Wert der ausgewählten Option unter dem Parameter-Namen abgespeichert wird.

Ein Dialogplan-Knoten mit einer Parameterabfrage (Auswahl)
Ein Dialogplan-Knoten mit einer Parameterabfrage (Auswahl)

# Kalkulation

Mithilfe des Knotentypens Kalkulation können Sie innerhalb eines Dialogplans eine Berechnung durchführen lassen.

Ein neuer Dialogplan-Knoten mit Kalkulation
Ein neuer Dialogplan-Knoten mit Kalkulation

  1. Erstellen Sie einen weiteren Dialogplan-Knoten und wählen Sie den Typ Kalkulation.
  2. Fügen Sie die Methode hinzu, die verwendet werden soll. Diese muss im Voraus mit Kauz abgesprochen und eingerichtet worden sein.
  3. Formulieren Sie eine Entschuldigung, falls die Kalkulation fehlschlagen sollte.
  4. Verlinken Sie den neuen Dialogplan-Knoten mit allen Pfaden, die zur Kalkulation führen sollen.
  5. Unter dem result-Pfad wird das Ergebnis der Berechnung angezeigt. In der Reaktion müssen Sie wie gewohnt einen Reaktionstext verfassen.
  6. Fügen Sie unter dem check-Pfad eine Reaktion ein, für den Fall, dass ein Fehler bei der Berechnung auftritt.

Ein Dialogplan-Knoten mit einer Kalkulation
Ein Dialogplan-Knoten mit einer Kalkulation