Der Loop in teammate / agent Schritt ermöglicht es Fin, mitten im Prozess zu pausieren und auf eine menschliche Entscheidung zu warten, bevor er fortfährt. Fin sendet eine Benachrichtigung an ein externes System Ihrer Wahl – jemand prüft die Anfrage, eine Entscheidung wird zurückgesendet, und Fin setzt dort fort, wo es aufgehört hat.
Wann der eigenständige HITL webhook verwendet wird
Der Loop in teammate / agent Schritt hat zwei Hauptanwendungen:
Menschliche Aufsicht – für risikoreiche oder wertvolle Aktionen, bei denen ein Mensch prüfen und genehmigen muss, bevor Fin fortfährt. Beispiele: Rückerstattungen oder Ausnahmegenehmigungen, compliance-sensitive Anfragen (z. B. Kontoschließungen, Datenlöschung), wertvolle Kundeneskalationen, Kulanzgesten oder jede Situation, in der eine menschliche Freigabe erforderlich ist.
Prozesstests – um einen Datenconnector oder Backend-Aktionsschritt zu ersetzen, der noch nicht gebaut ist. Ein Mensch kann den Schritt manuell ausführen, sodass Sie den gesamten Prozessfluss testen können, bevor die Integration bereit ist.
Was Sie benötigen
Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
Einen Fin-Prozess mit mindestens einem Loop in teammate / agent Schritt
Eine URL (webhook-Endpunkt), an die Ihr System Benachrichtigungen von Fin empfangen und beantworten kann
Die Berechtigung Manage apps and integrations in den Einstellungen
Hinweis: Sie benötigen keine Drittanbieter-Entwicklertools oder App-Zugangsdaten für die Einrichtung – alles wird direkt im Prozess-Editor konfiguriert.
Funktionsweise
Wenn ein Kunden-Gespräch einen Loop in teammate / agent Schritt in einem Fin-Prozess erreicht:
1. Fin pausiert das Gespräch
Vor der Pause kann Fin dem Kunden eine Nachricht senden – um ihn darüber zu informieren, dass seine Anfrage geprüft wird.
Fin sendet eine Benachrichtigung an Ihr externes System.
Fin wartet und fährt nicht fort, bis eine Antwort empfangen wird oder der Schritt abläuft.
2. Ihr System wird benachrichtigt
Ihr System erhält eine Benachrichtigung mit den Gesprächsdaten und den Informationen, die für eine Entscheidung benötigt werden.
Ein menschlicher Prüfer sieht die Anfrage – oder Ihr System wendet seine eigene Logik an, um automatisch zu antworten.
Wenn Fin den Loop in teammate / agent Schritt erreicht, sendet es eine Benachrichtigung an Ihr externes System mit den Gesprächsdaten und der erforderlichen Aktion. In diesem Beispiel erhält ein Prüfer eine 2FA-Zurücksetzungsanfrage und Anweisungen, die Identität des Kunden vor der Antwort zu verifizieren.
3. Die Entscheidung wird zurückgesendet
Ihr System sendet die Entscheidung zurück an Fin.
4. Fin setzt den Prozess fort
Fin setzt an der Stelle fort, an der es pausiert hat.
Die Antwort Ihres Systems ist in späteren Schritten über einen Read attribute Schritt verfügbar.
Verwenden Sie eine IF/ELSE-Bedingung, um basierend auf dem Ergebnis zu verzweigen – zum Beispiel: genehmigt, fortfahren; abgelehnt, senden Sie dem Kunden eine Nachricht.
Wichtig: Ein Prozess mit einem Loop in teammate / agent Schritt kann nicht live gehen, bis die webhook-Verbindung konfiguriert ist. Sie werden aufgefordert, die Einrichtung vor der Veröffentlichung abzuschließen.
Schritt 1: Schritt hinzufügen und konfigurieren
Gehen Sie zu Train > Procedure und öffnen Sie den Prozess, dem Sie den Schritt hinzufügen möchten.
Geben Sie im Anweisungsblock @ ein und wählen Sie Loop in teammate / agent.
Der Schritt erscheint im Prozess-Editor. Sie sehen eine Collect-Anzahl, die zeigt, wie viele Antwortfelder definiert sind, und eine Wait time, die zeigt, wie lange Fin wartet – beides wird im Einstellungsbereich des Schritts konfiguriert.
Klicken Sie auf das Zahnrad-Symbol, um die Einstellungen des Schritts zu öffnen. Der Einstellungsbereich hat drei Abschnitte: Ask via webhook (für die webhook-Verbindung), Response to collect (die Felder, die Ihr Prüfer ausfüllt) und Wait time (wie lange Fin wartet, bevor der Schritt abläuft).
Unter Ask via webhook klicken Sie auf Configure. Geben Sie Ihre Delivery URL ein – die Webadresse, an die Intercom die Benachrichtigung sendet, wenn dieser Schritt erreicht wird – und klicken Sie dann auf Save.
Das Loop in teammate / agent webhook Modal zeigt Ihre Entwickler-Zugangsdaten, sobald die Verbindung hergestellt ist.
Unter Response to collect klicken Sie auf + Add, um die Felder zu definieren, die Ihr Prüfer ausfüllen muss. Geben Sie jedem Feld ein Format und einen Namen – zum Beispiel ein Textfeld ‚Ablehnungsgrund‘ oder ein boolesches Feld ‚Genehmigt‘.
Jedes Antwortfeld hat ein Format – Dropdown, Text oder Boolean (wahr/falsch) – einen Namen und eine optionale Beschreibung. Wenn ein teammate eingebunden wird, füllt er diese Felder direkt im Gespräch aus.
Unter Wait time legen Sie fest, wie lange Fin auf eine Antwort warten soll, bevor der Schritt abläuft. Das Minimum sind 1 Minute – es gibt kein Maximum. Sie können Minuten oder Stunden wählen. Bearbeiten Sie die Nachricht unten, um zu steuern, was Fin dem Kunden sagt, wenn die Wartezeit überschritten wird.
Speichern Sie Ihren Prozess. Fahren Sie mit Schritt 2 fort, um Ihre Entwickler-Zugangsdaten zu erhalten – der Prozess kann nicht live gehen, bis die webhook-Verbindung konfiguriert ist.
Hinweis: Für den Loop in teammate / agent Schritt mit webhook-Zustellung ist dies der einzige Zustellkanal – es gibt keine Option, an ein inbox oder Team zu routen.
Schritt 2: Entwickler-Zugangsdaten erhalten
Nachdem Sie die Delivery URL im Loop in teammate / agent webhook Modal gespeichert haben, zeigt das Modal Webhook connected und offenbart drei Zugangsdaten, die Ihr Entwickler benötigt. Wenn Not configured angezeigt wird, prüfen Sie, ob Ihre Delivery URL gespeichert ist und ob kein zuvor ausgestelltes Zugriffstoken abgelaufen oder widerrufen wurde – ein widerrufenes Token verhindert auch, dass der Fin-Prozess live geht.
Access token – authentifiziert die Antworten, die Ihr System an Fin zurücksendet.
Signing secret – bestätigt, dass eingehende Benachrichtigungen tatsächlich von Intercom stammen.
Beispiel-Callback-URL – für jedes Gespräch wird eine eindeutige URL generiert. Ihr System sendet die Entscheidung des Prüfers an diese URL, um den Prozess fortzusetzen.
Hinweis: Sie können diese Zugangsdaten jederzeit anzeigen, indem Sie im Einstellungsbereich des Schritts unter Ask via webhook auf Configure klicken. Nur teammates mit der Berechtigung Manage apps and integrations können diesen Dialog öffnen – teammates ohne diese Berechtigung sehen stattdessen eine Aufforderung zur Berechtigungsanfrage.
Schritt 3: Den webhook-Payload verarbeiten
Sobald das Modal Webhook connected anzeigt, teilen Sie die Access token, Signing secret und Example callback URL aus dem Loop in teammate / agent webhook Modal mit dem Entwickler, der die Integration baut. Er wird den Endpunkt erstellen, der:
Die Benachrichtigung von Fin empfängt, wenn der Schritt erreicht wird
Die Anfrage einem Prüfer präsentiert oder automatisierte Logik anwendet
Die Entscheidung zurücksendet, damit Fin fortfahren kann
Webhook-Payload
Wenn der Prozess den Loop in teammate / agent Schritt erreicht, sendet Intercom eine POST-Anfrage an Ihre Delivery URL. Der Payload enthält:
Die Gesprächs-ID
Die Frage, die Fin stellt
Die Attribute, die Ihr System ausfüllen muss
Eine Callback-URL, an die Ihre Antwort gesendet wird
Aktuelle Gesprächsnachrichten als Kontext
Für den vollständigen Payload und die Feldspezifikationen, das Format der Callback-Anfrage, Authentifizierungsdetails, unterstützte Datentypen und Fehlercodes siehe die procedures API reference.
Wie man den eigenständigen HITL webhook testet
Verwenden Sie Simulations – automatisierte Testläufe im Prozess-Editor – um den Loop in teammate / agent Schritt zu testen, ohne eine echte webhook-Benachrichtigung an Ihr System auszulösen.
Öffnen Sie eine Simulation für den Prozess und suchen Sie den Abschnitt Teammate input available to Fin. Fügen Sie die Werte hinzu, die Sie von einem Prüfer erwarten würden – zum Beispiel Approved: true – und führen Sie dann die Simulation aus. Fin verwendet diese Werte, als hätte Ihr System geantwortet.
Hinweis: Wenn Sie vor dem Ausführen keine Werte hinzufügen, behandelt Fin den Schritt als abgelaufen.
Einschränkungen
Es gibt eine Delivery URL pro Workspace. Eine Änderung aktualisiert die webhook-Verbindung für jeden Fin-Prozess, der den Loop in teammate / agent Schritt verwendet.
Wenn die Wartezeit abläuft und keine Antwort empfangen wird, sendet Fin dem Kunden die konfigurierte Timeout-Nachricht – der Prozess endet und das Gespräch eskaliert.
Die Standard-Timeout-Nachricht bezieht sich auf ‚das Team‘ – aktualisieren Sie sie vor dem Livegang, um Ihre tatsächliche Einrichtung widerzuspiegeln.
Eigenständiger HITL webhook vs. Developer Hub API-Ansatz
Beide Methoden pausieren einen Prozess an einem HITL-Schritt und benachrichtigen Ihr System via webhook – unterscheiden sich jedoch in der Einrichtung und Zielgruppe:
Eigenständiger HITL webhook: Direkt im Prozess-Editor konfiguriert – keine Developer Hub App oder OAuth-Berechtigungen erforderlich. Eine Delivery URL pro Workspace. Nur für Fin Standalone Workspaces verfügbar. Der webhook-Kanal ist automatisch für alle HITL-Schritte in Standalone-Prozessen aktiviert.
Developer Hub API-Ansatz: Erfordert eine Developer Hub App, Preview API-Version und die OAuth-Berechtigungen read_conversations und write_conversations. Pro Schritt aktivierbar und funktioniert zusammen mit den Intercom Inbox- und Slack-Kanälen. Für Nicht-Standalone Workspaces verfügbar. Siehe Human-in-the-loop approvals via API.
Aus Kundensicht sind beide Ansätze unsichtbar – das Gespräch läuft ohne Unterbrechung weiter, sobald Ihr System antwortet.
FAQ
Kann ich für verschiedene Prozesse unterschiedliche webhook-URLs verwenden?
Kann ich für verschiedene Prozesse unterschiedliche webhook-URLs verwenden?
Sie können für verschiedene Prozesse keine unterschiedlichen webhook-URLs verwenden – es gibt eine Delivery URL pro Workspace. Jeder Fin-Prozess mit dem Loop in teammate / agent Schritt sendet Benachrichtigungen an denselben Endpunkt. Wenn Sie Anfragen pro Prozess unterschiedlich routen müssen, kann Ihr externes System dies anhand der in der Benachrichtigung enthaltenen Details handhaben.
Was passiert mit dem Kunden, während er auf eine Antwort wartet?
Was passiert mit dem Kunden, während er auf eine Antwort wartet?
Während der Wartezeit pausiert Fin das Gespräch still, es sei denn, Sie haben eine Wartemeldung hinzugefügt. Sie können dies im Abschnitt Wait time der Schritt-Einstellungen konfigurieren – zum Beispiel: „Wir prüfen Ihre Anfrage und melden uns in Kürze.“ Wenn keine Antwort rechtzeitig eingeht, sendet Fin die konfigurierte Timeout-Nachricht, der Prozess endet und das Gespräch eskaliert.
Kann ich mehr als einen Loop in teammate / agent Schritt zum selben Prozess hinzufügen?
Kann ich mehr als einen Loop in teammate / agent Schritt zum selben Prozess hinzufügen?
Ja, Sie können mehr als einen Loop in teammate / agent Schritt zum selben Prozess hinzufügen. Mehrere Schritte werden unterstützt, um menschliche Eingaben an verschiedenen Punkten im Ablauf zu sammeln. Alle Schritte teilen sich dieselbe workspace webhook-Verbindung.
Kann ich die Delivery URL nach der Einrichtung ändern?
Kann ich die Delivery URL nach der Einrichtung ändern?
Ja, Sie können die Delivery URL nach der Einrichtung ändern. Klicken Sie im Abschnitt Ask via webhook der Schritt-Einstellungen auf Configure und geben Sie eine neue URL ein. Beachten Sie, dass eine Änderung die webhook-Verbindung für jeden Fin-Prozess aktualisiert, der diesen Schritt verwendet, nicht nur für den aktuell bearbeiteten.
Gibt es eine Möglichkeit, nachzuvollziehen, welche Entscheidungen getroffen wurden?
Gibt es eine Möglichkeit, nachzuvollziehen, welche Entscheidungen getroffen wurden?
Es gibt keine Möglichkeit, Entscheidungen, die über diesen Schritt getroffen wurden, in Intercom nachzuverfolgen – es gibt keine Berichts- oder Analysefunktionen für einzelne Entscheidungen. Ihr externes System ist für das Protokollieren und Nachverfolgen der Antworten verantwortlich.