Vordefinierte Komponente für Kreditkartenabrechnungen

Die vordefinierte Komponente für die Kreditkartenabrechnung prüft die Authentifizierungsebene des Nutzers und sendet dann die Kreditkartenabrechnung für einen bestimmten Zeitraum an den authentifizierten Nutzer. Wenn Sie mehrere Kreditkarten haben, bestätigt die Komponente die spezifische Karte, für die eine Kreditkartenabrechnung abgerufen werden soll.

Diese Komponente verwendet eine angepasste Version der vordefinierten Komponente Authentifizierung, um Karteninhaber zu authentifizieren, und eine angepasste Version der Komponente Geburtsdatum erfassen, 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 Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Sie zeigen das Verhalten, wenn der Nutzer die Komponente per Telefonie aufruft. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des KI-Agenten zu Beginn der Unterhaltung ausgelöst.

Einzelne Kreditkarte

Der Nutzer hat eine einzige Kreditkarte. Der Agent erfasst das Start- und Enddatum der Abrechnung und fragt, ob der Nutzer die Abrechnung verschlüsseln möchte. Anschließend sendet er die Kreditkartenabrechnung an den Nutzer.

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 Kartendetails abrufen.

Wir haben eine Kartennummer gefunden, die auf 1002 endet und mit Ihrer Nummer verknüpft ist.
Geben Sie das Startdatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage bereitgestellt.
Der KI-Agent erfasst das Startdatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
Wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie jetzt bitte das Enddatum Ihrer Kreditkartenabrechnung an. Beginnen Sie mit dem Monat, gefolgt vom Tag und dann vom Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage bereitgestellt.
Der KI-Agent erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte bestätigen Sie, ob Sie den Kontoauszug für den Zeitraum vom 01.06.2023 bis zum 30.06.2023 benötigen.
Ja
Bitte warten Sie, während wir die Details zu Ihrem Kontoauszug abrufen.

Wir haben Transaktionen zwischen dem 01.06.2023 und dem 30.06.2023 gefunden. Möchten Sie ihn per E‑Mail, SMS oder WhatsApp erhalten?
An meine E‑Mail-Adresse senden
Möchten Sie das Dokument verschlüsseln, bevor wir es mit Ihnen teilen?
Nein danke
Sie erhalten den Kontoauszug innerhalb von 15 Minuten an Ihre registrierte E-Mail-Adresse.

Mehrere Kreditkarten

Wenn der Nutzer mehrere Kreditkarten hat, bestätigt der Kundenservicemitarbeiter, für welche Karte der Nutzer eine Kreditkartenabrechnung anfordert. Der Agent erfasst das Start- und Enddatum der Abrechnung, prüft, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet die Kreditkartenabrechnung an den Nutzer.

Nutzereingabe Antwort des KI-Agenten
Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Authentifizierung.
Vielen Dank, Sie wurden erfolgreich validiert.
Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer zwei Karten verknüpft sind. Gib die letzten vier Ziffern der Karte an, auf die du dich beziehst.
1122
Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 1122. Ist das richtig?
Ja
Geben Sie das Startdatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann vom Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage bereitgestellt.
Der KI-Agent erfasst das Startdatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
Wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie jetzt bitte das Enddatum Ihrer Kreditkartenabrechnung an. Beginnen Sie mit dem Monat, gefolgt vom Tag und dann vom Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage bereitgestellt.
Der KI-Agent erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum.
Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte bestätigen Sie, ob Sie den Kontoauszug für den Zeitraum vom 13.07.2023 bis zum 14.07.2023 suchen.
Ja
Bitte warten Sie, während wir die Details zu Ihrem Kontoauszug abrufen.

Wir haben Transaktionen zwischen dem 13.07.2023 und dem 14.07.2023 gefunden. Möchten Sie ihn per E‑Mail, SMS oder WhatsApp erhalten?
SMS
Möchten Sie das Dokument verschlüsseln, bevor wir es mit Ihnen teilen?
Ja
Die Passwortdetails werden an dein registriertes Mobilgerät gesendet.

Du erhältst den Kontoauszug innerhalb von 15 Minuten auf deinem registrierten Mobilgerät.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Kreditkartenabrechnung
Entitätstyp prebuilt_components_[component_name]_[entity_type] prebuilt_components_statement_channel_all
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_credit_card_statement:request_statement

Eingabeparameter

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Eine oder mehrere Bedingungen im Ablauf verwenden diese Parameter, um das Verhalten der Komponente zu bestimmen. Sie müssen Parameter mit Ablaufbereich auf der Startseite der Komponente festlegen. Sie können Parameter auf Sitzungsebene mithilfe eines Aufrufflusses 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 der Nutzer auf seine Kreditkartenabrechnung zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen des Seitenaufruf-Fulfillments 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 Seitenaufruf-Fulfillments auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false. 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 Seitenaufruf-Fulfillments auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true. boolean
$session.params.phone_number (Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. String
$session.params.credit_card_count (Optional) Die Anzahl der Kreditkarten, die mit dem authentifizierten Nutzer verknüpft sind. integer
$session.params.last_four_digit_of_card_number (Optional) Die letzten vier Ziffern der Kreditkartennummer des Kunden, für die der Kontoauszug bereitgestellt werden muss. Wenn der Kunde nur eine Karte hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Karten hat, wird die spezifische Kartennummer vom Kunden erfasst. String
$session.params.credit_card_statement_max_days Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, die für das Startdatum einer Abrechnung zulässig sind. Standardmäßig ist dieser Wert -180, was bedeutet, dass das Startdatum der Abrechnung maximal 180 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der true-Route 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

Maximieren Sie den 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 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 Authentifizierungsebene des Aufrufers an. integer
phone_number Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String
credit_card_count Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind. integer
last_four_digit_of_card_number Wenn der Nutzer eine einzelne Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn der Nutzer mehr als eine Karte hat, ist der Wert dieses Parameters die letzten vier Ziffern der Kartennummer, die der Nutzer ausgewählt hat, um Informationen zur Kartenabrechnung zu erhalten. 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. Siehe 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 diese 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-Einrichtung.

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, müssen Sie sie konfigurieren, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Weitere Informationen finden Sie unter Authentifizierungs-Webhook einrichten.

Kreditkartendetails abrufen

Der Webhook prebuilt_components_credit_card_statement:credit_card_details ruft Kreditkartendetails für eine registrierte Telefonnummer ab.

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 Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
credit_card_count Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind. integer
credit_card Die letzten vier Ziffern der Kreditkartennummer des Kunden. Wenn der Kunde mehrere Karten hat, ist dieser Wert null. String
E-Mail Die registrierte E‑Mail-Adresse des Nutzers. Wenn für die Telefonnummer keine E-Mail-Adresse registriert ist, lautet dieser Wert null. String

Maximieren Sie den Bereich, um eine Anleitung zum Konfigurieren des Webhooks „Kreditkartendetails abrufen“ für diese Komponente zu erhalten.

  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_credit_card_statement:credit_card_details“ 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. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Karte validieren

Die Komponente verwendet den Webhook prebuilt_components_credit_card_statement:validate_date, um zu prüfen, ob eine bestimmte Kreditkarte für eine registrierte Telefonnummer vorhanden ist.

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 Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.last_four_digit_of_card_number Die letzten vier Ziffern der vom Nutzer angegebenen Kartennummer. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
valid_card Gibt an, ob die angegebene Karte für die registrierte Telefonnummer gefunden wurde. boolean

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Karte validieren“ 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_credit_card_statement:validate_card“ 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. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Transaktionen abrufen

Die Komponente verwendet den Webhook prebuilt_components_credit_card_statement:card_transaction_details, um Transaktionen für eine Karte abzurufen. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kartennummer 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 Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.last_four_digit_of_card_number Die letzten vier Ziffern der Kartennummer, die der Nutzer ausgewählt und bestätigt hat, um Informationen zur Kartenabrechnung 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 angibt, 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 die angegebene Kreditkarte 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_credit_card_statement:card_transaction_details“ 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. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Kontoauszug anfordern

Die Komponente verwendet den Webhook prebuilt_components_credit_card_statement:request_statement, um eine Kreditkartenabrechnung an einen ausgewählten Kanal zu senden. Dazu werden die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kreditkartennummer 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 Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.last_four_digit_of_card_number Die letzten vier Ziffern der Kartennummer, die der Nutzer ausgewählt und bestätigt hat, um Informationen zur Kartenabrechnung 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 angibt, 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_statement_channel_phone und prebuilt_components_statement_channel_all 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 die Verschlüsselung ablehnt, 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_credit_card_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. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, 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 für Kreditkartenabrechnungen und ihre Webhooks sind jetzt eingerichtet und können getestet werden.