Vordefinierte Komponente für Kreditkartenabrechnungen

Die vordefinierte Komponente der Kreditkartenabrechnung prüft die Authentifizierungsstufe eines Kunden und sendet die Kreditkartenabrechnung für einen bestimmten Zeitraum an einen authentifizierten Kunden. Wenn der Kunde mehrere Kreditkarten hat, bestätigt die Komponente die spezifische Karte, für die der Kunde eine Kreditkartenabrechnung abrufen möchte. Diese Komponente verwendet eine angepasste Version der vordefinierten Komponente Authentifizierung zur Authentifizierung von Karteninhabern und eine angepasste Version der Erfassung des Geburtsdatums, um das 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 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.

Einzelne Kreditkarte

Der Endnutzer hat nur eine Kreditkarte. Der Agent erfasst das Start- und Enddatum des Kontoauszugs und sendet die Kreditkartenabrechnung 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 Kartendetails abgerufen werden.

Wir haben festgestellt, dass Ihrer Nummer eine Kartennummer mit den Endziffern 1002 zugeordnet ist.
Geben Sie das Startdatum Ihrer Kreditkartenabrechnung an. Es beginnt mit dem Monat, gefolgt von Tag und Jahr. Beachten Sie, dass die Kreditkartenabrechnung nur für die letzten 180 Tage bereitgestellt wird.
Der Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
Wir haben das Startdatum deiner Kreditkartenabrechnung erfasst.

Gib das Enddatum deiner Kreditkartenabrechnung an, das mit dem Monat beginnt, danach den Tag und dann das Jahr. Beachten Sie, dass die Kreditkartenabrechnung nur für die letzten 180 Tage bereitgestellt wird.
Der Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte teilen Sie uns mit, ob es sich um eine Abrechnung zwischen dem 01.06.2023 und dem 30.06.2023 handelt.
Ja
Bitte warte, während die Details deines Kontoauszugs abgerufen werden.

Wir haben Transaktionen zwischen dem 01.06.2023 und dem 30.06.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
An meine E-Mail-Adresse senden
Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Nein danke
Sie erhalten die Abrechnung innerhalb von 15 Minuten an Ihre registrierte E-Mail-Adresse.

Mehrere Kreditkarten

Der Endnutzer hat mehrere Kreditkarten. Der Agent bestätigt, für welche Karte der Nutzer eine Kreditkartenabrechnung anfordert. Der Agent erfasst das Start- und Enddatum des Kontoauszugs und sendet die Kreditkartenabrechnung an den Nutzer.

Nutzereingabe Agent-Antwort
Der Agent authentifiziert den Nutzer mit der vordefinierten Authentifizierung-Komponente
Vielen Dank, Sie wurden bestätigt.
Bitte warten Sie, während Ihre Kartendetails abgerufen werden.

Wir haben festgestellt, dass Ihrer Nummer zwei Karten zugeordnet sind. Könnten Sie uns bitte die letzten vier Ziffern der Kartennummer nennen, auf die Sie sich beziehen?
1122
Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 1122, richtig?
Ja
Geben Sie das Startdatum Ihrer Kreditkartenabrechnung an. Es beginnt mit dem Monat, gefolgt von Tag und Jahr. Beachten Sie, dass die Kreditkartenabrechnung nur für die letzten 180 Tage bereitgestellt wird.
Der Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
Wir haben das Startdatum deiner Kreditkartenabrechnung erfasst.

Gib das Enddatum deiner Kreditkartenabrechnung an, das mit dem Monat beginnt, danach den Tag und dann das Jahr. Beachten Sie, dass die Kreditkartenabrechnung nur für die letzten 180 Tage bereitgestellt wird.
Der Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mithilfe der vordefinierten Komponente Geburtsdatum
Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte teilen Sie uns mit, ob es sich um eine Abrechnung zwischen dem 13.07.2023 und dem 14.07.2023 handelt.
Ja
Bitte warte, während die Details deines Kontoauszugs abgerufen werden.

Wir haben Transaktionen zwischen dem 13.07.2023 und dem 14.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?
Ja
Die Passwortdetails werden auf dein registriertes Mobilgerät geteilt.

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

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion Format Beispiel
Fluss [Komponentenname] 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

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 Aufrufers an. integer
$session.params.auth_level_req Gibt die Authentifizierungsstufe an, die erforderlich ist, bevor ein Nutzer auf seine Kreditkartenabrechnung 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 Authentifizierungsstufen 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.card_auth_enabled Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll, wie unter Authentifizierungsstufen 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.phone_number (Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. String
$session.params.credit_card_count Optional: Anzahl der Kreditkarten, die dem authentifizierten Nutzer zugeordnet sind. integer
$session.params.last_four_digit_of_card_number (Optional) Die letzten vier Ziffern der Kundenkartennummer, für die der Kontoauszug eingereicht 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 eines Kontoauszugs zulässig sind. Standardmäßig lautet dieser Wert -180. Das bedeutet, dass das Startdatum der Anweisung maximal 180 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

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Build aus.
  5. Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
  6. Klicken Sie im Bereich Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Voreinstellungen für Parameter) nach Bedarf.
  9. 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 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 der registrierten Telefonnummer zugeordnet sind. integer
last_four_digit_of_card_number Wenn ein Nutzer nur eine Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, besteht der Wert dieses Parameters aus den letzten vier Ziffern der Kartennummer, die der Nutzer für den Erhalt von Kreditkartenabrechnungsdaten 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:

  1. Importieren Sie die vordefinierte Komponente.
  2. 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.

Kreditkartendetails abrufen

Der Webhook prebuilt_components_credit_card_statement:credit_card_details wird von der Komponente verwendet, um Kreditkartendetails für eine registrierte Telefonnummer 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

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.

Parametername Beschreibung Ausgabeformat
credit_card_count Die Anzahl der Kreditkarten, die der registrierten Telefonnummer zugeordnet 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 der Wert null. String

Wenn Sie den Webhook „Kreditkartendetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

  1. Öffnen Sie die Dialogflow CX Console.
  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 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.
  8. Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
  9. 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.
  10. Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
  11. Klicken Sie auf Speichern.

Karte validieren

Der Webhook prebuilt_components_credit_card_statement:validate_date wird von der Komponente verwendet, um zu prüfen, ob eine bestimmte Kreditkarte für eine registrierte Telefonnummer 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_card_number Die letzten vier Ziffern der vom Nutzer angegebenen Kreditkartennummer. String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.

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

Wenn Sie den Webhook „Karten validieren“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

  1. Öffnen Sie die Dialogflow CX Console.
  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:valid_card“ aus.
  7. 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.
  8. Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
  9. 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.
  10. Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
  11. Klicken Sie auf Speichern.

Transaktionen abrufen

Der Webhook prebuilt_components_credit_card_statement:card_transaction_details wird von der Komponente verwendet, um die Transaktionen für eine Karte unter Angabe der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kartennummer 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 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 für den Erhalt seiner Kreditkartenabrechnung bestätigt hat. 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 die angegebene Kreditkarte 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.

  1. Öffnen Sie die Dialogflow CX Console.
  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 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.
  8. Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
  9. 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.
  10. Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
  11. Klicken Sie auf Speichern.

Anforderungsbeschreibung

Der Webhook prebuilt_components_credit_card_statement:request_statement wird von der Komponente verwendet, um einen Kontoauszug für eine Kreditkarte anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kreditkartennummer und des Abrechnungszeitraums an einen ausgewählten Kanal zu senden.

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_card_number Die letzten vier Ziffern der Kartennummer, die der Nutzer ausgewählt und für den Erhalt seiner Kreditkartenabrechnung bestätigt hat. 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_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 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.

  1. Öffnen Sie die Dialogflow CX Console.
  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 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.
  8. Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
  9. 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.
  10. Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
  11. Klicken Sie auf Speichern.

Fertig

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

Zurück
Erfassung von Kreditkartennummern
Weiter
Sammlung des Geburtsdatums