Die vorgefertigte Komponente „Transaktionsverlauf“ prüft das Authentifizierungsniveau eines Kunden und erfasst dann den Zeitraum für Transaktionen und andere Filter, die beim Abrufen des Transaktionsverlaufs angewendet werden. Diese Komponente unterstützt Filter für:
- Transaktionstyp
- Händlername
- Transaktionsbetrag
Wenn der Kunde mehrere Konten hat, wird in der Komponente das Konto bestätigt, für das der Kunde den Transaktionsverlauf abrufen möchte. Diese Komponente verwendet die vorgefertigte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine benutzerdefinierte Version der Komponente Geburtsdatum erfassen, um Start- und Enddatum 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
Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.
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 |
|---|---|
| Agent authentifiziert Nutzer mit der vordefinierten Komponente Authentifizierung | |
| Vielen Dank, Sie wurden erfolgreich authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass Ihrer Nummer zwei Konten zugeordnet 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. Stimmt das? | |
| Ja | |
| Geben Sie das Startdatum Ihrer Transaktionen an, beginnend mit dem Monat, gefolgt von Tag und Jahr. Bitte beachten Sie, dass der Transaktionsverlauf nur für die letzten 90 Tage bereitgestellt wird. | |
| Agent erfasst das Startdatum von Transaktionen mit der vordefinierten Komponente Geburtsdatum | |
| Wir haben das Startdatum Ihrer Transaktionen erfasst. Geben Sie bitte das Enddatum Ihrer Transaktionen an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Bitte beachten Sie, dass der Transaktionsverlauf nur für die letzten 90 Tage bereitgestellt wird. |
|
| Agent erfasst das Startdatum von Transaktionen mit der vordefinierten Komponente Geburtsdatum | |
| Vielen Dank. Suchst du nach Transaktionen zwischen dem 25.06.2023 und dem 21.07.2023? | |
| Ja | |
| Bitte teilen Sie uns den Namen des Händlers mit, für den Sie Transaktionen abrufen möchten. | |
| Der von uns erfasste Händlername lautet „Google“. Bitte bestätigen Sie mit Ja oder Nein. | |
| Ja | |
| Möchten Sie den Transaktionsverlauf für Ihre Debit- oder Kreditkarten aufrufen? | |
| Guthaben | |
| Geben Sie einen Betrag an, um Transaktionen abzurufen, die diesem Betrag entsprechen oder darüber liegen. Wenn Sie beispielsweise Transaktionen über 100, 30 $finden möchten, geben Sie „100“ ein. | |
| 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 es 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 Ihre registrierte Mobilfunknummer gesendet. Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihrem registrierten Mobilgerät. |
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Transaktionsverlauf |
| Komponentenspezifische Intention | 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 werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Parameter mit Flow-Bereich müssen auf der Startseite der Komponente festgelegt werden, wie unten beschrieben. Parameter mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.
Diese vorgefertigte 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 der Auftragsausführung für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1. |
integer |
| $session.params.account_auth_enabled | Gibt an, ob der Nutzer als Kontoinhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für den Seiteneinstieg 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 der Auftragsausführung für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false. |
boolean |
| $session.params.phone_number | (Optional) 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 Kundennummer, für die der Transaktionsverlauf angegeben werden muss. Wenn der Kunde nur ein 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 Startseitenroute true festgelegt. |
integer |
| $flow.max_retry_count | Gibt die Anzahl der Wiederholungsversuche an, die zulässig sind, wenn der Endnutzer aufgefordert wird, gültige Start- und Enddaten für Transaktionen anzugeben. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Erstellen aus.
- Klicken Sie im Bereich Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die richtige Route.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden 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 Anrufers an. | integer |
| phone_number | Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, 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 mehrere Konten hat, ist der Wert dieses Parameters die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt hat, um den Transaktionsverlauf zu erhalten. | String |
| transfer_reason | Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, falls er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat abgelehnt, von der Komponente angeforderte Informationen weiterzugeben.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Input-Ereignisse 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 ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter webhook.error (integriertes Ereignis). webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter webhook.error.not-found (integriertes Ereignis). |
String |
Grundlegende Einrichtung
So richten Sie diese vordefinierte Komponente ein:
- Vordefinierte Komponente importieren
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook-Einrichtung“.
Webhook-Einrichtung
Um diese Komponente verwenden zu können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies tun, um die Authentifizierung von Nutzern für diese Komponente zu aktivieren. Eine ausführliche Anleitung finden Sie unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Der prebuilt_components_account_services:validate_account-Webhook 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 den Kontostand zurück, sofern 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 Landesvorwahl, 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 Kontoauszugsinformationen zu erhalten. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| 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 Betrag des aktuellen Guthabens auf dem Konto, falls vorhanden. | Zahl |
Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_account_services:validate_account“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Transaktionen abrufen
Der prebuilt_components_transaction_history:get_transactions-Webhook 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 Landesvorwahl, 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 angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. Wenn der Nutzer keinen Wert angibt oder der Anrufer kein Enddatum angibt, wird standardmäßig das aktuelle Datum verwendet. | String |
| $flow.transaction_credit_debit | Der vom Nutzer angeforderte 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 Art 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 Mindestbetrag für Transaktionen. Wenn der Nutzer die Angabe eines Betrags ablehnt, hat dieser Parameter den Standardwert 0. |
integer |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| 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 |
Wenn Sie den Webhook „Get transactions“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_transaction_historyt:get_transactions“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Informationen senden
Der prebuilt_components_transaction_history:send_info-Webhook wird von der Komponente verwendet, um einen Transaktionsverlauf an einen ausgewählten Channel 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 Landesvorwahl, 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 angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. | String |
| $flow.transaction_credit_debit | Der vom Nutzer angeforderte 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 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 Transaktionen von allen Händlern sollten gesendet werden. |
String |
| $flow.high_amount_value | Vom Nutzer angeforderter Mindestbetrag für Transaktionen. Wenn der Nutzer die Angabe eines Betrags ablehnt, hat dieser Parameter den Standardwert 0. |
integer |
| $flow.channel_medium | Der Kanal, den der Nutzer ausgewählt hat, um die Nachricht zu empfangen. 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 das Dokument verschlüsselt werden soll, bevor es an den angegebenen Kanal gesendet wird. 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 aufzurufen.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_transaction_history:send_info“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.