Das Wait for Webhook-Tool ermöglicht es Fin, mitten in einer Prozedur zu pausieren und auf externe Eingaben zu warten. Verwenden Sie es, um Prozesse zu automatisieren, die eine Integration mit Drittanbietersystemen wie Onfido und Plaid erfordern und asynchrone Verarbeitung ermöglichen.
Hinweis:
Wait for Webhook ist nur innerhalb von Instruction-Schritten verfügbar. Fügen Sie es hinzu, indem Sie @ in einem Instruction-Schritt eingeben und Wait for Webhook aus dem Tool-Auswahlmenü wählen.
Wann Wait for Webhook verwenden
Verwenden Sie dieses Tool, wenn Ihre Prozedur an ein externes System übergeben werden muss und auf ein Ergebnis warten soll, bevor sie fortfährt – und dieses System Anfragen asynchron verarbeitet, anstatt sofort eine Antwort zurückzugeben.
Häufige Anwendungsfälle sind:
Identitäts- oder Altersprüfung – Warten auf die Bestätigung der Identität eines Kunden durch einen KYC (Know Your Customer)-Anbieter
Zahlungsautorisierung – Warten auf die Bestätigung einer Transaktion durch einen Zahlungsprozessor
Kontoverknüpfung – Warten auf den Abschluss eines OAuth (Open Authorization Standard)-Flows
Bestellabwicklungskontrollen – Warten auf die Bestätigung der Lagerverfügbarkeit durch ein Lagersystem
Genehmigungsworkflows – Warten auf die Genehmigung einer Rückerstattung oder Ausnahme durch ein internes Team
Funktionsweise
Wenn Fin in einer Prozedur auf ein Wait for Webhook-Tool trifft, passiert Folgendes:
Wenn ein Prozedurlauf startet, generiert Fin für jedes Wait for Webhook-Tool eine eindeutige Callback-URL.
Konfigurieren Sie Ihre Prozedur so, dass diese Callback-URL vor Erreichen des Wait for Webhook-Tools mithilfe eines Data Connectors an Ihr externes System übergeben wird.
Sobald das externe System seine Verarbeitung abgeschlossen hat und einen webhook an die Callback-URL sendet, erfasst Fin die webhook-Nutzlast in den konfigurierten Antwortattributen und setzt die Prozedur automatisch fort.
Wenn innerhalb der konfigurierten Wartezeit kein Callback empfangen wird, sendet Fin die konfigurierte Eskalationsnachricht und weist die Konversation dem konfigurierten Eskalationsbeauftragten zu.
Wichtig: Die Callback-URL ist pro Prozedurlauf einzigartig. Sie kann nicht für mehrere Konversationen wiederverwendet oder als statischer Endpunkt gespeichert werden.
So fügen Sie Wait for Webhook zu einer Prozedur hinzu
Öffnen Sie Ihre Prozedur im Editor.
Geben Sie in einem Instruction-Schritt @ ein, um das Tool-Auswahlmenü zu öffnen.
Wählen Sie Wait for Webhook aus der Liste.
Das Wait for Webhook-Tool wird in den Schritt eingefügt und ein Konfigurations-Seitenpanel öffnet sich rechts.
So konfigurieren Sie das Tool
Das Konfigurations-Seitenpanel für Wait for Webhook hat drei Felder:
Tool-Name
Geben Sie dem Tool einen beschreibenden Namen (zum Beispiel „Wait for ID verification callback“). Dieser Name identifiziert das Tool im Editor und wird referenziert, wenn Sie die Callback-URL als Parameter in Ihrem Data Connector zuordnen.
Antwortattribute
Definieren Sie die Felder, die das externe System in seiner webhook-Nutzlast enthalten soll. Jedes hier definierte Attribut wird erfasst, wenn der Callback eintrifft, und kann in späteren Schritten mit dem Read attribute-Tool referenziert werden.
Beispielsweise, wenn Ihr Identitätsprüfungsanbieter einen status und eine reference_id zurücksendet, fügen Sie beide hier als Antwortattribute hinzu.
Wartezeit und Fallback
Legen Sie fest, wie lange Fin auf einen Callback warten soll, bevor eskaliert wird. Sie müssen auch die Eskalationsnachricht konfigurieren, die an den Kunden gesendet wird, und den Beauftragten auswählen, an den die Konversation weitergeleitet wird, wenn die Wartezeit überschritten wird.
Wichtig: Konfigurieren Sie im Seitenpanel immer sowohl eine Eskalationsnachricht als auch einen Eskalationsbeauftragten. Fehlt eines davon, kann das Timeout-Verhalten unvorhersehbar sein.
So übergeben Sie die Callback-URL an Ihr externes System
Die Callback-URL wird generiert, wenn die Prozedur startet – nicht, wenn die Ausführung das Wait for Webhook-Tool erreicht. Das bedeutet, Sie können sie in jedem früheren Schritt, einschließlich des allerersten Schritts, an Ihr externes System übergeben. Verwenden Sie dazu einen Data Connector.
Richten Sie einen Data Connector ein, der die API Ihres externen Systems aufruft (z. B. einen „Start ID Verification“-Endpunkt).
Konfigurieren Sie den Data Connector so, dass er eine Callback-URL als Eingabeparameter akzeptiert.
Ordnen Sie in der Prozedur-Editor diesen Eingabeparameter dem URL-Attribut des webhook-Tools zu.
Stellen Sie sicher, dass die Prozedur so eingerichtet ist, dass dieser Data Connector vor dem Erreichen des Wait for Webhook-Tools aufgerufen wird.
Wenn Fin den Data Connector aufruft, übergibt es die eindeutige Callback-URL in der Anfrage. Ihr externes System speichert diese URL und sendet den webhook-Callback an diese, sobald die Verarbeitung abgeschlossen ist.
Hinweis: Der Aufruf des Data Connectors, der die Callback-URL übergibt, muss vor dem Wait for Webhook-Tool erfolgen. So erhält das externe System Zugriff auf die Callback-URL.
So lesen Sie Antwortdaten nach dem Callback
Sobald Fin den webhook-Callback erhält und die Prozedur fortsetzt, wird die Antwortnutzlast in den Antwortattributen erfasst, die Sie in der Wait for Webhook-Tool-Konfiguration definiert haben. Verwenden Sie das Read attribute-Tool in einem nachfolgenden Instruction-Schritt, um auf diese Werte zuzugreifen.
Zum Beispiel:
Lesen Sie verification_status, um zu prüfen, ob die Identitätsprüfung bestanden oder fehlgeschlagen ist.
Verwenden Sie einen Condition-Schritt, um den Ablauf basierend auf dem Ergebnis zu verzweigen.
Übergeben Sie Werte aus der Antwort an einen anderen Data Connector zur weiteren Verarbeitung.
Sobald das Wait for Webhook-Tool seinen Callback erhalten hat und Sie basierend auf den erfassten Antwortattributen verzweigt haben, setzt die Prozedur ihren nächsten Schritt normal fort. Wenn der Callback innerhalb der konfigurierten Wartezeit nie eintrifft, eskaliert Fin wie unter „Was passiert, wenn die Wartezeit überschritten wird?“ beschrieben.
Was passiert, wenn die Wartezeit überschritten wird?
Wenn die konfigurierte Wartezeit des Wait for Webhook-Tools abläuft, ohne dass ein Callback empfangen wird, eskaliert Fin immer. Es gibt keine bedingte Verzweigung – Sie können kein unterschiedliches Verhalten je nach Timeout konfigurieren. Die Eskalation folgt immer diesen zwei Schritten:
Eskalationsnachricht: Die Nachricht, die Fin an den Kunden sendet, wenn das Timeout eintritt.
Eskalationsbeauftragter: Das Team oder der Kollege, an den die Konversation nach dem Senden der Nachricht weitergeleitet wird.
Tipp:
Stellen Sie Ihre Wartezeit so ein, dass sie der erwarteten Verarbeitungszeit Ihres externen Systems entspricht, mit einem angemessenen Puffer. Wenn Ihr Anbieter typischerweise in 10 Sekunden antwortet, bietet eine Wartezeit von 60 Sekunden einen sicheren Spielraum und hält die Erfahrung reaktionsschnell.
Sobald Ihre Prozedur eingerichtet ist, verwenden Sie Simulationen im Prozedur-Editor, um den Wait for Webhook-Ablauf von Anfang bis Ende zu validieren, bevor er echte Kunden erreicht. Definieren Sie eine simulierte Callback-Nutzlast in der Simulation und legen Sie Erfolgskriterien basierend auf dem Prozedurpfad fest, dem Fin folgen soll.
FAQs
Mein webhook ist nie angekommen – was passiert?
Mein webhook ist nie angekommen – was passiert?
Wenn innerhalb der konfigurierten Wartezeit kein Callback empfangen wird, löst Fin den Eskalationspfad aus – es sendet die konfigurierte Eskalationsnachricht an den Kunden und leitet die Konversation an den Eskalationsbeauftragten weiter. Die Prozedur wird nicht fortgesetzt.
Wie bekomme ich die Callback-URL zu meinem externen System?
Wie bekomme ich die Callback-URL zu meinem externen System?
Verwenden Sie einen Data Connector-Schritt, der vor dem Wait for Webhook-Tool in Ihrer Prozedur platziert ist. Konfigurieren Sie den Connector so, dass er die API Ihres externen Systems aufruft und das Callback-Attribut des webhook-Tools als Eingabeparameter zuordnet. Fin übergibt die Callback-URL an das externe System, wenn der Connector aufgerufen wird, sodass das System weiß, wohin der Callback gesendet werden soll.
Kann ich dieselbe Callback-URL für mehrere Konversationen verwenden?
Kann ich dieselbe Callback-URL für mehrere Konversationen verwenden?
Nein. Die Callback-URL ist pro Prozedurlauf einzigartig und wird generiert, wenn die Prozedur startet – nicht, wenn die Ausführung das Wait for Webhook-Tool erreicht. Jedes Mal, wenn eine Prozedur für einen Kunden ausgeführt wird, wird eine neue URL generiert. Sie können sie nicht als statischen Endpunkt speichern oder für mehrere Konversationen wiederverwenden.
Welche Nutzlastfelder kann mein externes System zurücksenden?
Welche Nutzlastfelder kann mein externes System zurücksenden?
Ihr externes System kann beliebige Felder in der webhook-Nutzlast enthalten, aber nur die Felder, die Sie als Antwortattribute in der Wait for Webhook-Tool-Konfiguration definiert haben, werden von Fin erfasst und in nachfolgenden Schritten verfügbar gemacht. Alle zusätzlichen Felder in der Nutzlast werden ignoriert.
Was passiert, während Fin auf einen Callback wartet?
Was passiert, während Fin auf einen Callback wartet?
Während Fin pausiert und auf einen webhook-Callback wartet, reagiert es nicht auf eingehende Kundenmeldungen. Die Konversation ist effektiv still, bis der Callback eintrifft oder das Timeout eintritt.
Tipp: Fügen Sie immer einen Instruction-Schritt vor dem Wait for Webhook-Tool hinzu, um dem Kunden mitzuteilen, was passiert – zum Beispiel: „Wir überprüfen Ihre Identität. Bitte schließen Sie den Schritt im Link ab, den wir Ihnen gesendet haben.“ Ohne dies wird Fin mitten in der Konversation ohne Erklärung für den Kunden still.
Welche Berechtigungen benötige ich, um Wait for Webhook zu verwenden?
Welche Berechtigungen benötige ich, um Wait for Webhook zu verwenden?
Sie benötigen die Berechtigung can manage workspace data, um Fin-Prozeduren zu erstellen oder zu bearbeiten, einschließlich des Hinzufügens des Wait for Webhook-Tools. Sie können Berechtigungen unter Einstellungen > Workspace > Teammates überprüfen und aktualisieren.