Die vorgefertigte Komponente für Kontoabrechnungen prüft die Authentifizierungsebene eines Kunden und sendet die Kontoabrechnung dann für einen bestimmten Zeitraum an einen authentifizierten Kunden. 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 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 Beispieldialoge veranschaulichen 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 vorgefertigten 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 und mit Ihrer Nummer verknüpft ist. 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 Ihres Kontoauszugs erfasst. Geben Sie 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 den Kontobericht vom 12.07.2023 bis zum 24.07.2023? | |
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 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 vorgefertigten Komponente Authentication | |
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 Ihres Kontoauszugs erfasst. Geben Sie 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öchten Sie es per E-Mail, SMS oder WhatsApp erhalten? |
|
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 vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion | Format | Beispiel |
---|---|---|
Flow | [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
Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. 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, damit ein Nutzer auf seine Kontoabrechnung 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 eingereicht 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 jeweilige 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 ein Startdatum der Abrechnung 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 Wiederholungsversuche an, wenn für den angegebenen Abrechnungszeitraum 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 Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben 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 Anrufers an. | integer |
phone_number | Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
account_count | Die Anzahl der Konten, die mit der registrierten Telefonnummer 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 | 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 kann einer der folgenden sein:agent : Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information : Der Endnutzer hat die von der Komponente angeforderten Informationen abgelehnt.max_no_input : Bei der Unterhaltung wurde die maximale Anzahl von Wiederholungen für No-Input-Ereignisse 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. Weitere Informationen finden Sie unter 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 bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook einrichten“.
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 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. Eine ausführliche Anleitung findest du unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Der prebuilt_components_account_services:validate_account
-Webhook 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 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, 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 |
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.
- 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 die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Transaktionen abrufen
Der prebuilt_components_account_statement:get_transactions
-Webhook wird von der Komponente verwendet, um die Transaktionen für ein Konto anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kontonummer und des Abrechnungszeitraums 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 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 |
$flow.statement_start_date | Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. | String |
$flow.statement_end_date | Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. 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 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 die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Kontoabrechnung anfordern
Über den prebuilt_components_account_statement:request_statement
-Webhook sendet die Komponente eine Kontoabrechnung an einen ausgewählten Kanal, sofern die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer und der Abrechnungszeitraum angegeben sind.
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 |
$flow.statement_start_date | Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. | String |
$flow.statement_end_date | Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. 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 das Ende nicht angeben möchte, 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 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 die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Bot und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.