Benutzerdefiniertes Event

Der Trigger startet einen Flow, sobald ein externes System ein Event an die Epic AI Platform API sendet. So löst du Flows durch externe Dienste wie Zapier, Make oder eigene API-Integrationen aus.

Wo finde ich das?

Den Trigger findest du im Flow Builder über das seitliche Panel:

1. Öffne einen Flow im Flow Builder.

2. Klicke auf „Schritt hinzufügen", um das Side Panel zu öffnen.

3. Scrolle zum Abschnitt „Trigger".

4. Wähle „Benutzerdefiniertes Event" aus.

---

Erklärung – Was ist der Trigger „Benutzerdefiniertes Event"?

Der Trigger „Benutzerdefiniertes Event" gehört zur Kategorie der Flow-Trigger. Er wartet auf ein Event, das von einem externen System über die Epic AI Platform API an eine bestimmte Konversation gesendet wird. Sobald das Event eintrifft und dessen Name exakt mit dem im Trigger hinterlegten Namen übereinstimmt, wird der zugehörige Flow gestartet.

Der zugehörige API-Endpunkt lautet:

/chatbots/{chatbotId}/conversations/custom-event

Typische externe Auslöser sind:

• Zapier oder Make: Zur Verbindung mit anderen Tools und Diensten

• Eigene API-Integrationen: Beispielsweise aus einem CRM, Shop-System oder Telefonie-Dienst

Der im Trigger hinterlegte Event-Name muss exakt mit dem Event-Namen übereinstimmen, den das externe System an den Endpunkt sendet – inklusive Groß- und Kleinschreibung. Stimmen die Namen nicht überein, wird der Trigger nicht ausgelöst.

Jeder Event-Name kann innerhalb eines AI Agents nur einmalig als „Benutzerdefiniertes Event"-Trigger verwendet werden.

---

Verwendung – Was kann man damit machen?

Mit dem Trigger „Benutzerdefiniertes Event" lassen sich Flows aus externen Systemen heraus starten. Typische Anwendungsfälle:

• Telefonie-Events verarbeiten: Ein Anruf wird beendet und das externe System sendet das Event voice_hangup an die API. Der Trigger startet daraufhin einen Flow, der z. B. eine Zusammenfassung des Gesprächs erstellt oder eine Folge-Nachricht versendet. Hinweis: Das Event voice_hangup ist bei uns integriert und kann ohne Anbindung als Benutzerdefinierter Trigger verwendet werden.

• CRM-Ereignisse einbinden: Ein CRM-System sendet ein Event, wenn sich der Status eines Kontakts ändert – z. B. deal_closed –, und löst damit einen Nachfass-Flow aus.

• Automatisierungen über Zapier oder Make: Ein externer Dienst sendet bei einem bestimmten Ereignis ein Event an die Epic AI Platform und startet so einen definierten Prozess.

---

Verwaltung – Erstellung, Bearbeitung und Löschen

Trigger erstellen

1. Öffne den gewünschten Flow im Flow Builder.

2. Klicke auf „Schritt hinzufügen" im Side Panel.

3. Wähle unter „Trigger" den Eintrag „Benutzerdefiniertes Event" aus.

4. Es öffnet sich das Bearbeitungspanel des Triggers.

5. Vergib einen aussagekräftigen Namen für den Trigger, z. B. Event: voice_hangup.

6. Optional: Füge eine Beschreibung hinzu, um den Zweck des Triggers zu dokumentieren.

7. Trage im Feld „Name des Events" den exakten Event-Namen ein, den das externe System senden wird – z. B. voice_hangup.

8. Bestätige mit „Ok".

Der Event-Name im Feld „Name des Events" muss exakt mit dem Event übereinstimmen, das das externe System an den Endpunkt sendet.

Trigger bearbeiten

1. Öffne den Flow, in dem der Trigger hinterlegt ist.

2. Klicke auf den Trigger-Schritt im Flow Builder, um das Bearbeitungspanel zu öffnen.

3. Passe Name, Beschreibung oder den Event-Namen an.

4. Bestätige mit „Ok".

Trigger löschen

1. Öffne das Bearbeitungspanel des Triggers.

2. Klicke auf das Papierkorb-Symbol oben rechts im Bearbeitungspanel.

Nach dem Löschen des Triggers werden eingehende Events dieses Namens nicht mehr verarbeitet. Stelle sicher, dass das externe System entsprechend angepasst wird, um unnötige API-Aufrufe zu vermeiden.

---

Beispiel

Szenario: Sobald ein Deal in einem externen CRM-System als abgeschlossen markiert wird, soll automatisch eine Glückwunsch-Nachricht an den Nutzer gesendet werden.

Voraussetzung: Das CRM-System ist so konfiguriert, dass es bei Abschluss eines Deals das Event deal_closed an den Endpunkt /chatbots/{chatbotId}/conversations/custom-event sendet.

Schritte:

1. Öffne den zuständigen Flow im Flow Builder.

2. Klicke auf „Schritt hinzufügen" und wähle unter „Trigger" den Eintrag „Benutzerdefiniertes Event" aus.

3. Vergib den Namen Event: Deal Closed.

4. Trage im Feld „Name des Events" den Wert deal_closed ein.

5. Bestätige mit „Ok".

6. Füge als nächsten Schritt im Flow eine Aktion hinzu – z. B. eine Nachricht an den Nutzer mit einer Bestätigung des erfolgreichen Abschlusses oder einem Hinweis auf die nächsten Schritte.

Ergebnis: Sobald das CRM-System nach dem Abschluss eines Deals das Event deal_closed an die API sendet, wird der Flow gestartet und die Nachricht automatisch versendet.

---

Best Practices

• Wähle Event-Namen, die den auslösenden Vorgang klar beschreiben – z. B. voice_hangup oder deal_closed. Das erleichtert die Orientierung, wenn mehrere benutzerdefinierte Events im AI Agent existieren.

• Dokumentiere im Beschreibungsfeld des Triggers, welches externe System das Event sendet und unter welchen Bedingungen. So behalten alle Teammitglieder den Überblick, auch wenn sie die externe Integration nicht selbst eingerichtet haben.

• Stimme Event-Namen frühzeitig mit den verantwortlichen Personen für die externe Integration ab. Eine nachträgliche Umbenennung erfordert Anpassungen sowohl im Trigger als auch im externen System.

• Überprüfe nach dem Löschen oder Umbenennen eines Triggers, ob das externe System weiterhin Events an den Endpunkt sendet – und passe die Integration entsprechend an, um Fehler zu vermeiden.