Vorkonfigurierte Komponente „Konto öffnen“

Mit der vorgefertigten Komponente „Konto erstellen“ können neue und bestehende Nutzer ein neues Konto erstellen oder den Status vorhandener Anwendungen prüfen. In dieser Komponente werden die vordefinierten Komponenten Geburtsdatumssammlung, Namenssammlung und Telefonnummernsammlung verwendet, um Nutzerinformationen zur Registrierung eines neuen Kontos zu erfassen.

Kontotypen

Diese Komponente unterstützt standardmäßig die folgenden Kontotypen:

  • Sparkonten
  • Girokonten
  • Depotkonten
  • Gehaltskonten

Unterstützte Kontotypen können durch Ändern des benutzerdefinierten Elements prebuilt_components_open_account_account_type hinzugefügt oder entfernt werden.

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.

Neuer Nutzer

Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers und stellt fest, dass er nicht für ein Konto registriert ist. Der Kundenservicemitarbeiter erfasst dann Details wie den vollständigen Namen und das Geburtsdatum des Nutzers und generiert einen Antrag, der an die angegebene Telefonnummer des Nutzers gesendet wird.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte geben Sie uns die Telefonnummer zur Bestätigung an.
Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Telefonnummernerfassung
Sehr gut. Wir haben jetzt die Telefonnummer erfasst.
Wir freuen uns, dass Sie ein Konto bei uns eröffnen möchten.
Der Kundenservicemitarbeiter erfasst den vollständigen Namen des Nutzers mithilfe der vorgefertigten Komponente Namenerhebung.
Vielen Dank, Max Mustermann.
Der Kundenservicemitarbeiter erhebt die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection.
Sehr gut. Wir haben Ihr Geburtsdatum erfasst.

Welche Art von Konto möchten Sie eröffnen? Sie können „Sparkonto“, „Girokonto“, „Lohnkonto“ oder „Depot“ sagen.
Girokonto
Zur Bestätigung: Sie möchten ein neues Girokonto eröffnen, ist das richtig?
Ja
Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihre Anwendung generieren.

Ihre Anwendungs-ID lautet 81037. Bitte klicken Sie auf den Link, der an Ihre registrierte Mobiltelefonnummer gesendet wurde, um Ihre Bewerbung abzuschließen.

Vorhandener Nutzer

Der Kundenservicemitarbeiter stellt fest, dass der Nutzer bereits authentifiziert wurde, und fragt, welche Art von Konto er eröffnen möchte. Der Kundenservicemitarbeiter erstellt einen Antrag für den Nutzer und sendet eine Anleitung an die registrierte Telefonnummer des Nutzers.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Wir freuen uns, dass Sie ein neues Konto bei uns eröffnen möchten.

Welche Art von Konto möchten Sie eröffnen? Sie können „Sparkonto“, „Girokonto“, „Lohnkonto“ oder „Depot“ sagen.
Sparkonto bitte
Zur Bestätigung: Sie möchten ein neues Sparkonto eröffnen, ist das richtig?
Ja, das ist richtig.
Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihre Anwendung generieren.

Ihre Anwendungs-ID lautet 21430. Bitte klicken Sie auf den Link, der an Ihre registrierte Mobiltelefonnummer gesendet wurde, um Ihre Bewerbung abzuschließen.

Vorhandene Anwendung

Der Kundenservicemitarbeiter erkennt, dass der Nutzer zuvor eine einzelne Anwendung geöffnet hat, und zeigt ihm den aktuellen Status an. Der Nutzer lehnt es ab, einen weiteren Antrag auf ein neues Konto zu stellen.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte geben Sie uns die Telefonnummer zur Bestätigung an.
Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Telefonnummernerfassung
Sehr gut, wir haben die Telefonnummer erfasst.

Ihr Antrag mit der ID 12234 zur Eröffnung eines Sparkontos wird bearbeitet. Möchten Sie ein anderes Konto erstellen?
Nein
Okay, vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Konto erstellen
Komponentenspezifischer Intent prebuilt_components_[component_name]_[intent_name] prebuilt_components_open_account_account_type
Entitätstyp prebuilt_components_[component_name]_[entity_type] prebuilt_components_open_account_account_type
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_open_account:generate_application

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.phone_number (Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. String
$session.params.min_age_limit Gibt das Mindestalter für Nutzer an, die ein neues Konto erstellen. Der Standardwert ist 18. integer
$session.params.max_age_limit Gibt das maximale Alter für Nutzer an, die ein neues Konto eröffnen. Der Standardwert ist 100. integer
$flow.max_dob_retry_count Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen eines gültigen Geburtsdatums an. Der Standardwert ist 2. integer
$flow.max_retry_account_type Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Kontotyp erfasst wird, den der Nutzer eröffnen möchte. Der Standardwert ist 2. integer
$flow.max_retry_another_account Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Nutzer den ausgewählten Kontotyp ändern möchte. Der Standardwert ist 2. 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
phone_number Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. 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.

Telefonische Bestätigung

Über den prebuilt_components_open_account:telephone_verification-Webhook erhält die Komponente Informationen zu registrierten Konten und früheren Anwendungen, die mit der Telefonnummer des Nutzers verknüpft 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

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
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. Wenn mit der angegebenen Telefonnummer keine Konten verknüpft sind, ist dieser Wert null. integer
user_first_name Der Vorname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. String
user_last_name Der Nachname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. String
user_dob Das Geburtsdatum des registrierten Nutzers im Format JJJJ-MM-TT. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. String
application_count Die Anzahl der Anwendungen, die mit der registrierten Telefonnummer verknüpft sind. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null. integer
application_id Liste mit der Anwendungs-ID jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["00000", "11111", "22222"]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in account_type und application_status. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null. Liste (String)
account_type Liste mit dem Kontotyp jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["savings", "checking", "demat"]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in application_id und application_status. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null. Liste (String)
application_status Liste mit dem Status jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["in progress", "on hold", "completed"]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in application_id und account_type. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null. Liste (String)

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Telefonbestätigung 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_open_account:telephone_verification“ 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.

Anwendung generieren

Der prebuilt_components_open_account:generate_application-Webhook wird von der Komponente verwendet, um eine Anwendung für ein neues Konto zu generieren.

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
user_first_name Den Vornamen des Nutzers String
user_last_name Der Nachname des Nutzers. String
user_dob Das Geburtsdatum des Nutzers im Format JJJJ-MM-TT. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
application_id Die Anwendungs-ID, die für die neue Kontoanfrage generiert wurde. String

Wenn Sie den Webhook „Generate application“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung zu sehen.

  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_open_account:generate_application“ 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.