Workflow-Auslöser

Workflow-Trigger

Ein Trigger ist ein Ereignis, das einen Workflow initiiert. Jeder Workflow muss mit einem Trigger beginnen und kann nur einen Trigger haben. Alle Trigger sind durch Bedingungen definiert. Ein Trigger wird nur ausgelöst und initiiert einen Workflow, wenn alle Bedingungen erfüllt sind.

Beginne mit der Erstellung deines Workflows, indem du den Trigger auswählst und ihn entsprechend konfigurierst.

Hier ist die Liste der verfügbaren Trigger:

Nachdem der Trigger festgelegt wurde, fahre mit der Schrittkonfiguration fort. Wählen Sie einen beliebigen der verfügbaren Schritte aus.

Erweiterte Einstellungen

Jede Triggereinstellung verfügt unten über einen Schalter für erweiterte Einstellungen, der den Trigger einmal pro Kontakt angibt (außer beim manuellen Trigger). Dadurch wird verhindert, dass Kontakte diesen Workflow jemals wiederholen, sodass sie den Workflow-Ablauf nur einmal durchlaufen können.

Wenn der Schalter auf EIN steht, wird der Workflow für keinen Kontakt ausgelöst, der sich zuvor für diesen Workflow angemeldet hat, selbst wenn die Bedingung zum Zeitpunkt des Auftretens auf AUS gesetzt war.

Konfiguration des Triggers

Jeder Workflow muss mit einem Trigger beginnen und kann nur einen einzigen Trigger haben. Wenn die Auslösebedingungen erfüllt sind, wird der Workflow sequenziell für den auslösenden Kontakt ausgeführt.

Trigger: Konversation geöffnet

Startet den Workflow, wenn eine Konversation mit dem Kontakt geöffnet wird und alle Auslösebedingungen erfüllt sind.

Konfiguration

Die Auslösebedingung für diesen Workflow ist auf die Quelle beschränkt, die angibt, wie die Konversation geöffnet wurde. Wenn keine Bedingungen hinzugefügt werden, wird der Workflow immer dann ausgelöst, wenn eine Konversation geöffnet wird, unabhängig von der Quelle.

Die Quellen sind wie folgt:

Für jede Quelle sind maximal 10 Bedingungen mit den logischen Operatoren „UND“ oder „ODER“ zulässig. Jede Bedingung muss über eine eigene Quelle, einen Operator und einen Wert verfügen.

Triggervariablen

Alle Triggervariablen für den Trigger „Konversation geöffnet“ spiegeln Informationen wider, die sich auf die Konversation beziehen, beispielsweise die erste eingehende Nachricht der Konversation. Erfahre mehr über Trigger-Variablen für den Trigger „Gespräch eröffnet“ hier.

Trigger: Konversation geschlossen

Das Hinzufügen von Bedingungen zum Auslöser für das Schließen der Konversation ist optional. Wenn keine Bedingungen hinzugefügt werden, wird der Workflow immer dann ausgelöst, wenn eine Konversation geschlossen wird, unabhängig von der Quelle.

Startet den Workflow, wenn eine Konversation mit dem Kontakt geschlossen wird und alle Auslösebedingungen erfüllt sind.

Konfiguration

Es gibt zwei mögliche Auslösebedingungen für geschlossene Konversationen: Quelle, die angibt, wer die Konversation geschlossen hat, und Kategorie, die die Klassifizierung der Konversation angibt.

Die folgenden Quellen lösen diesen Workflow aus, wenn sie eine Konversation schließen:

Eine durch das Zusammenführen von Kontakten geschlossene Konversation löst KEINEN Workflow aus.

Dieser Workflow wird auch ausgelöst, wenn Konversationen im Zusammenhang mit bestimmten Kategorien geschlossen werden. Diese Kategorien werden im Abschnitt „Schlussbemerkungen“ der Plattform festgelegt. In Workflows werden sie als Auswahlmöglichkeiten im Dropdown-Menü für Werte angezeigt.

Für jede Quelle und Kategorie sind maximal 10 Bedingungen mit den logischen Operatoren „UND“ oder „ODER“ zulässig. Jede Bedingung muss über eine eigene Quelle, einen Operator und einen Wert verfügen.

Triggervariablen

Alle Triggervariablen für den Trigger „Konversation geschlossen“ spiegeln Informationen zur Konversation wider, beispielsweise die Zeit bis zur Konversation, die Zeit bis zur ersten Antwort und die Abschlusszusammenfassung der Konversation. Erfahre mehr über die Trigger-Variablen für den Trigger „Gespräch geschlossen“ hier.

Trigger: Kontakt-Tag aktualisiert

Startet den Workflow, wenn einem Kontakt bestimmte Tags hinzugefügt oder daraus entfernt werden.

Konfiguration

Um diesen Workflow zu konfigurieren, wählen Sie eine Aktion aus, die als Auslöser fungiert. Die Optionen gelten, wenn einem Kontakt ein Tag hinzugefügt wird oder wenn ein Tag aus dem Kontakt entfernt wird.

Wählen Sie als Nächstes die Tags aus, die die Bedingung(en) darstellen, die für die Initiierung des Workflows erfüllt werden müssen.

Das Importieren von Kontakten mit Tags oder benutzerdefinierten Feldern löst nicht automatisch Workflows aus. Um Workflows nach dem Importieren zu aktivieren, ist eine sekundäre Aktion erforderlich. Weitere Informationen zum Starten von Workflows nach dem Import finden Sie in unserer Entwickler-API oder in Integrationstools wie Make/Zapier.

Trigger: Kontaktfeld aktualisiert

Startet den Workflow, wenn ein angegebenes Kontaktfeld aktualisiert wird.

Konfiguration

Jeder Kontakt oder jedes benutzerdefinierte Feld kann als Auslöser für diesen Workflow konfiguriert werden. Wählen Sie das Kontaktfeld aus, das als Bedingung für diesen Auslöser fungiert. Jede Aktualisierung dieses Felds startet den Workflow.

Das Importieren von Kontakten mit Tags oder benutzerdefinierten Feldern löst nicht automatisch Workflows aus. Um Workflows nach dem Importieren zu aktivieren, ist eine sekundäre Aktion erforderlich. Weitere Informationen zum Starten von Workflows nach dem Import finden Sie in unserer Entwickler-API oder in Integrationstools wie Make/Zapier.

Trigger: Verknüpfung

Initiiert einen ausgewählten Workflow aus dem Kontextmenü im Modul Posteingang .

So funktioniert es

Mit „Shortcut“ ist ein Workflow gemeint, der mit dem Auslöser „Shortcut“ erstellt wird. Mit dieser Funktion können Benutzer Workflows starten, die über eine Verknüpfung als Auslöser verfügen, ohne das Modul Posteingang zu verlassen.

Klicken Sie im Modul Posteingang auf das Verknüpfungssymbol in der Symbolleiste des Nachrichten-Editors. Dadurch wird das Menü „Shortcuts“ geöffnet, in dem alle im Arbeitsbereich veröffentlichten Shortcuts angezeigt werden. Wählen Sie die gewünschte Verknüpfung aus, um den Workflow zu starten.

Das Verknüpfungssymbol wird deaktiviert, wenn im Arbeitsbereich keine Verknüpfungen erstellt und veröffentlicht wurden.

Wenn du nicht möchtest, dass Agents Shortcuts initiieren, deaktiviere dies in den Erweiterten Einschränkungseinstellungen unter den Benutzer-Einstellungen des Workspace​.

Konfiguration

Sie können Verknüpfungen mit individuellen Symbolen, Namen und Beschreibungen konfigurieren. Wenn das Menü „Verknüpfungen“ geöffnet wird, werden diese angezeigt, damit Sie die gewünschte Verknüpfung einfach identifizieren und auswählen können.

Verknüpfungsformular

In der Konfigurationsleiste des Shortcut-Triggers können Sie optional ein Shortcut-Formular erstellen. Jedes Mal, wenn die Verknüpfung ausgelöst wird, wird das Formular geöffnet. Der Workflow wird erst gestartet, nachdem das Formular vom Benutzer ausgefüllt wurde.

Das Shortcut-Formular kann mit Formularfeldern zur Eingabe von Daten oder Kommentaren angepasst werden. Die eingetragenen Werte können als Variablen gespeichert und im Workflow verwendet werden.

So fügen Sie ein Formularfeld hinzu:

1. Klicken Sie auf die Schaltfläche + Formularfeld hinzufügen.

2. Benennen Sie das Formularfeld. Beispielsweise Bestellnummer, Rückerstattungsgrund.

3. Wählen Sie den Feldtyp aus. Die verfügbaren Feldtypen sind:

• Text

• Liste (Dropdown)

• Kontrollkästchen

• Nummer

• Datum

• Zeit

• Telefonnummer

• E-Mail

• URL

4. Benennen Sie die Variable für dieses Feld.

5. Verwenden Sie die Ausgabevariablen in den Workflow-Schritten. Erfahre mehr über Ausgabevariablen hier.

6. Legen Sie das Formularfeld als erforderlich fest, indem Sie den Schalter Erforderlich auf EIN stellen. Dies macht es für Agenten verpflichtend, die Daten oder Kommentare auszufüllen.

Trigger: Eingehender Webhook

Initiiert den Workflow, wenn ein bestimmtes Ereignis in einer Drittanbieteranwendung auftritt und die Informationen per HTTP-Anfrage gesendet werden.

Dieser Trigger ist nur für Business-Plan und darüber hinaus verfügbar.

Konfiguration

Sobald du diesen Trigger auswählst, wird für jeden deiner Workflows eine einzigartige Webhook-URL automatisch generiert. Du sendest HTTP-POST-Anfragen an diese URL, um letztendlich den Workflow auszulösen.

Du musst dann den JSON-Schlüssel in deiner Nutzlast angeben, der dem Typ der Kontakt-Identifikation entspricht. Dadurch kann unser System erkennen, welcher Kontakt oder welche Kontakte durch den Workflow ausgelöst werden. Es gibt eine maximale Zeichenanzahl von 500.

Es gibt drei Haupttypen der Kontakt-Identifikation (wie wir einen Kontakt identifizieren):

• Kontakt-ID

• E-Mail

• Telefonnummer

Du kannst die Parameter in deiner eingehenden Webhook-Nutzlast auch als Variablen speichern, um sie in anderen Schritten des Workflows je nach Anwendungsfall zu verwenden.

Anforderungen:

• Der JSON-Schlüssel in deiner Nutzlast muss mit dem Text im JSON-Feld auf der Plattform übereinstimmen.

• Der gleiche JSON-Schlüssel kann nicht zweimal gespeichert werden; er muss einen definierten Wert haben (kein Objekt oder Array).

• Der JSON-Schlüssel hat eine maximale Zeichenanzahl von 500.

Du schließt den Prozess ab, indem du den JSON-Schlüsselwert in einer Variablen speicherst. Die Variable muss im Text eindeutig sein und hat eine maximale Zeichenanzahl von 30. Es sind maximal 10 Variablen zulässig. Bitte beachte, dass nur der JSON-Text gespeichert werden kann.

Beispiel

So füllst du den JSON-Schlüssel aus, um eine Antwort für verschiedene Antwortformate zu speichern:

{   
    "name": "Jason",   
    "zip\_codes": "12345",   
    "phone": "123123"   
}

Um die Telefonnummer im obigen JSON-Text zu speichern, verwende $.phone als JSON-Schlüssel.

{   
    "custom\_fields": {   
        "firstName": "John",   
        "lastName": "Doe",   
        "locale": "en\_GB",   
        "timezone": "5",   
        "gender": "männlich",   
        "phone": "123123",   
        "email": "zy@respond.io",   
        "customerid": "1"  
    },   
    "created\_at": 1575618542  
}

Um die Telefonnummer im obigen JSON-Text zu speichern, verwende $.custom_fields.phone.

{  
        "data": {  
            "id":"1776025372480910",  
            "contacts" : \[  
                {  
                    "firstName":"John",  
                    "lastName":"Doe",  
		    "locale": "en\_GB"  
                },  
                {  
                    "firstName":"Jane",  
                    "lastName":"Doe",  
		    "locale": "en\_GB"  
                }    
	    \]  
        }  
    }

Um den Vornamen ‚Jane‘ im obigen JSON-Text zu speichern, verwende $.data.contacts[1].firstName.

Trigger: Meta Click-to-Chat-Anzeigen

Initiiert den Workflow, wenn auf eine Facebook-Anzeige geklickt wird oder wenn eine mit der Anzeige verbundene Nachricht empfangen wird.

Konfiguration

Nachdem du diesen Trigger ausgewählt hast, verbinde dein Facebook-Konto, um ihn zu konfigurieren.

Sobald du mit Facebook verbunden bist, wähle das Werbekonto und die relevanten Anzeigen aus, mit denen der Trigger verknüpft werden soll.

Hier können nur Anzeigen ausgewählt werden, die im Anzeigenmanager erstellt und verwaltet werden. Wenn du Anzeigen innerhalb einer Meta-Anwendung, z.B. Meta Business Suite oder Instagram, erstellt hast, werden diese hier nicht zur Auswahl angezeigt.

Anzeigenauswahl

Wähle Alle Anzeigen, um sie auf alle aktuellen und zukünftigen Anzeigen im ausgewählten Werbekonto anzuwenden.

• Um dies zu aktivieren, wähle die Option „Alle Anzeigen“ aus der neuen segmentierten Steuerschaltfläche.

• Wenn diese Option ausgewählt ist, wird der Workflow automatisch für alle im ausgewählten Werbekonto verwalteten Anzeigen ausgelöst, einschließlich aller zukünftig hinzugefügten Anzeigen.

Wenn du bestimmte Anzeigen gezielt ansprechen möchtest, wähle die Option „Ausgewählte Anzeigen“, um Anzeigen manuell aus der Dropdown-Liste auszuwählen.

Trigger-Variablen

Wenn eine Meta Click-to-Chat-Anzeige ausgelöst wird, ruft respond.io Metadaten aus der Anzeige ab und speichert sie in Trigger-Variablen. Diese Variablen sind nützlich, um Nachrichten zu personalisieren, Leads weiterzuleiten und Kampagnendaten an externe Tools weiterzugeben.

Verfügbare Variablen:

Hinweis: Diese Variablen können null zurückgeben, abhängig von den von Meta empfangenen Metadaten. Sie sind nur während der Workflow-Ausführung nach der Auslösung der Anzeige verfügbar.

So funktioniert es

Verwende diese Variablen in jedem Workflow-Schritt, indem du mit einem Dollarzeichen $ darauf verweist. Beispielsweise:

• Sende eine personalisierte Nachricht: Hallo! Danke, dass du auf unsere Anzeige $clicktochat.ad_name geklickt hast!

• Füge den Kampagnennamen zu einem Google Sheet hinzu

• Verzweige Workflows basierend auf Kampagne oder Anzeigengruppe

Trigger: TikTok Messaging-Anzeigen

Initiiert den Workflow, wenn auf eine TikTok-Anzeige geklickt wird oder wenn eine mit der Anzeige verbundene Nachricht empfangen wird.

Konfiguration

Nachdem du diesen Trigger ausgewählt hast, verbinde dein TikTok-Werbekonto in den Integrationen, um ihn zu konfigurieren.

Sobald du mit TikTok verbunden bist, wähle das Werbekonto und die relevanten Anzeigen aus, mit denen der Trigger verknüpft werden soll.

Hier können nur Anzeigen ausgewählt werden, die im TikTok Ads Manager erstellt und verwaltet werden.

Anzeigenauswahl

Wähle Alle Anzeigen, um sie auf alle aktuellen und zukünftigen Anzeigen im ausgewählten Werbekonto anzuwenden.

• Um dies zu aktivieren, wähle die Option „Alle Anzeigen“ aus der neuen segmentierten Steuerschaltfläche.

• Wenn diese Option ausgewählt ist, wird der Workflow automatisch für alle im ausgewählten Werbekonto verwalteten Anzeigen ausgelöst, einschließlich aller zukünftig hinzugefügten Anzeigen.

Wenn du bestimmte Anzeigen gezielt ansprechen möchtest, wähle die Option „Ausgewählte Anzeigen“, um Anzeigen manuell aus der Dropdown-Liste auszuwählen.

Trigger-Variablen

Wenn eine TikTok-Anzeigeninteraktion den Workflow auslöst, ruft respond.io Metadaten über die Anzeige ab und speichert sie in Trigger-Variablen. Diese Variablen können im gesamten Workflow zur Personalisierung, Routing-Logik und Integration mit externen Tools (z. B. Google Sheets) verwendet werden.

Verfügbare Variablen:

Hinweis: Nicht alle Variablen sind möglicherweise für jede Anzeigeninteraktion verfügbar. Diese Variablen können null zurückgeben, wenn die Informationen nicht von TikTok bereitgestellt werden.

So funktioniert es

Verwende diese Variablen in jedem Workflow-Schritt, indem du mit einem Dollarzeichen $ darauf verweist. Zum Beispiel:

• Tag hinzufügen: $tiktokmessagingad.ad_campaign_name

• Benutzerdefiniertes Feld aktualisieren

• Metadaten per HTTP-Anfrage oder Google Sheets an externe Apps übergeben

Trigger: Manueller Auslöser

Der manuelle Auslöser kann nicht eigenständig funktionieren. Er kann nur über den Schritt „Einen anderen Workflow auslösen“ ausgeführt werden.

Erfahre mehr über den Schritt „Einen anderen Workflow auslösen“ hier.

Wenn du zwei oder mehr Workflows mit dem Schritt „Einen anderen Workflow auslösen“ verbindest, kannst du den manuellen Auslöser für die mit dem ursprünglichen Workflow verbundenen Workflows verwenden. Das bedeutet, dass die verbundenen Workflows nur funktionieren, wenn ein Kontakt über den Schritt „Einen anderen Workflow auslösen“ in den Workflow eintritt.

Konfiguration

Der manuelle Auslöser kann nur mit dem Schritt „Einen anderen Workflow auslösen“ verwendet werden.

Nehmen wir an, Workflow A wurde mit dem manuellen Auslöser erstellt und ist mit Workflow B verbunden. Workflow A wird nur ausgelöst, wenn Workflow B veröffentlicht wird und ein Kontakt über den Schritt „Einen anderen Workflow auslösen“ in Workflow A eintritt.

Trigger: Lebenszyklus aktualisiert

Der Auslöser „Lebenszyklus aktualisiert“ initiiert einen Workflow, wann immer sich die Lebenszyklusphase eines Kontakts ändert. Dies ermöglicht es dir, Aktionen basierend auf dem Fortschritt des Kontakts durch deine Verkaufsphasen zu automatisieren, z.B. Lead-Qualifizierung, Nachverfolgungen oder Kundenbindungsmaßnahmen.

Konfiguration

Lebenszyklus in den Einstellungen aktivieren

Stelle sicher, dass die Lebenszyklusfunktion in deinen Workspace-Einstellungen aktiviert ist. Wenn der Lebenszyklus nicht aktiviert ist, musst du ihn einschalten, bevor du diesen Auslöser konfigurierst.

Lebenszyklusphase(n) auswählen

Wähle nach der Auswahl dieses Auslösers die Lebenszyklusphase(n) aus, die den Workflow initiieren werden.

• Alle Phasen: Löst den Workflow immer aus, wenn die Phase eines Kontakts aktualisiert wird, unabhängig von der spezifischen Phase.

• Bestimmte Phasen: Löst den Workflow nur aus, wenn die Phase eines Kontakts auf eine oder mehrere ausgewählte Phasen aktualisiert wird. Du kannst nach Bedarf eine oder mehrere Phasen auswählen.

Erweiterte Einstellungen konfigurieren (optional)

• Auslösen bei Löschung: Du kannst diese Einstellung optional aktivieren, um den Workflow auszulösen, wenn die Lebenszyklusphase eines Kontakts gelöscht wird und keine zugewiesene Phase mehr vorhanden ist.

• Einmal pro Kontakt auslösen: Wenn aktiviert, wird sichergestellt, dass der Workflow nur einmal für jeden Kontakt ausgelöst wird, selbst wenn er die ausgewählte Phase erneut betritt.

Nutze unsere Google Sheets-Vorlage, um wichtige Daten zu erfassen und die Konversionsraten mit dem Aktualisierungs-Lifecycle-Schritt zu verfolgen.