Vordefinierte Komponente „Transaktionsverlauf“

Die vordefinierte Komponente für den Transaktionsverlauf prüft die Authentifizierungsebene eines Kunden und erfasst dann den Zeitraum der Transaktionen und andere Filter, die beim Abrufen des Transaktionsverlaufs angewendet werden. Diese Komponente unterstützt Filter für:

• Transaktionstyp
• Händlername
• Transaktionsbetrag

Wenn die Kundin oder der Kunde mehrere Konten hat, bestätigt die Komponente das spezifische Konto, für das der Transaktionsverlauf abgerufen werden soll. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine angepasste Version von Geburtsdatumserfassung, um Start- und Enddaten für den Transaktionsverlauf zu erfassen.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge verfassen

Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des Agents zu Beginn der Unterhaltung ausgelöst.

Mehrere Konten

Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter bestätigt, für welches Konto der Nutzer den Transaktionsverlauf anfordert. Der Agent erfasst das Start- und Enddatum der Transaktionen, alle Filter, die der Nutzer auf die Transaktionen anwenden möchte, und ob der Nutzer den Transaktionsverlauf verschlüsseln möchte. Der Agent sendet den Transaktionsverlauf an den Nutzer.

Nutzereingabe	Antwort des KI-Agenten
	Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Authentifizierung.
	Vielen Dank, Sie wurden authentifiziert.
	Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind. Können Sie uns bitte die letzten vier Ziffern des Kontos nennen, auf das Sie sich beziehen?
1001
	Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, sind 1001. Ist das richtig?
Ja
	Geben Sie das Startdatum Ihrer Transaktionen an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Der Transaktionsverlauf wird nur für die letzten 90 Tage bereitgestellt.
	Der Agent erfasst das Startdatum der Transaktionen mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Wir haben das Startdatum Ihrer Transaktionen erfasst. Geben Sie jetzt bitte das Enddatum Ihrer Transaktionen an. Beginnen Sie mit dem Monat, gefolgt vom Tag und dann vom Jahr. Der Transaktionsverlauf wird nur für die letzten 90 Tage bereitgestellt.
	Der Agent erfasst das Startdatum der Transaktionen mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Suchen Sie nach den Transaktionen zwischen dem 25.06.2023 und dem 21.07.2023?
Ja
	Bitte nenne uns den Namen des Händlers, für den du Transaktionen abrufen möchtest.
Google
	Der von uns erfasste Händlername lautet „Google“. Können Sie das bitte mit „Ja“ oder „Nein“ bestätigen?
Ja
	Möchten Sie den Transaktionsverlauf für Ihre Debit- oder Kreditkarten sehen?
Guthaben
	Geben Sie einen Betrag an, um Transaktionen mit diesem oder einem höheren Betrag abzurufen. Wenn Sie beispielsweise nach Transaktionen über 100, 30 € suchen möchten, sagen Sie „100“.
500
	Bitte warten Sie, während wir Ihre Transaktionsdetails abrufen. Wir haben Transaktionen vom 02.06.2023 bis zum 21.07.2023 gefunden. Möchten Sie sie per SMS oder WhatsApp erhalten?
SMS
	Möchten Sie das Dokument verschlüsseln, bevor wir es mit Ihnen teilen?
Ja, bitte
	Die Passwortdetails werden an deine registrierte Mobilfunknummer gesendet. Du erhältst den Kontoauszug innerhalb von 15 Minuten auf deinem registrierten Mobilgerät.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Transaktionsverlauf
Komponentenspezifischer Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_transaction_history_transaction_collection
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_transaction_history_det_cred
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_transaction_history:get_transactions

Eingabeparameter

Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Ablaufbezogene Parameter müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder von einem aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.auth_level	(Optional) Gibt die Authentifizierungsebene des Aufrufers an.	integer
$session.params.auth_level_req	Gibt die Authentifizierungsebene an, die erforderlich ist, bevor ein Nutzer auf seinen Transaktionsverlauf zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneintrag auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.	integer
$session.params.account_auth_enabled	Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneintrag auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.	boolean
$session.params.card_auth_enabled	Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.	boolean
$session.params.phone_number	(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.	String
$session.params.account_count	(Optional) Anzahl der Konten, die mit dem authentifizierten Nutzer verknüpft sind.	integer
$session.params.last_four_digit_of_account_number	(Optional) Die letzten vier Ziffern der Kundenkontonummer, für die der Transaktionsverlauf bereitgestellt werden soll. Wenn der Kunde ein einzelnes Konto hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Konten hat, wird die spezifische Kontonummer vom Kunden erfasst.	String
$session.params.transaction_history_max_days	Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, die für das Startdatum einer Transaktion zulässig sind. Standardmäßig ist dieser Wert auf -90 gesetzt. Das bedeutet, dass das Startdatum von Transaktionen maximal 90 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Route true der Startseite festgelegt.	integer
$flow.max_retry_count	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Endnutzer aufgefordert wird, gültige Start- und Enddaten für Transaktionen anzugeben. Der Standardwert ist 3.	integer

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Erstellen aus.
5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
6. Klicken Sie im Abschnitt Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
auth_level	Gibt die Authentifizierungsebene des Aufrufers an.	integer
phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
account_count	Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat.	integer
last_four_digit_of_account_number	Wenn ein Nutzer ein einzelnes Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehr als ein Konto hat, sind die letzten vier Ziffern der Kontonummer, die der Nutzer für den Transaktionsverlauf ausgewählt hat, der Wert dieses Parameters.	String
transfer_reason	Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden: agent: Der Endnutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat sich geweigert, die von der Komponente angeforderten Informationen weiterzugeben. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Eingabe. max_no_match: Die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Übereinstimmung wurde erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse für „Keine Übereinstimmung“. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe Integriertes Ereignis „webhook.error.not-found“.	String

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten im Abschnitt „Webhook-Einrichtung“.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.

Authentifizierung

Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie sie konfigurieren, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Eine ausführliche Anleitung finden Sie unter Authentifizierungs-Webhook einrichten.

Konto bestätigen

Der Webhook prebuilt_components_account_services:validate_account wird von der Komponente verwendet, um anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer zu prüfen, ob ein Konto vorhanden ist. Der Webhook gibt auch das Guthaben zurück, falls ein Konto vorhanden ist.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.last_four_digit_of_account_number	Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, um Informationen zum Kontoauszug zu erhalten.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
account_found	Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern vorhanden ist.	boolean
Kontostand	Der aktuelle Kontostand, falls vorhanden.	Zahl

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Konto validieren“ für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_account_services:validate_account“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Transaktionen abrufen

Der Webhook prebuilt_components_transaction_history:get_transactions wird von der Komponente verwendet, um die Anzahl der Transaktionen für ein Konto abzurufen. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer, der Zeitraum des Transaktionsverlaufs und alle vom Nutzer ausgewählten Filter verwendet.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.last_four_digit_of_account_number	Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, um den Transaktionsverlauf zu erhalten.	String
$flow.statement_start_date	Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“.	String
$flow.statement_end_date	(Optional) Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“. Wenn der Nutzer keinen Wert angibt oder der Anrufer kein Enddatum angeben möchte, wird standardmäßig das aktuelle Datum verwendet.	String
$flow.transaction_credit_debit	Vom Nutzer angeforderter Transaktionstyp. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_transaction_history_det_cred definiert. Standardmäßig werden "credit" und "debit" unterstützt. Wenn der Nutzer keinen Typ auswählt, ist dieser Wert ein leerer String "" und Transaktionen aller Typen sollten gezählt werden.	String
$flow.merchant_name	Der vom Nutzer angeforderte Händlername. Wenn der Nutzer keinen Händlernamen angibt, ist dieser Wert ein leerer String "" und Transaktionen von allen Händlern sollten gezählt werden.	String
$flow.high_amount_value	Vom Nutzer angeforderter Mindesttransaktionsbetrag. Wenn der Nutzer keinen Betrag angibt, hat dieser Parameter den Standardwert 0.	integer

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
transactions_count	Die Anzahl der Transaktionen, die für das angegebene Konto im angegebenen Abrechnungszeitraum mit den ausgewählten Filtern gefunden wurden.	integer

Maximieren Sie den Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Get transactions“ für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_transaction_historyt:get_transactions“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Informationen senden

Der Webhook prebuilt_components_transaction_history:send_info wird von der Komponente verwendet, um einen Transaktionsverlauf an einen ausgewählten Kanal zu senden. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer, der Zeitraum des Transaktionsverlaufs und alle vom Nutzer ausgewählten Filter verwendet.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.last_four_digit_of_account_number	Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, um den Transaktionsverlauf zu erhalten.	String
$flow.statement_start_date	Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“.	String
$flow.statement_end_date	(Optional) Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“.	String
$flow.transaction_credit_debit	Vom Nutzer angeforderter Transaktionstyp. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_transaction_history_det_cred definiert. Standardmäßig werden "credit" und "debit" unterstützt. Wenn der Nutzer keinen Typ auswählt, ist dieser Wert ein leerer String "" und es sollten Transaktionen aller Typen gesendet werden.	String
$flow.merchant_name	Der vom Nutzer angeforderte Händlername. Wenn der Nutzer keinen Händlernamen angibt, ist dieser Wert ein leerer String "" und es sollten Transaktionen von allen Händlern gesendet werden.	String
$flow.high_amount_value	Vom Nutzer angeforderter Mindesttransaktionsbetrag. Wenn der Nutzer keinen Betrag angibt, hat dieser Parameter den Standardwert 0.	integer
$flow.channel_medium	Der Kanal, den der Nutzer für den Empfang der Nachricht ausgewählt hat. Gültige Werte werden durch die benutzerdefinierten Entitäten prebuilt_components_transaction_history_phone und prebuilt_components_transaction_history_channel definiert, je nachdem, ob der Nutzer eine registrierte E-Mail-Adresse hat. Standardmäßig werden email, mobile und whatsapp unterstützt.	String
$flow.encryption_status	Gibt an, ob der Nutzer das Dokument vor dem Senden an den angegebenen Kanal verschlüsseln möchte. Wenn der Nutzer keinen Wert angibt oder der Anrufer kein Enddatum angibt, wird standardmäßig true verwendet.	boolean

Wenn Sie den Webhook „Informationen senden“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_transaction_history:send_info“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.