Die vordefinierte Komponente des Transaktionsverlaufs prüft die Authentifizierungsstufe eines Kunden, 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 der Kunde mehrere Konten hat, bestätigt die Komponente das spezifische Konto, für das der Kunde den Transaktionsverlauf abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine benutzerdefinierte Version von Geburtsdatumsdaten, 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 allgemeine Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialogfelder veranschaulichen das Verhalten, wenn die Komponente über Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.
Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Agent 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 | Agent-Antwort |
---|---|
Der Agent authentifiziert den Nutzer mit der vordefinierten Authentifizierung-Komponente | |
Vielen Dank, Sie wurden erfolgreich authentifiziert. | |
Bitte warten Sie, während Ihre Kontodetails abgerufen werden. Wir haben festgestellt, dass Ihrer Telefonnummer zwei Konten zugeordnet sind. Könnten 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, richtig? | |
Ja | |
Geben Sie das Startdatum Ihrer Transaktionen an, beginnend mit dem Monat, gefolgt von Tag und Jahr. Der Transaktionsverlauf wird nur für die letzten 90 Tage zur Verfügung gestellt. | |
Der Kundenservicemitarbeiter erfasst das Startdatum der Transaktionen mithilfe der vordefinierten Komponente Geburtsdatum | |
Wir haben das Startdatum deiner Transaktionen erfasst. Bitte gib das Enddatum deiner Transaktionen an, das mit dem Monat beginnt, danach den Tag und dann das Jahr. Der Transaktionsverlauf wird nur für die letzten 90 Tage zur Verfügung gestellt. |
|
Der Kundenservicemitarbeiter erfasst das Startdatum der Transaktionen mithilfe der vordefinierten Komponente Geburtsdatum | |
Vielen Dank. Geht es um Transaktionen zwischen dem 25.06.2023 und 21.07.2023? | |
Ja | |
Bitte teilen Sie uns den Namen des Händlers mit, für den Sie Transaktionen abrufen möchten. | |
Der erfasste Händlername ist „Google“. Könnten Sie dies bitte mit Ja oder Nein bestätigen? | |
Ja | |
Möchten Sie den Transaktionsverlauf für Ihre Debit- oder Kreditkarten ansehen? | |
Guthaben | |
Gib einen Betrag an, mit dem Transaktionen über den angegebenen Betrag abgerufen werden können. Wenn Sie beispielsweise Transaktionen über 100, 30 € ermitteln möchten, sagen Sie „100“. | |
500 | |
Deine Transaktionsdetails werden abgerufen. Wir haben Transaktionen vom 2.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 für Sie freigeben? | |
Ja, bitte | |
Die Passwortdetails werden auf dein registriertes Mobilgerät geteilt. Du erhältst den Kontoauszug innerhalb von 15 Minuten auf deinem registrierten Smartphone. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
Funktion | Format | Beispiel |
---|---|---|
Fluss | [Komponentenname] | 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. Parameter auf Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Sitzungsbezogene Parameter können entweder über einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.
Diese vordefinierte Komponente unterstützt die folgenden Eingabeparameter:
Parametername | Beschreibung | Eingabeformat |
---|---|---|
$session.params.auth_level | (optional) Gibt die Authentifizierungsstufe des Aufrufers an. | integer |
$session.params.auth_level_req | Gibt die Authentifizierungsstufe an, die erforderlich ist, bevor ein Nutzer auf seinen Transaktionsverlauf zugreifen kann. Dieser Wert ist in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Der Standardwert ist 1 . |
integer |
$session.params.account_auth_enabled | Gibt an, ob der Nutzer als Kontoinhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert ist in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Der Standardwert ist true . |
boolean |
$session.params.card_auth_enabled | Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert ist in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Der Standardwert ist 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 dem authentifizierten Nutzer zugeordnet sind. | integer |
$session.params.last_four_digit_of_account_number | (Optional) Die letzten vier Ziffern der Kundenkontonummer, 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 lautet dieser Wert -90 . 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 [Anzahl_der_Wiederholungen] | 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 |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Build aus.
- Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Voreinstellungen für Parameter) nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die auch nach Beenden der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente stellt Werte für die folgenden Ausgabeparameter bereit:
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
auth_level | Gibt die Authentifizierungsstufe 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 der registrierten Telefonnummer zugeordnet sind. Dazu gehören Selbstkonten und Konten, für die der Nutzer eine Vollmacht hat. | integer |
last_four_digit_of_account_number | Wenn ein Nutzer nur ein Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehr als ein Konto hat, besteht der Wert dieses Parameters aus den letzten vier Ziffern der Kontonummer, die der Nutzer für den Transaktionsverlauf ausgewählt hat. | String |
transfer_reason | Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, 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 freizugeben.max_no_input : Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Siehe integrierte Ereignisse ohne Eingabe.max_no_match : Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Siehe integrierte Ereignisse ohne Ü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 webhook.error.not-found integriertes Ereignis. |
String |
Grundlegende Einstellungen
So richten Sie diese vordefinierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dialogflow-Dienste beschreibt. Weitere Informationen finden Sie unten im Abschnitt „Webhook-Einrichtung“.
Webhook-Einrichtung
Um diese Komponente zu verwenden, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.
Authentifizierung
Wenn Sie noch keine externen Dienste konfiguriert haben, die für die Authentifizierung erforderlich sind, müssen Sie diese so konfigurieren, dass die Authentifizierung von Nutzern für diese Komponente aktiviert wird. Eine ausführliche Anleitung finden Sie unter Authentifizierungs-Webhook einrichten.
Konto validieren
Mit dem Webhook prebuilt_components_account_services:validate_account
prüft die Komponente anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer, ob ein Konto vorhanden ist.
Der Webhook gibt außerdem 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 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, für die er Kontoberichtsinformationen erhalten möchte. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
account_found | Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den letzten vier Ziffern vorhanden ist. | boolean |
Kontostand | Der aktuelle Kontostand, falls vorhanden. | Zahl |
Wenn Sie den Konto-Webhook für diese Komponente überprüfen möchten, maximieren Sie die entsprechende Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- 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:valid_account“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Die Parameternamen dürfen nicht geändert werden, da sie von der Komponente für den Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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 anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kontonummer, des Zeitraums des Transaktionsverlaufs und aller vom Nutzer ausgewählten Filter abzurufen.
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 für den Empfang des Transaktionsverlaufs bestätigt hat. | String |
$flow.statement_start_date | Das angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. | String |
$flow.statement_end_date | (Optional) Das angeforderte Startdatum im Format „JJJJ-MM-TT“ Wenn vom Nutzer kein Wert angegeben wird oder der Aufrufer kein Enddatum angibt, wird standardmäßig das aktuelle Datum verwendet. | String |
$flow.transaction_credit_Debitkarte: | Vom Nutzer angeforderter Transaktionstyp Gültige Werte werden von der benutzerdefinierten Entität prebuilt_components_transaction_history_det_cred definiert. Standardmäßig werden "credit" und "debit" unterstützt. Lehnt der Nutzer die Auswahl eines Typs ab, ist dieser Wert ein leerer String "" und Transaktionen jedes Typs sollten gezählt werden. |
String |
$flow.merchant_name | Händlername, der vom Nutzer angefordert wurde. Wenn der Nutzer die Angabe eines Händlernamens ablehnt, ist dieser Wert ein leerer String "" und die Transaktionen aller Händler sollten gezählt werden. |
String |
$flow.high_amount_value | Minimaler Transaktionsbetrag, der vom Nutzer angefordert wird. 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, damit sie von der Komponente verwendet werden können.
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 zum Abrufen von Transaktionen für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- 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 in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Die Parameternamen dürfen nicht geändert werden, da sie von der Komponente für den Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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 vom Nutzer ausgewählte Filter angegeben.
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 für den Empfang des Transaktionsverlaufs bestätigt hat. | String |
$flow.statement_start_date | Das angeforderte Startdatum des Kontoauszugs im Format „JJJJ-MM-TT“. | String |
$flow.statement_end_date | (Optional) Das angeforderte Startdatum im Format „JJJJ-MM-TT“ | String |
$flow.transaction_credit_Debitkarte: | Vom Nutzer angeforderter Transaktionstyp Gültige Werte werden von der benutzerdefinierten 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 eines beliebigen Typs müssen gesendet werden. |
String |
$flow.merchant_name | Händlername, der vom Nutzer angefordert wurde. Wenn der Nutzer ablehnt, einen Händlernamen anzugeben, ist dieser Wert ein leerer String "" und Transaktionen von allen Händlern müssen gesendet werden. |
String |
$flow.high_amount_value | Minimaler Transaktionsbetrag, der vom Nutzer angefordert wird. Wenn der Nutzer die Angabe eines Betrags ablehnt, hat dieser Parameter den Standardwert 0 . |
integer |
$flow.channel_medium | Der Kanal, den der Nutzer für die Benachrichtigung ausgewählt hat. Gültige Werte werden von den 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 möchte, dass das Dokument vor dem Senden an den angegebenen Kanal verschlüsselt wird. Wenn vom Nutzer kein Wert angegeben wird oder der Aufrufer kein Enddatum angeben möchte, wird standardmäßig true verwendet. |
boolean |
Wenn Sie den Webhook „Informationen senden“ für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- 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 in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Die Parameternamen dürfen nicht geändert werden, da sie von der Komponente für den Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.