Aufruf vor Verarbeitung einer Nachricht durchführen

Ein Pre-Message-Webhook ruft jedes Mal einen externen Dienst oder eine Anwendung auf, wenn ein Kunde eine Eingabe tätigt. Der externe Dienst kann die Nachricht verarbeiten, bevor Ihr Assistent sie bearbeitet.

Fügen Sie Ihrem Assistenten einen Pre-Message-Webhook hinzu, wenn Sie möchten, dass der Webhook ausgelöst wird, bevor jede eingehende Nachricht von Ihrem Assistenten verarbeitet wird.

Wenn Sie einen benutzerdefinierten Kanal verwenden, funktioniert der Pre-Message-Webhook nur mit der Version 2 der /message API, zustandslos und zustandsabhängig. Weitere Informationen finden Sie in der API-Referenz. Alle integrierten Kanalintegrationen verwenden diese API.

Sie können Pre-Message-Webhooks für die folgenden Anwendungsfälle verwenden:

  • Übersetzen Sie die Eingaben des Kunden in die Sprache, die Ihr Assistent verwendet.

  • Suchen und entfernen Sie alle personenbezogenen Daten, wie z. B. eine E-Mail-Adresse oder Sozialversicherungsnummer, die ein Kunde übermitteln könnte.

Sie können diesen Webhook in Koordination mit dem Post-Message-Webhook verwenden. Der Post-Message-Webhook kann z. B. die Antwort in die Sprache des Kunden übersetzen oder Informationen wieder einfügen, die aus Datenschutzgründen entfernt wurden. Weitere Informationen finden Sie unter Aufruf nach Verarbeitung einer Nachricht durchführen.

Beachten Sie bei Umgebungen, in denen private Endpunkte verwendet werden, dass ein Webhook Daten über das Internet sendet.

Verwenden Sie einen Dialog-Webhook, wenn Sie während einer Konversation eine einmalige Aktion durchführen müssen. Die Bedingungen sind beispielsweise erfüllt, wenn der Assistent alle erforderlichen Angaben wie Kontonummer, Benutzerkennung und Kontogesprächsgeheimnis erfasst. Weitere Informationen finden Sie unter Programmgesteuerten Aufruf über ein Dialogmodul absetzen.

Webhook definieren

Sie können eine Webhook-URL für die Vorverarbeitung jeder eingehenden Nachricht definieren.

Vorbereitende Schritte

Der programmatische Aufruf des externen Dienstes muss die folgenden Anforderungen erfüllen:

  • Konfigurieren und testen Sie Ihren Webhook nicht in einer Produktionsumgebung, in der der Assistent implementiert ist und bereits mit Kunden interagiert.
  • Der Aufruf muss eine HTTP-Anforderung POST sein.
  • Der Anforderungshauptteil muss ein JSON-Objekt (Content-Type: application/json) sein.
  • Der Aufruf muss in maximal 30 Sekunden zurückgegeben werden.

Wenn Ihr externer Dienst nur GET-Anforderungen unterstützt oder wenn Sie URL Parameter dynamisch zur Laufzeit angeben müssen, sollten Sie einen Zwischendienst erstellen, der eine POST-Anforderung mit einer JSON-Nutzlast annimmt, die alle Laufzeitwerte enthält. Der temporäre Service kann dann eine Anforderung an den Zielservice absetzen, diese Werte als URL-Parameter übergeben und dann die Antwort an den Dialog zurückgeben.

Auswahl der Bereitstellungsmethode

Wählen Sie die Bereitstellungsmethode aus, die Sie verwenden, um die richtigen Schritte zum Einrichten eines Pre-Message-Webhooks anzuzeigen.

Um festzustellen, welchen Bereitstellungstyp Sie verwenden, klicken Sie auf das Menü „Verwalten “ Menü „Verwalten“. Wenn Sie " Zum klassischen Erlebnis wechseln " sehen, verwenden Sie das neue Erlebnis. Wenn Sie " Zu neuem Erlebnis wechseln" sehen, verwenden Sie das klassische Erlebnis.

Nutzen Sie die folgenden Links, um sich über die Verfahren für Ihren Einsatztyp zu informieren: