Vordefinierte Komponente für Kreditkartenabrechnungen

Die vorgefertigte Komponente für Kreditkartenabrechnungen prüft die Authentifizierungsstufe eines Kunden und sendet die Kreditkartenabrechnung dann für einen bestimmten Zeitraum an einen authentifizierten Kunden. Wenn der Kunde mehrere Kreditkarten hat, bestätigt die Komponente die jeweilige Karte, für die der Kunde eine Kreditkartenabrechnung abrufen möchte. Diese Komponente verwendet eine benutzerdefinierte Version der vordefinierten Komponente Authentifizierung, um Karteninhaber zu authentifizieren, und eine benutzerdefinierte Version der Datenerfassung für das 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 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.

Einzelne Kreditkarte

Der Endnutzer hat eine einzige Kreditkarte. Der Kundenservicemitarbeiter erfragt das Start- und Enddatum der Abrechnung, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet die Kreditkartenabrechnung 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 Kartendetails abrufen.

Wir haben eine Kartennummer gefunden, die auf 1002 endet und mit Ihrer Nummer verknüpft ist.
Geben Sie das Startdatum des Kreditkartenabzugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.
Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
Super, wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie das Enddatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.
Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
Sehr gut. Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte bestätigen Sie, dass Sie die Abrechnung vom 01.06.2023 bis zum 30.06.2023 benötigen.
Ja
Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen.

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 den Kontoauszug innerhalb von 15 Minuten an Ihre registrierte E-Mail-Adresse.

Mehrere Kreditkarten

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

Nutzereingabe Antwort des Kundenservicemitarbeiters
Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vorgefertigten Komponente Authentication
Vielen Dank. Ihre Bestätigung war erfolgreich.
Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer zwei Karten verknüpft sind. Wie lauten die letzten vier Ziffern der Karte, um die es hier geht?
1122
Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 1122. Ist das richtig?
Ja
Geben Sie das Startdatum des Kreditkartenabzugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.
Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
Super, wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie das Enddatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.
Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum
Sehr gut. Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Geht es um die Abrechnung vom 13.07.2023 bis zum 14.07.2023?
Ja
Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen.

Wir haben Transaktionen vom 13.07.2023 bis zum 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 an Ihr registriertes Mobiltelefon gesendet.

Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihr registriertes Mobiltelefon.

Namenskonventionen

Für diese vorgefertigte 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. 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 Authentifizierungsstufe an, die erforderlich ist, damit ein Nutzer auf seine Kreditkartenabrechnung 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 Authentifizierungsebenen 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 false. boolean
$session.params.card_auth_enabled Gibt an, ob der Nutzer wie unter Authentifizierungsebenen 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 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 mit dem authentifizierten Nutzer verknüpft sind. integer
$session.params.last_four_digit_of_card_number (Optional) Die letzten vier Ziffern der Kundenkartennummer, für die die Kontoabrechnung 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 jeweilige 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 ein Startdatum der Abrechnung zulässig ist. Standardmäßig ist dieser Wert auf -180 festgelegt. Das bedeutet, dass das Startdatum der Abrechnung maximal 180 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

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.

  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 Erstellen aus.
  5. Klicken Sie im Bereich 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 für die Parametervorgaben 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 Authentifizierungsstufe des Anrufers an. integer
phone_number Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, 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 ein Nutzer nur eine Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, entspricht der Wert dieses Parameters den letzten vier Ziffern der Kartennummer, für die der Nutzer Informationen zur Kreditkartenabrechnung 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: Die Unterhaltung hat 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:

  1. Importieren Sie die vordefinierte Komponente.
  2. 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, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Eine ausführliche Anleitung findest du unter Authentifizierungs-Webhook einrichten.

Kreditkartendetails abrufen

Der prebuilt_components_credit_card_statement:credit_card_details-Webhook 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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, ist dieser Wert null. String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get credit card details“ (Kreditkartendetails abrufen) für diese Komponente aufzurufen.

  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 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.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Karte bestätigen

Mit dem prebuilt_components_credit_card_statement:validate_date-Webhook wird von der Komponente überprüft, 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.last_four_digit_of_card_number Die letzten vier Ziffern der angegebenen Kreditkartennummer des Nutzers. String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karten prüfen“ für diese Komponente aufzurufen.

  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:validate_card“ aus.
  7. 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.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Transaktionen abrufen

Der prebuilt_components_credit_card_statement:card_transaction_details-Webhook wird von der Komponente verwendet, um die Transaktionen für eine Karte anhand 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.last_four_digit_of_card_number Die letzten vier Ziffern der Kartennummer, für die der Nutzer die Zustellung von Kreditkartenabrechnungsinformationen 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 die angegebene Kreditkarte im angegebenen Abrechnungszeitraum gefunden wurden. integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Transaktionen abrufen“ für diese Komponente aufzurufen.

  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 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.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Kontoabrechnung anfordern

Über den prebuilt_components_credit_card_statement:request_statement-Webhook sendet die Komponente eine Kreditkartenabrechnung an einen ausgewählten Kanal, sofern die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kreditkartennummer 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_card_number Die letzten vier Ziffern der Kartennummer, für die der Nutzer die Zustellung von Kreditkartenabrechnungsinformationen 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_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 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.

  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 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.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.