Einige Produkte und Funktionen werden gerade umbenannt. Auch die Funktionen für generative Playbooks und Workflows werden zu einer einzigen konsolidierten Console migriert. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Vordefinierte Komponente für Kontobericht

Kontobericht vordefinierte Komponente prüft die Authentifizierungsstufe des Kunden und sendet dann den Kontobericht für einen bestimmten Zeitraum an einen authentifizierten Kunden zu senden. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das Konto, für das der Kunde einen Kontoauszug abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine benutzerdefinierte Version der Datensatzsammlung „Geburtsdatum“, um Start- und Enddatum für den Abrechnungszeitraum zu erfassen.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten, für diese vordefinierte Komponente gelten die folgenden Einschränkungen:

Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von diesem vordefinierte Komponente. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung ausgelöst.

Einzelkonto

Der Endnutzer hat ein einzelnes Konto. Der Kundenservicemitarbeiter erfasst das Start- und Enddatum der Kontoabrechnung, ob der Nutzer die Kontoabrechnung verschlüsseln möchte, und sendet die Kontoabrechnung an den Nutzer.

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 eine Kontonummer gefunden, die auf 1001 endet. Bitte geben Sie das Startdatum Ihres Kontoauszugs an, das mit dem Monat, dem Tag und dem Jahr beginnt. Die Kontoabrechnung umfasst nur die letzten 90 Tage.
	Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mit der vordefinierten Komponente Geburtsdatum
	Sehr gut, wir haben das Startdatum deines Kontoauszugs erfasst. Bitte gib das Enddatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Der Zeitraum für den Kontobericht wird nur für die letzten 90 Tage angegeben.
	Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mit der vordefinierten Komponente Geburtsdatum
	Vielen Dank. Bitte teilen Sie uns mit, ob Sie den Kontoauszug vom 12.07.2023 bis zum 24.07.2023 suchen.
Ja
	Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen. Wir haben Transaktionen vom 12.07.2023 bis zum 24.07.2023 gefunden. Möchten Sie es per E-Mail, SMS oder WhatsApp erhalten?
SMS
	Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Nein danke
	Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihrem registrierten Mobiltelefon.

Mehrere Konten

Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter bestätigt, für welches Konto der Nutzer eine Kontoabrechnung anfordert. Der Kundenservicemitarbeiter erfasst den Beginn des Kontoauszugs Enddaten angeben, ob der Nutzer die Anweisung verschlüsseln möchte und den Kontobericht des Nutzers.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Agent authentifiziert Nutzer mit vordefinierter Authentifizierungskomponente
	Vielen Dank. Sie wurden erfolgreich 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, lauten 2002. Ist das richtig?
Ja
	Geben Sie das Startdatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.
	Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
	Sehr gut, wir haben das Startdatum deines Kontoauszugs erfasst. Bitte gib das Enddatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.
	Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
	Vielen Dank. Geht es um die Kontoabrechnung vom 18.07.2023 bis zum 22.07.2023?
Ja
	Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen. Wir haben Transaktionen vom 18.07.2023 bis zum 22.07.2023 gefunden. Möchtest du 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 an Ihre registrierte WhatsApp-Nummer gesendet. Sie erhalten die Kontoabrechnung innerhalb von 15 Minuten auf Ihrer registrierten WhatsApp-Nummer.

Namenskonventionen

Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:

Funktion	Format	Beispiel
Ablauf	[Component Name]	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 eines Komponente. Die Parameter werden von mindestens einer Bedingung im um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente wie unten beschrieben festgelegt werden. Auf Sitzungsebene Parameter können entweder von einem aufrufenden Ablauf oder beim Start Seite dieser Komponente.

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 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. Standardmäßig ist dieser Wert `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 Kontoauszug 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.account_statement_max_days	Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, das für das Startdatum eines Kontoauszugs zulässig ist. Standardmäßig ist dieser Wert auf `-90` gesetzt. Das bedeutet, dass das Startdatum der Abrechnung maximal 90 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Startseitenroute `true` konfiguriert.	integer
$flow.max_retry_count	Gibt an, wie oft der Endnutzer aufgefordert werden darf, ein gültiges Enddatum für die Kontoabrechnung anzugeben. Der Standardwert ist `3`.	integer
$flow.max_retry_confirm_period_counter	Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Abrechnungszeitraum mit dem Endnutzer bestätigt wird. Der Standardwert ist `3`.	integer
$flow.max_retry_statement_counter	Gibt die Anzahl der zulässigen Wiederholungen an, wenn mit dem angegebenen Anweisungszeitraum keine Transaktionen abgerufen werden. 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 Erstellen aus.
Klicken Sie im Bereich 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 stellt Werte für die folgende Ausgabe bereit Parameter:

Parametername	Beschreibung	Ausgabeformat
auth_level	Gibt die Authentifizierungsebene 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 mit der registrierten Telefonnummer verknüpft 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, ist der Wert dieses Parameters die letzten vier Ziffern der Kontonummer, für die der Nutzer Kontoabrechnungsinformationen erhalten möchte.	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. Siehe Integrierte Ereignisse ohne Eingabe. `max_no_match`: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse 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. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error.not-found“.	String

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte Komponente ein:

Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die flexible Webhooks mit Konfiguration, die Ihre externen Dienste beschreibt, siehe Webhook Einrichtung unten.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen aus Ihren externen Diensten abzurufen.

Authentifizierung

Wenn Sie noch keine externen Dienste konfiguriert haben, die für müssen Sie diese so konfigurieren, dass die Authentifizierung für diese Komponente. Eine ausführliche Anleitung findest du unter Authentifizierungs-Webhook einrichten.

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 das Kontoguthaben 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 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 ausgewählt und bestätigt hat, dass er Informationen zu seinem Konto erhalten möchte.	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 aktuelle Kontostand des Kontos, sofern vorhanden.	Zahl

Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.

Ö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.
Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
Klicken Sie auf Speichern.

Transaktionen abrufen

Der Webhook prebuilt_components_account_statement:get_transactions wird verwendet verwendet, um die Transaktionen für ein Konto abzurufen, registrierte Telefonnummer, die letzten vier Ziffern der Kontonummer und die Anweisungspunkt.

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 ausgewählt und bestätigt hat, dass er Informationen zu seinem Konto erhalten möchte.	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

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 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_account_statement:get_transactions“ 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 gewünschte Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
Klicken Sie auf Speichern.

Anforderungsaussage

Der Webhook prebuilt_components_account_statement:request_statement wird verwendet die Komponente verwendet, um einen Kontoauszug für ein Konto an einen die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer und den Anweisungspunkt.

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 ausgewählt und bestätigt hat, dass er Informationen zu seinem Konto erhalten möchte.	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.channel_medium	Der Kanal, über den der Nutzer die Nachricht erhalten möchte. 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 das Dokument vor dem Senden an den angegebenen Kanal verschlüsselt werden soll. Wenn der Nutzer keinen Wert angibt oder der Anrufer kein Enddatum angibt, wird standardmäßig `true` verwendet.	boolean

Wenn Sie den Webhook für die Erklärungsanfrage für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.

Ö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 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.
Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
Klicken Sie auf Speichern.

Abgeschlossen

Der Agent und seine Webhooks sollten jetzt eingerichtet und zum Testen bereit sein.