💡
Sie können alle Screenshots durch Anklicken vergrößern. Die Screenshots zeigen jeweils die Node selbst sowie das dazugehörige Einstellungs-Menü.

Start Conversation

Ein Workflow kann auf fünf Arten starten: wenn der Kontakt eine Unterhaltung beginnt, durch einen externen Trigger mittels Webhook Call (momentan im Beta-Status), durch die Übergabe eines Connect AI Agents, zeitbasiert anhand eines Datums am Kontakt oder manuell, wenn ein Operator den Workflow für einen Kontakt startet. Die Art legen Sie in der Start-Node unter Trigger-Typ fest.

Start durch neue Unterhaltung, ausgelöst durch den Kontakt

Nehmen wir an Sie betreiben eine Website. Auf dieser ist unser Website-Chat eingebunden. Ein Kontakt startet über den Chat-Button eine Unterhaltung. Ein mit dem Workflow verknüpfter Chatbot geht den vorgegebenen Ablauf mit dem Kunden durch
Diese Node ist standardmäßig in jedem Worfkow enthalten und kann in diesem Status nicht weiter konfiguriert werden.
Image without caption

Start durch externen Trigger

Nehmen wir nun auf der anderen Seite an, Sie nutzen ein System unabhängig von Lime Connect, auf dessen Datenbasis Sie einen automatisierten Workflow in Lime Connect auslösen möchten.
Nicht der Kontakt startet also in diesem Fall den Workflow, sondern ein vorher festgelegtes (programmiertes) Ereignis in Ihrem Drittsystem, welches per Schnittstelle an Lime Connect übertragen wird.
💡
Sofern Sie den Workflow durch einen externen Trigger starten möchten, benötigen Sie Programmiererfahrung und Erfahrungen im Handling von Schnittstellen.
Momentan kann der Webhook-Trigger nur in Kombination mit Whatsapp Template Nodes verwendet werden.
Hier konfigurieren Sie die Webhook URL sowie den Authorization Header. Auch geben Sie die erwarteten Datenfelder an, die an Ihr System übertragen werden.
Image without caption
Anwendungsbeispiel (öffnen durch Klick auf den Pfeil links)

Start durch Übergabe eines Connect AI Agents

Sie können ebenfalls eine Übergabe der laufenden Unterhaltung durch Ihren Connect AI Agent an einen Workflow veranlassen. Die Start-Node muss dafür mit dem entsprechenden Typ belegt werden.
Sie können bei Bedarf auch Daten, auf die Ihr AI Agent Zugriff hat, hier an Ihren Workflow übergeben. Diese Daten stehen dann als Variablen innerhalb des Workflows zur Verfügung.
Image without caption

Start zeitbasiert anhand eines Kontaktfeldes

Ein Workflow kann auch zu einem Zeitpunkt starten, der bereits am Kontakt gespeichert ist. Der typische Fall ist eine Geburtstagsnachricht, die jedes Jahr am Geburtstag des Kontakts verschickt wird.
Stellen Sie in der Start-Node den Trigger-Typ auf Zeitbasiert vom Kontakt. Die weiteren Optionen sind Bei Unterhaltungsbeginn, Bei Webhook-Aufruf, Bei Connect AI-Übergabe und Manuell gestartet.
Die Start-Node mit dem Trigger-Typ „Zeitbasiert vom Kontakt“
Die Start-Node mit dem Trigger-Typ „Zeitbasiert vom Kontakt“
Prüfen Sie vor der Auswahl, ob das Feld überhaupt in Frage kommt. Geeignet sind nur Kontaktfelder mit der Art der Eingabe Datum oder Datum und Uhrzeit. Die Art der Eingabe eines gespeicherten Feldes lässt sich nachträglich nicht ändern. Ein Geburtstag, der in einem Textfeld steht, muss daher unter Einstellungen > Chat-Tools > Datenfelder als Datumsfeld neu angelegt werden.
Unter Ausführen anhand von klicken Sie auf Kontaktvariable auswählen und wählen das Feld, in dem das Datum steht. Die Auswahl zeigt nur die geeigneten Felder, und die Reiter für Unterhaltungs- und Workflow-Variablen erscheinen gar nicht.
Die Variablenauswahl zeigt nur die Datumsfelder des Kontakts
Die Variablenauswahl zeigt nur die Datumsfelder des Kontakts
Mit Uhrzeit legen Sie fest, zu welcher Uhrzeit der Workflow läuft, ohne Änderung um 9:00 Uhr. Es können nur 30-Minuten-Schritte ausgewählt werden.
Mit Offset verschieben Sie die Ausführung gegenüber dem Datum selbst. Kein Offset führt am Datum selbst aus. Mit Davor oder Danach verschieben Sie sie und geben eine Anzahl und eine Einheit an. Ein Feld mit der Art der Eingabe Datum bietet nur Tage. Ein Feld mit Datum und Uhrzeit bietet zusätzlich Minuten und Stunden, weil es selbst eine Uhrzeit enthält.
Jährlich wiederholen führt den Workflow jedes Jahr an diesem Datum aus. Die Option ist zunächst aus, eine Geburtstagsnachricht braucht sie also eingeschaltet. Lassen Sie sie aus, wenn das Datum nur einmal auslösen soll, etwa ein Anmeldedatum.

Start manuell durch einen Operator

Mit dem Trigger-Typ Manuell gestartet startet ein Operator den Workflow von Hand für einen bestimmten Kontakt, direkt aus dessen Kontaktprofil im Message Center. Das eignet sich für Abläufe, die nicht von selbst beginnen sollen, sondern erst, wenn jemand in Ihrem Team es entscheidet. Beim Start kann der Operator Werte mitgeben, zum Beispiel eine Auftragsnummer, die der Workflow anschließend verwendet.
Wer den Workflow baut, richtet ihn im Workflow-Editor ein: die Start-Node, dann das Aktivieren und die Verbindung mit einem Chatbot. Operatoren starten ihn anschließend aus dem Profil eines Kontakts im Message Center.
Verwechseln Sie diesen Trigger nicht mit dem Start durch eine neue Unterhaltung weiter oben: Dort beginnt der Kontakt die Unterhaltung, hier startet ein Operator den Workflow.
Setzen Sie beim Bau des Workflows WhatsApp-Nachrichtenvorlage senden vor jede Node, die eine Unterhaltung braucht. Ein manuell gestarteter Workflow läuft für den Kontakt und beginnt ohne Unterhaltung. Nur diese Node öffnet eine, indem sie dem Kontakt eine genehmigte WhatsApp-Vorlage über einen Ihrer WhatsApp-Kanäle schickt. Sie ist auf der Seite "Nodes zur Ausführung von Aktionen" beschrieben. Die Node danach läuft sofort weiter und wartet nicht auf eine Antwort.
Die Vorlage wird nur gesendet, wenn Sie einen WhatsApp-Kanal mit einer genehmigten Vorlage haben und der Kontakt nicht blockiert ist und eine Mobilnummer hat, die WhatsApp nutzt. Ohne WhatsApp-Kanal kann ein manuell gestarteter Workflow nur Nodes verwenden, die keine Unterhaltung brauchen.
Von den Nodes auf dieser Seite brauchen Message (in der Oberfläche "Nachricht") und Trigger add-on ("Add-on auslösen") eine Unterhaltung. Keyword listener ("Keyword-Listener") wartet auf eine Nachricht des Kontakts in der Unterhaltung. Setzen Sie alle drei hinter die Vorlagen-Node. Condition ("Bedingung") braucht keine Unterhaltung, ebenso wenig Nodes, die nur den Kontakt betreffen, etwa Kontakt-Update (Seite "Nodes zur Ausführung von Aktionen") oder API-Request (Seite "Nodes zum Sammeln von Kontaktinformationen").
Wählen Sie den Trigger-Typ vor allem anderen in der Start-Node: Ein späterer Wechsel setzt die Node zurück und löscht alle Einstellungen des bisherigen Typs, auch die Eingabevariablen.
Öffnen Sie den Workflow im Workflow-Editor, klicken Sie auf die Start-Node und wählen Sie unter Trigger-Typ die Option Manuell gestartet.
Unter Eingabevariablen legen Sie fest, welche Werte der Operator beim Start eingibt; brauchen Sie keine, lassen Sie den Abschnitt leer. Klicken Sie für jeden Wert auf Variable hinzufügen und geben Sie der Variable einen Namen, zum Beispiel "auftragsnummer". Ein Name darf nur die lateinischen Buchstaben a bis z und A bis Z, Ziffern, "-" und "_" enthalten, und jeder Name darf nur einmal vorkommen. Für jede Variable stellen Sie außerdem ein:
  • Erforderlich: Ist das Häkchen gesetzt, kann der Operator den Workflow erst starten, wenn er einen Wert eingegeben hat. Neue Variablen sind zunächst erforderlich.
  • Typ: String für Text oder Zahl. Ein Feld vom Typ Zahl nimmt beim Start nur Zahlen an, auch Dezimalzahlen und negative Zahlen. Dieser "Typ" legt fest, was der Operator eingeben darf; der Trigger-Typ oben legt fest, wie der Workflow startet.
  • Beschreibung: ein Hinweis für den Operator, was er eintragen soll. Er sieht ihn beim Start über das Info-Symbol neben dem Feldnamen.
Image without caption
Lässt der Operator ein optionales Feld leer, bleibt die Variable leer: Eine Node Nachricht zeigt an ihrer Stelle nichts an, und eine Node WhatsApp-Nachrichtenvorlage senden, die sie als Platzhalter verwendet, schlägt fehl. Machen Sie eine Variable erforderlich, wenn eine Vorlage sie braucht.
In den Nodes nach der Start-Node finden Sie die Eingabevariablen in der Variablenauswahl im Reiter Dieser Workflow, zum Beispiel "auftragsnummer" als Platzhalter in einer WhatsApp-Vorlage. Weil der Workflow für einen Kontakt läuft, können Sie außerdem die Felder des Kontakts verwenden.
Ist der Workflow fertig, schalten Sie oben im Workflow-Editor den Schalter Aktiv ein und bestätigen Sie mit Aktivieren.
Image without caption
Danach müssen Sie den Workflow einem Chatbot zuweisen, wie auf der Seite Workflows unter "Weisen Sie Ihren Workflow einem Chatbot zu" beschrieben: Legen Sie einen Chatbot mit dem Bot-Typ "WORKFLOW" an oder öffnen Sie einen bestehenden. Ein Chatbot hat genau einen verbundenen Workflow; wählen Sie diesen Workflow bei einem bestehenden Chatbot, ersetzt er dessen bisherigen.
Wählen Sie den Workflow unter Verbundener Workflow aus und klicken Sie auf Speichern. Dort lassen sich nur aktive Workflows auswählen, deshalb aktivieren Sie zuerst. Ohne diesen Chatbot lässt sich der Workflow nicht starten, und Nachrichten, die der Workflow sendet, erscheinen in der Unterhaltung als von diesem Chatbot gesendet.
Image without caption
Die folgenden Schritte sind für Operatoren; wer den Workflow gebaut hat, kann ihn damit testen. Den Button Workflow ausführen sehen alle Operatoren, sobald Workflows für Ihr Konto gebucht sind; eine eigene Berechtigung zum Starten gibt es nicht.
Öffnen Sie im Message Center das Profil des Kontakts, zum Beispiel über Kontakte in der Navigation. Die Reiterzeile zeigt Profil, Unterhaltungen und, je nach Rolle, Workflows. Rechts davon finden Sie den Button Workflow ausführen.
Image without caption
Klicken Sie auf Workflow ausführen. Wählen Sie im gleichnamigen Fenster unter Workflow den gewünschten Workflow aus. Die Liste zeigt alle aktiven Workflows mit dem Trigger-Typ Manuell gestartet. Hat der Workflow Eingabevariablen, erscheint für jede ein Feld mit ihrem Namen, und Pflichtfelder sind markiert.
Der Start führt den Workflow wirklich aus: Die WhatsApp-Vorlage geht an den Kontakt. Nehmen Sie zum Testen einen Kontakt mit Ihrer eigenen Mobilnummer. Jeder Klick auf Starten startet eine weitere Ausführung. Eine einzelne Ausführung lässt sich im Kontaktprofil nicht stoppen; Ausführungen lassen sich nur alle zusammen stoppen, indem Sie den Workflow mit "Aktive Ausführungen stoppen & deaktivieren" deaktivieren.
Füllen Sie die Felder aus und klicken Sie auf Starten. Leere optionale Felder werden nicht übergeben.
Image without caption
Nach dem Start sehen Sie den Hinweis "Workflow gestartet". Der Kontakt bemerkt davon nichts, bis der Workflow ihm etwas schickt, etwa die WhatsApp-Vorlage.
Ob es geklappt hat, sehen Sie im Reiter Workflows des Kontaktprofils. Ihn sehen nur Operatoren, deren Rolle Workflows ansehen darf; sehen Sie ihn nicht, fragen Sie jemanden mit dieser Berechtigung. Jede Ausführung steht dort mit ihrem Status: Aktiv, Wartend, Beendet oder Fehler. Ein Klick auf den Namen des Workflows öffnet die Workflow-Aktivität mit dem Ausführungsprotokoll; Details anzeigen an einem Schritt zeigt die Node und ihren Fehler.
Image without caption
Wenn Sie einen Workflow nicht starten können:
  • Sie sehen den Button "Workflow ausführen" nicht: Workflows sind für Ihr Konto nicht gebucht.
  • "Es gibt keine aktiven Workflows mit manuellem Trigger. Erstellen und aktivieren Sie einen im Workflow Builder, um ihn hier auszuführen.": Kein Workflow hat zugleich den Trigger-Typ Manuell gestartet und den Status Aktiv. Bitten Sie die Person, die den Workflow gebaut hat, ihn zu aktivieren.
  • "Um diesen Workflow auszuführen, verbinden Sie ihn in den Chatbot-Einstellungen mit einem Workflow-Bot." nach dem Klick auf Starten: Kein Chatbot hat diesen Workflow als Verbundener Workflow. Die Person, die den Workflow gebaut hat, muss ihn einem Chatbot zuweisen, wie auf der Seite Workflows unter "Weisen Sie Ihren Workflow einem Chatbot zu" beschrieben.
  • "Starten" bleibt ausgegraut: Es ist noch kein Workflow gewählt, oder ein Pflichtfeld ist leer.
  • "Bitte geben Sie eine Zahl ein.": Das Feld gehört zu einer Variable vom Typ Zahl. Geben Sie nur eine Zahl ein.
Steht eine Ausführung auf Fehler, nennt das Ausführungsprotokoll die Node, die fehlgeschlagen ist. Häufige Ursachen und was hilft:
  • Eine Node Nachricht oder Add-on auslösen kam vor der Vorlage: Setzen Sie WhatsApp-Nachrichtenvorlage senden davor.
  • Der Kontakt ist blockiert: An blockierte Kontakte werden keine Vorlagen gesendet.
  • Der Kontakt hat keine Mobilnummer: Tragen Sie die Mobilnummer im Kontaktprofil ein und starten Sie erneut.
  • Die Mobilnummer nutzt kein WhatsApp: Prüfen Sie die Nummer im Kontaktprofil.
  • Der WhatsApp-Kanal ist gesperrt oder ungültig: Prüfen Sie den WhatsApp-Kanal in Ihren Kanaleinstellungen.
  • Die in der Node gewählte Vorlage ist auf ihrem WhatsApp-Kanal nicht genehmigt: Wählen Sie in der Node eine genehmigte Vorlage.
  • Ein Platzhalter der Vorlage blieb leer, etwa durch eine leere optionale Eingabevariable: Machen Sie die Variable erforderlich oder füllen Sie das Feld beim Start aus.
  • Die WhatsApp-Unterhaltung des Kontakts hat bereits einen aktiven Workflow: Warten Sie, bis dieser beendet ist, und starten Sie dann erneut.
Wenn die Start-Node einen Fehler zeigt:
  • "Dieses Feld darf nur alphanumerische Zeichen, „-“ oder „_“ enthalten.": Der Variablenname enthält ein anderes Zeichen, etwa ein Leerzeichen oder "ä". Benennen Sie die Variable um.
  • "Dieser Variablenname wird bereits verwendet.": Zwei Eingabevariablen haben denselben Namen. Benennen Sie eine davon um.

Condition

Nutzen Sie diese Node, wenn Sie verschiedene Wege basierend auf einer Bedingung für den Kontakt anbieten wollen. In unserem Beispiel: Alle Kontakte, deren Email-Adresse “company1” beinhalten, gehen Weg A, alle anderen Kontakte gehen Weg B.
Die Bedingungen werden vom System von oben nach unten ausgeführt, solange, bis eine Bedingung zutrifft. Alle Bedingungen danach werden nicht mehr ausgeführt.
Image without caption

Keyword listener

Nutzen Sie diese Node, wenn Sie eine Aktion basierend auf von Ihnen festgelegten Keywords ausführen möchten. In unserem Beispiel: Sobald der Kontakt das Keyword “Support” sendet, wird die danach verbundene Aktion ausgelöst.
In einem manuell gestarteten Workflow wartet diese Node auf eine Nachricht des Kontakts in der Unterhaltung. Setzen Sie sie deshalb hinter die Node "WhatsApp-Nachrichtenvorlage senden", siehe "Start manuell durch einen Operator".
Image without caption

Message

Nutzen Sie diese Node, wenn Sie Ihren Kontakten einen oder mehrere Textblöcke ausspielen möchten. Sie können auch Buttons oder Medien hinzufügen.
In unserem Beispiel: Der Kontakt bekommt nach Ausgabe des Textes zwei klickbare Buttons angezeigt, die ihn zur hinterlegten URL führen.
In einem manuell gestarteten Workflow funktioniert diese Node erst, nachdem eine WhatsApp-Vorlage die Unterhaltung geöffnet hat, sonst endet die Ausführung mit "Fehler". Siehe "Start manuell durch einen Operator".
Image without caption

Trigger add-on

Nutzen Sie diese Node, wenn Sie während der Unterhaltung ein von uns angebotenes Add-On triggern möchten.
In unserem Beispiel: Das Lime CRM Addon wird ausgelöst und die Unterhaltung wird in ein Lime CRM Objekt umgewandelt. Dies geschieht im Hintergrund.
In einem manuell gestarteten Workflow funktioniert diese Node erst, nachdem eine WhatsApp-Vorlage die Unterhaltung geöffnet hat, sonst endet die Ausführung mit "Fehler". Siehe "Start manuell durch einen Operator".
Image without caption

Verzögerung

Nutzen Sie diese Node, wenn der Workflow eine gewisse Zeit warten soll, bevor die nächste Node ausgeführt wird. Geben Sie unter Wartezeit eine ganze Zahl ein und wählen Sie die Einheit: Sekunden, Minuten, Stunden oder Tage.
Image without caption
Um die Wartezeit stattdessen aus einer Variable zu übernehmen, aktivieren Sie Variable verwenden und wählen Sie eine Variable aus, die die Wartezeit in Sekunden enthält. Wenn eine feste Wartezeit länger als 24 Stunden ist und danach eine Node folgt, die eine Nachricht sendet, zeigt der Editor eine Warnung an: WhatsApp erlaubt keine frei formulierten Nachrichten mehr als 24 Stunden nach der letzten Nachricht des Kontakts. Verwenden Sie daher stattdessen eine WhatsApp-Vorlage.