Vordefinierte Komponente für Kontobericht

Die vordefinierte Komponente eines Kontoberichts prüft die Authentifizierungsstufe eines Kunden und sendet den Kontobericht für einen bestimmten Zeitraum an einen authentifizierten Kunden. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das spezifische Konto, für das der Kunde einen Kontobericht abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung zur Authentifizierung von Nutzern und verwendet eine benutzerdefinierte Version von Geburtsdatumsdaten, um das Start- und Enddatum für den Zeitraum der Anweisung 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.

Einzelnes Konto

Der Endnutzer hat ein einzelnes Konto. Der Agent erfasst das Start- und Enddatum des Kontoauszugs und gibt an, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet den Kontobericht 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 eine Kontonummer mit der Endung 1001 gefunden, die mit Ihrer Nummer verknüpft ist. Bitte geben Sie das Startdatum des Kontoberichts an, das mit dem Monat, danach den Tag und dann das Jahr beginnt. Beachten Sie, dass der Zeitraum für den Kontobericht nur für die letzten 90 Tage angezeigt wird.
	Der Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
	Wir haben das Startdatum des Kontoauszugs erfasst. Bitte geben Sie das Enddatum des Kontoauszugs an, beginnend mit dem Monat, danach den Tag und dann das Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur für die letzten 90 Tage angezeigt wird.
	Der Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
	Vielen Dank. Möchten Sie einen Kontoauszug für den Zeitraum vom 12.07.2023 bis zum 24.07.2023 benötigen?
Ja
	Bitte warte, während die Details deines Kontoauszugs abgerufen werden. Wir haben Transaktionen vom 12.07.2023 bis zum 24.07.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
SMS
	Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Nein danke
	Du erhältst die Abrechnung innerhalb von 15 Minuten auf deinem registrierten Mobilgerät.

Mehrere Konten

Der Endnutzer hat mehrere Konten. Der Agent bestätigt, für welches Konto der Nutzer einen Kontoauszug anfordert. Der Agent erfasst das Start- und Enddatum des Kontoauszugs und gibt an, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet den Kontobericht 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?
2002
	Die letzten vier Stellen der Kontonummer, die wir erhalten haben, sind 2002, richtig?
yes
	Geben Sie das Startdatum des Kontoberichts an. Es beginnt mit dem Monat, dem Tag und dann dem Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur für die letzten 90 Tage angezeigt wird.
	Der Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
	Wir haben das Startdatum des Kontoauszugs erfasst. Bitte geben Sie das Enddatum des Kontoauszugs an, beginnend mit dem Monat, danach den Tag und dann das Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur für die letzten 90 Tage angezeigt wird.
	Der Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
	Vielen Dank. Möchten Sie einen Kontoauszug für den Zeitraum zwischen dem 18.07.2023 und dem 22.07.2023 benötigen?
Ja
	Deine Kontoauszüge werden abgerufen. Wir haben Transaktionen vom 18.07.2023 bis zum 22.07.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
WhatsApp
	Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Ja
	Die Passwortdetails werden in Ihrer registrierten WhatsApp-App geteilt. Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihrer registrierten WhatsApp-Adresse.

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Fluss	[Komponentenname]	Kontobericht
Komponentenspezifischer Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_account_number_collection_four_digit_account_number
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_account_statement_channelall
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_account_statement:request_statement

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 Anrufers an.	integer
$session.params.auth_level_req	Gibt die Authentifizierungsstufe an, die erforderlich ist, bevor ein Nutzer auf seinen Kontobericht 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 Kontoauszug eingereicht werden soll. 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.account_statement_max_days	Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, die für das Startdatum eines Kontoauszugs zulässig sind. Standardmäßig lautet dieser Wert `-90`. Das bedeutet, dass das Startdatum der Anweisung maximal 90 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Route `true` der Startseite konfiguriert.	integer
$flow.max_retry_count [Anzahl_der_Wiederholungen]	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Endnutzer aufgefordert wird, ein gültiges Enddatum für die Anweisung anzugeben. Der Standardwert ist `3`.	integer
$flow.max_retry_confirm_period_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Anweisungszeitraum beim Endnutzer bestätigt werden soll. Der Standardwert ist `3`.	integer
$flow.max_retry_statement_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn im angegebenen Abrechnungszeitraum keine Transaktionen abgerufen werden. 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 Aufrufs 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 mehrere Konten hat, besteht dieser Parameter aus den letzten vier Ziffern der Kontonummer, die der Nutzer für den Erhalt von Kontoberichtsinformationen 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_account_statement:get_transactions wird von der Komponente verwendet, um anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kontonummer und des Abrechnungszeitraums die Transaktionen für ein Konto 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 bestätigt hat, für die er Kontoberichtsinformationen erhalten möchte.	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

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 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_account_statement: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.

Anforderungsbeschreibung

Der Webhook prebuilt_components_account_statement:request_statement wird von der Komponente verwendet, um eine Anweisung für ein Konto an einen ausgewählten Kanal zu senden. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer und der Zeitraum der Anweisung 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 bestätigt hat, für die er Kontoberichtsinformationen erhalten möchte.	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.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_account_statement_channelphn` und `prebuilt_components_account_statement_channelall` 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

Um den Webhook der Anforderungsanweisung für diese Komponente zu konfigurieren, 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_statement:request_statement“ 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.