Vordefinierte Komponente für Kontoabrechnungen

Die vordefinierte Komponente für den Kontoauszug überprüft die Authentifizierungsebene eines Kunden und sendet den Kontoauszug für einen bestimmten Zeitraum an einen authentifizierten Nutzer. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das spezifische Konto, für das der Nutzer einen Kontoauszug abrufen muss.

Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Kunden zu authentifizieren, und eine angepasste Version von Erfassung des Geburtsdatums, um Start- und Enddaten für den Abrechnungszeitraum 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. Sie zeigen das Verhalten, wenn Sie die Komponente über die Telefonie aufrufen. Dadurch werden der Standard-Willkommens-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.

Einzelnes Konto

Wenn der Nutzer ein einzelnes Konto hat, erfasst der Agent das Start- und Enddatum des Berichts, fragt, ob der Nutzer den Bericht verschlüsseln möchte, und sendet ihm den Kontobericht.

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 eine Kontonummer gefunden, die auf 1001 endet und mit Ihrer Nummer verknüpft ist. Bitte geben Sie das Startdatum des Kontoberichts an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur die letzten 90 Tage umfasst.
	Der KI-Agent erfasst das Startdatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Wir haben das Startdatum Ihres Kontoberichts erfasst. Geben Sie nun das Enddatum des Kontoberichts an. Beginnen Sie mit dem Monat, gefolgt vom Tag und dann vom Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur die letzten 90 Tage umfasst.
	Der Agent erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Bitte bestätigen Sie, ob Sie den Kontoauszug für den Zeitraum vom 12.07.2023 bis zum 24.07.2023 benötigen.
Ja
	Bitte warten Sie, während wir die Details zu Ihrem Kontoauszug abrufen. 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 mit Ihnen teilen?
Nein danke
	Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihrem registrierten Mobilgerät.

Mehrere Konten

Wenn der Nutzer mehrere Konten hat, bestätigt der Kundenservicemitarbeiter, für welches Konto der Nutzer einen Kontobericht anfordert. Der KI-Agent erfasst dann das Start- und Enddatum des Berichts, fragt, ob der Nutzer den Bericht verschlüsseln möchte, und sendet ihm den Kontobericht.

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?
2002
	Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, sind 2002. Ist das richtig?
Ja
	Geben Sie das Startdatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Bitte beachten Sie, dass der Kontoauszugszeitraum nur für die letzten 90 Tage angegeben wird.
	Der KI-Agent erfasst das Startdatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Wir haben das Startdatum Ihres Kontoberichts erfasst. Geben Sie nun das Enddatum des Kontoberichts an. Beginnen Sie mit dem Monat, gefolgt vom Tag und dann vom Jahr. Beachten Sie, dass der Zeitraum für den Kontobericht nur die letzten 90 Tage umfasst.
	Der Agent erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
	Vielen Dank. Bitte bestätigen Sie, ob Sie den Kontoauszug für den Zeitraum vom 18.07.2023 bis zum 22.07.2023 benötigen.
Ja
	Bitte warten Sie, während wir die Details zu Ihrem Kontoauszug abrufen. Wir haben Transaktionen vom 18.07.2023 bis zum 22.07.2023 gefunden. Möchten Sie ihn per E‑Mail, SMS oder WhatsApp erhalten?
WhatsApp
	Möchten Sie das Dokument verschlüsseln, bevor wir es mit Ihnen teilen?
Ja
	Die Passwortdetails werden über die WhatsApp-Nummer gesendet, die du bei der Registrierung angegeben hast. Du erhältst die Abrechnung innerhalb von 15 Minuten über die WhatsApp-Nummer, die du bei der Registrierung angegeben hast.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	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

Mit Eingabeparametern wird das Verhalten der Komponente konfiguriert. Eine oder mehrere Bedingungen im Ablauf verwenden die Parameter, um das Verhalten der Komponente zu bestimmen. Der Nutzer muss die Parameter auf Ablaufebene auf der Startseite der Komponente konfigurieren, wie in der folgenden Tabelle beschrieben. Der Nutzer kann Parameter auf Sitzungsebene auch entweder über einen Aufruffluss oder auf der Startseite dieser Komponente festlegen.

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 Kontoauszug zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments 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 wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments 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 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 Kontoauszug bereitgestellt 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 einer Anweisung zulässig sind. Standardmäßig ist dieser Wert auf -90 festgelegt. Das bedeutet, dass das Startdatum der Abrechnung maximal 90 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Route true der Startseite konfiguriert.	integer
$flow.max_retry_count	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer aufgefordert wird, ein gültiges Enddatum für die Abrechnung anzugeben. Der Standardwert ist 3.	integer
$flow.max_retry_confirm_period_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Abrechnungszeitraum mit dem Nutzer bestätigt wird. Der Standardwert ist 3.	integer
$flow.max_retry_statement_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn für den angegebenen Abrechnungszeitraum keine Transaktionen abgerufen werden. 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 aktiv bleiben, nachdem der Nutzer die Komponente verlassen hat. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden.

Diese vordefinierte Komponente bietet die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
auth_level	Gibt die Authentifizierungsebene des Aufrufers an.	integer
phone_number	Die lokale Telefonnummer des Anrufers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
account_count	Die Anzahl der Konten, die mit der registrierten Telefonnummer des Nutzers 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	Die letzten vier Ziffern der Kontonummer, für die der Nutzer Kontoberichtsinformationen erhalten möchte.	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 Nutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Nutzer 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 die vordefinierte Komponente ein:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit Einstellungen, die Ihre externen Dienste beschreiben. Weitere Informationen finden Sie im Abschnitt Webhook einrichten.

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, konfigurieren Sie sie, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Weitere Informationen zur Einrichtung von Webhooks 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 Anrufers 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 Informationen zum Kontoauszug zu erhalten.	String

API-Antwortparameter

Die Komponente ruft die folgenden Parameter aus der API-Antwort ab:

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

Wenn Sie den Webhook „Konto validieren“ 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_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. Überprü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.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Transaktionen abrufen

Der Webhook prebuilt_components_account_statement:get_transactions wird von der Komponente verwendet, um die Transaktionen für ein Konto abzurufen. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer und der Abrechnungszeitraum verwendet.

API-Anfrageparameter

Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Anrufers 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 Informationen zum Kontoauszug zu erhalten.	String
$flow.statement_start_date	Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“.	String
$flow.statement_end_date	(Optional) Das Enddatum 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

API-Antwortparameter

Die Komponente ruft die folgenden Parameter aus der API-Antwort ab:

Parametername	Beschreibung	Ausgabeformat
transactions_count	Die Anzahl der Transaktionen, die für das angegebene Konto im angegebenen Abrechnungszeitraum gefunden wurden.	integer

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Transaktionen abrufen“ 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_statement: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. Überprü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.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Kontoauszug anfordern

Der Webhook prebuilt_components_account_statement:request_statement sendet einen Kontoauszug für ein Konto an einen ausgewählten Kanal, basierend auf der registrierten Telefonnummer des Nutzers, den letzten vier Ziffern der Kontonummer und dem Abrechnungszeitraum.

API-Anfrageparameter

Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Anrufers 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 Informationen zum Kontoauszug zu erhalten.	String
$flow.statement_start_date	Das Startdatum des angeforderten Kontoauszugs im Format „JJJJ-MM-TT“.	String
$flow.statement_end_date	(Optional) Das Enddatum 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.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_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 das Dokument vor dem Senden an den angegebenen Kanal verschlüsseln möchte. Wenn der Nutzer keinen Wert angibt oder der Anrufer keine Verschlüsselungseinstellung angibt, wird standardmäßig der Wert true verwendet.	boolean

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für die Kontoauszugsanfrage 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_statement:request_statement“ 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. Überprü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.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Die vordefinierte Komponente und ihre Webhooks sind jetzt eingerichtet und können getestet werden.