Die Kreditkartenabrechnung vordefinierte Komponente prüft die Authentifizierungsstufe des Kunden sendet die Kreditkartenabrechnung für einen bestimmten Zeitraum an einen authentifizierten Kunden. Hat der Kunde mehrere Kreditkarten, bestätigt die Karte, die der Kunde abrufen möchte für die Anweisung geben. 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, für diese vordefinierte Komponente gelten 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 |
|---|---|
| Agent authentifiziert Nutzer mit vordefinierter Authentifizierungskomponente | |
| 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 des Kontoauszugs mit der vordefinierten 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 Auszugsdetails abrufen. Wir haben Transaktionen zwischen dem 01.06.2023 und dem 30.06.2023 gefunden. Möchtest du 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 |
|---|---|
| Agent authentifiziert Nutzer mit vordefinierter Authentifizierungskomponente | |
| Vielen Dank, Sie wurden erfolgreich überprüft. | |
| Bitte warte, während deine Kartendetails abgerufen werden. Wir haben festgestellt, dass deiner Nummer zwei Karten zugeordnet sind. Wie lauten die letzten vier Ziffern der Karte, um die es hier geht? |
|
| 1122 | |
| Die letzten vier Ziffern unserer Kartennummer sind 1122, richtig? | |
| Ja | |
| Geben Sie das Startdatum auf Ihrer Kreditkartenabrechnung ein, beginnend mit dem Monat, gefolgt vom Tag und schließlich dem Jahr. Beachten Sie, dass eine Kreditkartenabrechnung nur für die letzten 180 Tage erstellt wird. | |
| Kundenservicemitarbeiter erfasst das Startdatum des Kontoauszugs mit der vordefinierten Komponente Geburtsdatum | |
| Sehr gut, wir haben das Startdatum deiner Kreditkartenabrechnung erfasst. Bitte gib das Enddatum deiner Kreditkartenabrechnung ein, das mit dem Monat beginnt, gefolgt vom Tag und dann dem Jahr. Beachten Sie, dass eine Kreditkartenabrechnung nur für die letzten 180 Tage erstellt wird. |
|
| Kundenservicemitarbeiter erfasst das Enddatum des Kontoauszugs mit der vordefinierten Komponente Geburtsdatum | |
| Sehr gut, wir haben das Enddatum deiner 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öchtest du 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 vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:
| Funktion | Format | Beispiel |
|---|---|---|
| Ablauf | [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 Authentifizierungsebene an, die erforderlich ist, bevor 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. Der Standardwert ist 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. Der Standardwert ist true. |
boolean |
| $session.params.phone_number | (Optional) 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 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, das für das Startdatum eines Kontoauszugs 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 Route true der Startseite konfiguriert. |
integer |
| $flow.max_retry_count | 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 das Fenster, um die Anleitung 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 Build aus.
- Klicken Sie im Abschnitt 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 Beenden aktiv bleiben. Komponente. Diese Parameter enthalten wichtige Informationen, die vom Komponente. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die Authentifizierungsstufe des Aufrufers an. | integer |
| phone_number | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert 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 eine einzelne Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, sind der Wert dieses Parameters die letzten vier Ziffern der Kartennummer, für die der Nutzer Kreditkartendaten 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. 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. Siehe Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe webhook.error built-in event. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event. |
String |
Grundlegende Einstellungen
So richten Sie diese vordefinierte 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
Zur Verwendung dieser Komponente müssen Sie die in flexiblen Webhooks zum Abrufen Informationen von Ihren externen Diensten benötigt.
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. Siehe Einrichtung des Authentifizierungs-Webhooks .
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 der registrierten Telefonnummer zugeordnet sind. | integer |
| credit_card | Die letzten vier Ziffern der Kreditkartennummer des Kunden Wenn der Kunde mehrere Karten hat, beträgt dieser Wert null. |
String |
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.
- Ö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_credit_card_statement:credit_card_details“ 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 Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ä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 Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Karte bestätigen
Der Webhook prebuilt_components_credit_card_statement:validate_date wird verwendet
der Komponente überprüfen, ob eine bestimmte Kreditkarte für eine registrierte
Telefonnummer.
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 | Letzte vier Ziffern der vom Nutzer angegebenen Kreditkartennummer | 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 |
Zum Konfigurieren des Karten-Webhooks für diese Komponente maximieren Sie das Fenster, um die Anleitung 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_credit_card_statement:valid_card“ 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 richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ä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 Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Transaktionen abrufen
Die Komponente verwendet den prebuilt_components_credit_card_statement:card_transaction_details-Webhook, 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, die der Nutzer ausgewählt und bestätigt hat, dass er Informationen zu seiner Kreditkartenabrechnung erhalten möchte. | String |
| $flow.statement_start_date | Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. Wenn vom Nutzer kein Wert angegeben wird oder der Aufrufer die Angabe eines Enddatums ablehnt, 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.
- Ö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_credit_card_statement:card_transaction_details“ 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 Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ä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 Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Kontoabrechnung anfordern
Der Webhook prebuilt_components_credit_card_statement:request_statement wird verwendet
die Komponente verwendet, um einen Kontoauszug für eine Kreditkarte an einen ausgewählten Kanal zu senden,
die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kreditkartennummer
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_card_number | Die letzten vier Ziffern der Kartennummer, die der Nutzer ausgewählt und bestätigt hat, dass er Informationen zu seiner Kreditkartenabrechnung erhalten möchte. | String |
| $flow.statement_start_date | Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. | String |
| $flow.statement_end_date | (optional) Das angeforderte Startdatum des Kontoauszugs in "JJJJ-MM-TT" Format. Wenn vom Nutzer kein Wert angegeben wird oder der Aufrufer die Angabe eines Enddatums ablehnt, 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 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_credit_card_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 richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ä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 Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.