Transaktionsverlauf vordefinierte Komponente prüft die Authentifizierungsstufe des Kunden erfasst dann den Zeitraum der Transaktionen und andere Filter, die angewendet werden, Transaktionsverlauf abrufen. Diese Komponente unterstützt Filter für:
- Transaktionstyp
- Händlername
- Transaktionsbetrag
Wenn der Kunde mehrere Konten hat, das spezifische Konto bestätigt, das der Kunde den Transaktionsverlauf abrufen möchte für die Sie angegeben haben. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine benutzerdefinierte Version der Sammlung „Geburtsdatum“, 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 Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialogfelder zeigen das Verhalten, wenn die Komponente aufgerufen, was den Standard-Begrüßungs-Intent und den ersten Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.
Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Agent bestätigt, welches Konto der Nutzer ist den Transaktionsverlauf anfordert. Der Kundenservicemitarbeiter 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 den Transaktionsverlauf an den Nutzer senden.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication. | |
| 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. Bitte geben Sie die letzten vier Ziffern des betreffenden Kontos an. |
|
| 1001 | |
| Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, lauten 1001. Ist das richtig? | |
| Ja | |
| Geben Sie das Startdatum der Transaktionen an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Der Transaktionsverlauf umfasst nur die letzten 90 Tage. | |
| Kundenservicemitarbeiter erfasst das Startdatum der Transaktionen mit der vordefinierten Komponente Geburtsdatum | |
| Super, wir haben das Startdatum Ihrer Transaktionen erfasst. Geben Sie das Enddatum Ihrer Transaktionen an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Der Transaktionsverlauf umfasst nur die letzten 90 Tage. |
|
| Kundenservicemitarbeiter erfasst das Startdatum von Transaktionen mithilfe der vorgefertigten Komponente Geburtsdatum | |
| Vielen Dank. Geht es um die Transaktionen vom 25. Juni 2023 bis zum 21. Juli 2023? | |
| Ja | |
| Bitte teilen Sie uns den Namen des Händlers mit, für den Sie Transaktionen abrufen möchten. | |
| Der erfasste Händlername lautet „Google“. Können Sie dies bitte mit Ja oder Nein bestätigen? | |
| Ja | |
| Möchten Sie den Transaktionsverlauf für Ihre Debit- oder Kreditkarten aufrufen? | |
| Guthaben | |
| Geben Sie einen Betrag zum Abrufen von Transaktionen in Höhe des angegebenen Betrags oder darüber an. Wenn Sie beispielsweise Transaktionen über 100,30 € finden möchten, sagen Sie „100“. | |
| 500 | |
| Bitte warten Sie, während wir Ihre Transaktionsdetails abrufen. Wir haben Transaktionen vom 2. Juni 2023 bis zum 21. Juli 2023 gefunden. Möchtest du 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 an Ihr registriertes Mobiltelefon gesendet. Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihr registriertes Mobiltelefon. |
Namenskonventionen
Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:
| Funktion | Format | Beispiel |
|---|---|---|
| Ablauf | [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 eines Komponente. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs 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. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf 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 der Auftragsausführung für Seiteneinträge 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 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 wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge 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 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 seine spezifische Kontonummer 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 ist. Standardmäßig ist dieser Wert -90. Das bedeutet, dass das Startdatum der Transaktionen nicht mehr als 90 Tage vor dem aktuellen Datum beginnen darf. Dieser Parameter wird in der Route der Startseite true 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 eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
- Ö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 Abschnitt Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Parametervoreinstellungen nach Bedarf.
- 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 Authentifizierungsstufe des Aufrufers an. | integer |
| phone_number | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| account_count | Die Anzahl der Konten, die der registrierten Telefonnummer zugeordnet sind. Dazu gehören eigene Konten sowie 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 mehrere Konten hat, besteht der Wert dieses Parameters aus den letzten vier Ziffern der Kontonummer, die er für den Erhalt des Transaktionsverlaufs 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 irgendwann während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Ereignisse ohne Eingabe.max_no_match: Die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung wurde für die Unterhaltung erreicht. Siehe Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event. |
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 Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook einrichten“.
Webhook-Einrichtung
Zur Verwendung dieser Komponente müssen Sie die in flexiblen Webhooks zum Abrufen Informationen von Ihren externen Diensten benötigt.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies nachholen, damit die Authentifizierung von Nutzern für diese Komponente möglich ist. Siehe Einrichtung des Authentifizierungs-Webhooks .
Konto validieren
Der Webhook prebuilt_components_account_services:validate_account wird verwendet
die Komponente überprüft, um zu überprüfen,
ob ein Konto vorhanden ist.
registrierte Telefonnummer und die letzten vier Ziffern der angegebenen Kontonummer.
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 Ortstelefonnummer 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, für die der Nutzer Informationen zur Kontoabrechnung ausgewählt und bestätigt hat. | 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 Kontostands, falls vorhanden. | Zahl |
Erweitern Sie die Anleitung, um den Konto-Webhook für diese Komponente zu konfigurieren.
- Ö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:validate_account“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (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 Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
- Klicken Sie auf Speichern.
Transaktionen abrufen
Über den prebuilt_components_transaction_history:get_transactions-Webhook ruft die Komponente die Anzahl der Transaktionen für ein Konto ab, basierend auf der registrierten Telefonnummer des Nutzers, den letzten vier Ziffern der Kontonummer, dem Zeitraum des Transaktionsverlaufs und allen vom Nutzer ausgewählten Filtern.
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 Ortstelefonnummer 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 für den Empfang des Transaktionsverlaufs ausgewählt und bestätigt hat. | String |
| $flow.statement_start_date | Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angibt, wird standardmäßig das aktuelle Datum verwendet. | String |
| $flow.transaction_credit_debit | Vom Nutzer angeforderter Transaktionstyp. Gültige Werte werden durch das benutzerdefinierte Element 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 | Vom Nutzer angeforderter Händlername. Wenn der Nutzer die Angabe eines Händlernamens ablehnt, ist dieser Wert ein leerer String (""). Transaktionen aller Händler 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 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 |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Transaktionen abrufen“ für diese Komponente aufzurufen.
- Ö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 für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
- Klicken Sie auf Speichern.
Info senden
Der Webhook prebuilt_components_transaction_history:send_info wird verwendet
verwendet, um einen Transaktionsverlauf an einen
ausgewählten Kanal zu senden.
die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer,
Zeitraum des Transaktionsverlaufs und ggf. vom Nutzer ausgewählte Filter.
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 Ortstelefonnummer 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 für den Empfang des Transaktionsverlaufs ausgewählt und bestätigt hat. | String |
| $flow.statement_start_date | Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. | String |
| $flow.transaction_credit_debit | Der vom Nutzer angeforderte 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 aller Typen sollten gesendet werden. |
String |
| $flow.merchant_name | Vom Nutzer angeforderter 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 Mindesttransaktionsbetrag. Wenn der Nutzer keinen Betrag angibt, hat dieser Parameter den Standardwert 0. |
integer |
| $flow.channel_medium | Der Kanal, über den der Nutzer die Nachricht erhalten möchte. 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 das Dokument vor dem Senden an den angegebenen Kanal verschlüsselt werden soll. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angeben möchte, wird standardmäßig true verwendet. |
boolean |
Wenn Sie den Webhook „Send Info“ für diese Komponente konfigurieren möchten, maximieren Sie das Fenster, um die Anleitung aufzurufen.
- Ö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 für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.