Sie können alle Screenshots durch Anklicken vergrößern. Die Screenshots zeigen sowohl den Node selbst als auch das zugehörige Einstellungsmenü.
API request
Verwenden Sie diesen Node, um über API-Anfragen Daten mit externen Systemen auszutauschen. Nutzen Sie GET, POST, PUT oder DELETE als Methode. Sie können auch Header und Body hinzufügen. Speichern Sie das Ergebnis der Abfrage in einer Variablen, um es später im Gespräch zu verwenden.
Anstelle eines Bodys können Sie auch eine Datei an das externe System senden, zum Beispiel eine Datei, die der Kontakt zuvor über den Node „Capture media“ gesendet hat (siehe unten). Klicken Sie dazu auf „Add file“.
Eine Anfrage sendet entweder einen Body oder eine Datei, niemals beides: Die Datei ersetzt den Body. Wenn „Add file“ nicht verfügbar ist, enthält der Node bereits einen Body. Entfernen Sie zuerst den Body und fügen Sie dann die Datei hinzu.
Wählen Sie unter „File upload type“ aus, wie die Datei übertragen werden soll:
- Form data with file: Wählen Sie diese Option, wenn das externe System einen Datei-Upload wie aus einem Webformular erwartet. Die Datei wird als ein Feld des Formulars gesendet. Unter „Field name“ legen Sie den Namen dieses Feldes fest. Wenn Sie keinen Namen eingeben, heißt das Feld „file“.
- Raw file content: Wählen Sie diese Option, wenn das externe System die Datei selbst als Body der Anfrage erwartet. Der Dateityp wird mitgesendet.
Geben Sie unter „File“ den Link zu einer externen Datei ein oder klicken Sie im Feld auf „Insert variable“ und wählen Sie die Variable aus, in der der Node „Capture media“ die Datei gespeichert hat. Dies ist dieselbe Variablenauswahl wie in den anderen Feldern des Workflows. Wenn die Datei bei der Ausführung des Workflows nicht abgerufen werden kann, zum Beispiel weil die Variable leer ist, wird die Anfrage nicht gesendet und der Workflow folgt dem Ausgang „If request failed“.
Der Bereich „Body“ des Nodes auf der Workflow-Arbeitsfläche zeigt anschließend an, was gesendet wird: „JSON Body“, „Form data file“ oder „Raw file“.
Capture carousel
Verwenden Sie diesen Node, wenn Sie den Kontakt aus einer vordefinierten Anzahl von Optionen mit Bild und Beschreibung auswählen lassen und die Auswahl zur späteren Verwendung im Gespräch vorübergehend in einer Variablen speichern möchten. Verwenden Sie einen Ersatztext für den Fall, dass die Optionen nicht angezeigt werden können.
In unserem Beispiel wird der Kontakt gebeten, eine von drei Optionen auszuwählen. Die Auswahl wird vorübergehend in der Variablen „option“ gespeichert. Wenn die Buttons nicht angezeigt werden können, wird der Ersatztext ausgegeben.
Capture regex
Verwenden Sie diesen Node, wenn Sie die Eingabe des Kontakts anhand eines bestimmten, vordefinierten Formats überprüfen möchten. Wenn Sie den folgenden Punkt aufklappen, finden Sie einige Beispiele:
Regex-Beispiele:
Capture buttons
Verwenden Sie diesen Node, wenn Sie den Kontakt aus einer vordefinierten Anzahl von Optionen auswählen lassen und die Auswahl zur späteren Verwendung im Gespräch vorübergehend in einer Variablen speichern möchten. Verwenden Sie einen Ersatztext für den Fall, dass die Buttons nicht angezeigt werden können.
In unserem Beispiel wird der Kontakt gebeten, eine von drei Optionen auszuwählen. Die Auswahl wird vorübergehend in der Variablen „option“ gespeichert. Wenn die Buttons nicht angezeigt werden können, wird der Ersatztext ausgegeben.
Capture email
Verwenden Sie diesen Node, wenn Sie die E-Mail-Adresse des Kontakts abfragen und zur späteren Verwendung im Gespräch vorübergehend in einer Variablen speichern möchten. Entscheiden Sie, ob geprüft werden soll, ob die Variable bereits Daten enthält, und ob der Kontakt die Eingabe überspringen darf.
In unserem Beispiel wird der Kontakt gebeten, seine E-Mail-Adresse einzugeben. Die Eingabe wird vorübergehend in der Variablen „email“ gespeichert. Das System prüft, ob die Variable in den Kontaktfeldern bereits vorhanden und ausgefüllt ist. Der Kontakt kann die Eingabe nicht überspringen.
Capture media
Verwenden Sie diesen Node, wenn der Kontakt innerhalb eines Workflows ein Dokument senden soll. Wählen Sie den Dokumenttyp aus (Image, Video, Audio, Document oder einen beliebigen Typ).
In unserem Beispiel wird der Kontakt gebeten, ein Dokument vom Typ Image bereitzustellen.
Verwenden Sie diesen Node, wenn der Kontakt innerhalb eines Workflows ein Dokument senden soll. Wählen Sie den Dokumenttyp aus (Image, Video, Audio, Document oder einen beliebigen Typ).
Wenn Sie die Datei später im Workflow verwenden möchten, geben Sie unter „Variable“ einen Namen ein, zum Beispiel „photo“. Der Node speichert dann einen Link zur erfassten Datei in dieser Variablen. Dies ist optional.
Sie können die Variable anschließend in zwei Nodes verwenden. In beide Felder fügen Sie sie über „Insert variable“ ein; dort finden Sie sie unter „This Workflow“:
- Message: Klicken Sie auf „Add media“ und fügen Sie die Variable in das Feld „URL“ ein, um die Datei erneut an den Kontakt zu senden. Der Node „Message“ wird unter [Allgemeine Nodes](https://docs.lime-connect.com/general-nodes-2c482b4dcc478116a022c5e7f0dda78e) beschrieben.
- API request: Fügen Sie die Variable unter „File“ ein, um die Datei an ein externes System zu senden (siehe den Abschnitt „API request“ oben).
In unserem Beispiel wird der Kontakt gebeten, ein Dokument vom Typ Image bereitzustellen.
Das Bild wird in der Variablen „photo“ gespeichert, sodass es später im Workflow erneut gesendet oder weitergegeben werden kann.
Capture text
Verwenden Sie diesen Node, wenn Sie einen beliebigen Text vom Kontakt abfragen und zur späteren Verwendung im Gespräch vorübergehend in einer Variablen speichern möchten. Entscheiden Sie, ob geprüft werden soll, ob die Variable bereits Daten enthält, und ob der Kontakt die Eingabe überspringen darf.
In unserem Beispiel wird der Kontakt gebeten, den Namen seines Haustiers einzugeben. Die Eingabe wird vorübergehend in der Variablen „pet-name“ gespeichert. Das System prüft, ob die Variable in den benutzerdefinierten Kontaktfeldern bereits vorhanden und ausgefüllt ist. Der Kontakt kann die Eingabe überspringen.
Capture text, Capture email, Capture regex und Capture media verwenden dieselbe Einstellung zum Überspringen. Aktivieren Sie „Optional“, damit Kontakte den Schritt überspringen können. Geben Sie unter „Skip button label“ den Text des Buttons ein, zum Beispiel „Skip“. Die Beschriftung darf bis zu 20 Zeichen lang sein; beim Aktivieren von „Optional“ wird „Skip“ vorausgefüllt.
Der Kontakt sieht den Button anschließend unter Ihrer Nachricht und überspringt den Schritt durch Anklicken. Der Workflow folgt dem Ausgang „When the input is skipped“. Wenn Sie „Skip button label“ leer lassen, wird kein Button angezeigt und Kontakte können den Schritt nur durch Eingabe eines Überspringen-Schlüsselworts überspringen, sofern Ihr Workflow solche Schlüsselwörter enthält.
Der Button wird im Website Messenger, in WhatsApp und im Facebook Messenger angezeigt. In allen anderen Kanälen sieht der Kontakt nur Ihre Nachricht und kann den Schritt ausschließlich durch Eingabe eines Überspringen-Schlüsselworts überspringen. Die Eingabe eines solchen Schlüsselworts überspringt den Schritt auch dann, wenn der Button angezeigt wird. Jeder andere Text, einschließlich „1“, wird als Antwort auf die Frage behandelt.
WhatsApp list
Verwenden Sie diesen Node, damit Ihre Kontakte in WhatsApp-Kanälen aus einer vordefinierten Liste von Optionen auswählen können. Es können bis zu 10 Optionen als Liste angezeigt werden.
WhatsApp quick response
Dieser Node wird analog zum Node „Capture buttons“ verwendet, wenn Sie den Chatbot in WhatsApp-Kanälen einsetzen möchten. Es können bis zu 3 Buttons bzw. Optionen angezeigt werden.
Was passiert, wenn ein Kontakt mit einer Sprachnachricht antwortet?
Ein Kontakt kann einen wartenden Node auch mit einer Sprachnachricht oder Audiodatei beantworten. Lime Connect transkribiert die Aufnahme und der Workflow verwendet den Text so, als hätte der Kontakt ihn eingegeben. Die Transkription ist in jeder Organisation aktiviert, sofern sie nicht ausgeschaltet wurde. Wie Sie sie ausschalten und wie viel Audiomaterial pro Tag transkribiert wird, ist im Abschnitt „Voice messages“ des Message Centers beschrieben.
So verarbeitet jeder Node den Text einer Sprachnachricht:
- Capture text, Capture email und Capture regex: Der Text wird wie eine eingegebene Antwort geprüft. Ist er gültig, folgt der Workflow „If contact provided valid value“ und speichert den Text in der Variablen des Nodes. Andernfalls folgt er „If contact provided invalid value“. Dies geschieht zum Beispiel, wenn der Kontakt eine E-Mail-Adresse laut ausspricht und im Text „name at example dot com“ statt „name@example.com“ steht.
- Capture buttons, Capture carousel, WhatsApp list und WhatsApp quick response: Eine Sprachnachricht wählt niemals eine Option aus, auch wenn der Kontakt ihren Namen nennt. Der Workflow folgt „If the contact does not respond or types any message“.
- Capture media: Der Text wird nicht verwendet und kann diesen Node nicht überspringen. Die Aufnahme selbst zählt als Datei: Der Workflow folgt „If contact provided valid media“, wenn der Node Audiodateien akzeptiert, und „If contact provided invalid media“, wenn er nur einen anderen Dateityp akzeptiert.
Wenn eine Aufnahme nicht transkribiert werden kann, zum Beispiel weil die Transkription fehlgeschlagen oder das tägliche Kontingent aufgebraucht ist, folgen Capture text, Capture email und Capture regex „If contact provided invalid value“ und speichern nichts. Ist dieser Ausgang nicht verbunden, wartet der Node weiter. Die Nodes mit Optionen warten in diesem Fall immer weiter. Ist die Transkription für Ihre Organisation ausgeschaltet, beantwortet eine Sprachnachricht diese Nodes überhaupt nicht und der Node wartet weiter.
Der Text beantwortet nur einen Node, der bereits wartete, als der Kontakt die Sprachnachricht gesendet hat. Wenn der Workflow zwischenzeitlich fortgeschritten ist, etwa weil der Kontakt vor Fertigstellung der Transkription eine Antwort eingegeben hat, wird der Text der Sprachnachricht nicht verwendet.