Die vordefinierte Komponente der Sperrkarte authentifiziert den Nutzer, ruft für den Nutzer registrierte Karten ab und ermöglicht es dem Nutzer, eine Karte vorübergehend zu sperren, eine Karte dauerhaft zu sperren oder eine Karte wieder zu aktivieren. Nach der Bestätigung einer gesperrten Karte ermöglicht die Komponente dem Nutzer, eine neue Karte anzufordern. Diese Komponente verwendet eine angepasste Version der vordefinierten Komponente für die Authentifizierung, um Karteninhaber zu authentifizieren.
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.
Nicht authentifizierter Nutzer mit mehreren Karten
Der Agent erkennt, dass der Nutzer noch nicht authentifiziert wurde, und erfasst Informationen, um zu bestätigen, dass der Nutzer ein registrierter Karteninhaber ist. Sobald sich der Nutzer authentifiziert hat, ruft der Agent Informationen über die für den Nutzer registrierten Karten ab. Der Nutzer bestätigt, dass er eine ausgewählte Karte vorübergehend sperren möchte, und der Agent generiert die Anfrage zum Sperren der Karte.
| 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. Unter Ihrer Nummer wurden mehrere Karten registriert. Wir haben eine Visa-Karte mit den Endziffern 5555, eine Visa-Karte mit den Endziffern 6666, eine MasterCard mit den Endziffern 4444 und eine MasterCard mit den Endziffern 4449. Bitte teile uns die letzten vier Ziffern der Karte mit, die gesperrt oder reaktiviert werden soll. |
|
| 4444 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 4444, richtig? | |
| Ja | |
| Möchten Sie Ihre Karte vorübergehend oder dauerhaft sperren? | |
| Ich möchte es vorübergehend sperren | |
| Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren. Sie haben die Wahl zwischen „Beschädigt“, „Diebstahl“, „Verloren“ oder „Sonstiges“. | |
| Es wurde beschädigt | |
| Das tut mir leid. Aus Sicherheitsgründen müssen wir Ihre Identität überprüfen. Daher senden wir Ihnen einen Code. Möchten Sie den Code lieber telefonisch oder per E-Mail erhalten? | |
| An mein Smartphone senden | |
| Ok, bevor du fortfährst, senden wir dir einen Code an deine registrierte Mobilnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Wenn die Karte gesperrt ist, können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassensystemen durchführen. Bestätigen Sie diese Aktion? | |
| Ja | |
| Deine Karte wurde gesperrt. Deine Anfragenummer lautet 9711485. Wir haben sie erfolgreich an deine registrierte Mobilnummer weitergegeben. |
Authentifizierter Nutzer mit einzelner Karte
Der Agent identifiziert, dass der Nutzer zuvor authentifiziert wurde, und ruft Informationen über die für den Nutzer registrierte Karte ab. Der Nutzer entscheidet sich dafür, die Karte dauerhaft zu sperren, und der Agent generiert die Anfrage zum dauerhaften Sperren der Karte. Der Agent fragt dann den Nutzer, ob er eine neue Karte für die dauerhaft gesperrte Karte neu ausstellen möchte, und erstellt eine Neuausstellungsanfrage für die Karte.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Bitte warten Sie, während Ihre Kartendetails abgerufen werden. Wir haben Ihre Mastercard mit den Endziffern 4444 gefunden. Möchten Sie Ihre Karte vorübergehend oder dauerhaft sperren? |
|
| Dauerhaft | |
| Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren. Sie haben die Wahl zwischen „Beschädigt“, „Diebstahl“, „Verloren“ oder „Sonstiges“. | |
| Es war beschädigt | |
| Das tut mir leid. Keine Sorge, Ihre Karte wird dauerhaft gesperrt. Könnten Sie bitte bestätigen, dass die Karte auf 4444 endet? | |
| Ja | |
| Ok, bevor du fortfährst, senden wir dir einen Code an deine registrierte Mobilnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Wenn die Karte gesperrt ist, können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassensystemen durchführen. Bestätigen Sie diese Aktion? | |
| Ja | |
| Deine Karte wurde gesperrt. Deine Anfragenummer lautet 6108410. Wir haben sie an deine registrierte Mobilnummer weitergegeben. Möchtest du eine neue Karte ausstellen? |
|
| Ja | |
| Wir senden die Karte an die registrierte Adresse. Können Sie bitte die Postleitzahl 12345 Ihrer Lieferadresse bestätigen? | |
| Das ist richtig | |
| Okay, bitte warte einige Sekunden, während die neue Karte angefordert wird. Die Neuausstellung der Karte war erfolgreich. Deine Anfragenummer lautet 3808109. Wir haben sie an deine registrierte Mobilnummer weitergegeben. Die Karte wird in 3 Arbeitstagen an deine registrierte Adresse geliefert. Um die Karte zu verwenden, folgen Sie der Anleitung für die Karte. |
Karte reaktivieren
Der Agent erkennt, dass der Nutzer eine zusätzliche Authentifizierung benötigt, und sendet ein Einmalpasswort, um die Identität des Nutzers zu bestätigen. Der Nutzer fordert die Reaktivierung einer Karte an und der Agent leitet sie an einen menschlichen Kundenservicemitarbeiter weiter, um fortzufahren.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Aus Sicherheitsgründen müssen wir Ihre Identität überprüfen. Daher senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon erhalten? | |
| Ja | |
| Wir haben einen Code an deine registrierte Telefonnummer mit den Endziffern 5041 gesendet. Das kann einige Sekunden dauern. Können Sie mir bitte den Code bestätigen? | |
| 123456 | |
| Vielen Dank, deine Karte wurde bestätigt. Bitte warte, während deine Kartendetails abgerufen werden. Es wurden mehrere Karten für deine Nummer gefunden. Wir haben eine Visa-Karte mit den Endziffern 1456, eine MasterCard mit den Endziffern 1457, eine American Express-Karte mit den Endziffern 1345 und eine Visa-Karte, die auf 3456 endet. Bitte teile uns die letzten vier Ziffern der Karte mit, die gesperrt oder reaktiviert werden soll. |
|
| 1456 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 1456, richtig? | |
| Ja | |
| Die angeforderte Karte ist bereits vorübergehend gesperrt. Möchtest du die Karte wieder aktivieren oder dauerhaft sperren? | |
| Reaktivieren | |
| Bitte warten Sie, während wir Ihren Anruf weiterleiten, damit wir Ihnen besser helfen können. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Fluss | [Komponentenname] | Karte sperren |
| Entitätstyp | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lock_card_locked_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lock_card:lock_card_ticket_number |
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 seinen Transaktionsverlauf 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 Authentifizierungstypen 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 Authentifizierungstypen 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.card_count | Optional: Anzahl der Kreditkarten, die dem authentifizierten Nutzer zugeordnet sind. | integer |
| $flow.card_status_active | Gibt den Wert des Parameters an, der vom Karten-Webhook validieren zurückgegeben wird, um anzugeben, dass die ausgewählte Karte derzeit aktiv ist. Der Standardwert ist "active". |
String |
| $flow.card_status_lock_temp | Gibt den Wert des Parameters an, der vom Karten-Webhook validieren zurückgegeben wird, um anzugeben, dass die ausgewählte Karte vorübergehend gesperrt ist. Der Standardwert ist "inactive". |
String |
| $flow.card_status_lock_permanent | Gibt den Wert des Parameters an, der vom Karten-Webhook validieren zurückgegeben wird, um anzugeben, dass die ausgewählte Karte dauerhaft gesperrt ist. Der Standardwert ist "blocked". |
String |
| $flow.card_status_reactivate | Gibt den Wert des Parameters an, der vom Karten-Webhook validieren zurückgegeben wird, um anzugeben, dass die ausgewählte Karte reaktiviert wird. Der Standardwert ist "reactivate". |
String |
| $flow.max_retry_card_number | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten vier Ziffern der Kreditkarte erfasst werden. Der Standardwert ist 3. |
integer |
| $flow.max_otp_retry_count | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Einmalpasswort vom Nutzer abgerufen wird. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.
- Ö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 Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Voreinstellungen für Parameter) nach Bedarf.
- 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 Aufrufs an. | integer |
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| card_count | Die Anzahl der Karten, 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, entspricht der Wert dieses Parameters den letzten vier Ziffern der Karte, die der Nutzer ausgewählt hat, um eine Karte zu sperren oder neu auszustellen. | 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:
- Importieren Sie die vordefinierte Komponente.
- 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.
Kartendetails abrufen
Der Webhook prebuilt_components_account_services:get_card_details wird von der Komponente verwendet, um Informationen über die für einen Nutzer registrierten Karten 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 |
|---|---|---|
| last_four_digit_of_all_cards | Liste mit den letzten vier Ziffern jeder für den Nutzer registrierten Karte, z. B. ["0000", "1111", "2222"]. Jedes Element in dieser Liste stellt dieselbe Karte dar wie das Element mit demselben Index in card_vendor_all. |
Liste (String) |
| card_vendor_all | Liste mit dem Kreditkartenanbieter für jede über den Nutzer registrierte Karte, z. B. ["Visa", "Mastercard", "Discover"]. Jedes Element in dieser Liste stellt dieselbe Karte dar wie das Element mit demselben Index in last_four_digit_of_all_cards. |
Liste (String) |
| card_count | Anzahl der Karten, die dem authentifizierten Nutzer zugeordnet sind. | integer |
Wenn Sie den Webhook „Kartendetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um eine Anleitung zu sehen.
- Ö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_account_services:get_card_details“ aus.
- 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.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- 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.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Karte validieren
Der Webhook prebuilt_components_lock_card:validate_card wird von der Komponente verwendet, um Informationen zu einer bestimmten Karte abzurufen, die für das Konto eines Nutzers registriert 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 Kartennummer, die der Nutzer sperren möchte. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| zip_code | Postleitzahl, die für das Konto des Nutzers registriert ist. | String |
| card_vendor | Der Kreditkartenanbieter der ausgewählten Karte. | String |
| card_status | Zeigt den aktuellen Status der Karte an. Gültige Werte sind standardmäßig aktiv, vorübergehend blockiert oder dauerhaft blockiert. Diese Status werden durch die Parameter $flow.card_status_active, $flow.card_status_lock_temp und $flow.card_status_lock_permanent angegeben. Siehe Eingabeparameter. |
String |
Wenn Sie den Webhook „Karten validieren“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.
- Ö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_lock_card:valid_card“ aus.
- 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.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- 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.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Karte sperren
Der Webhook prebuilt_components_lock_card:lock_card_ticket_number wird von der Komponente verwendet, um eine Anfrage zum Sperren einer ausgewählten Karte zu erstellen.
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 sperren möchte. | String |
| $flow.lock_type | Gibt die Art der Sperre an, die auf die Karte des Nutzers angewendet werden soll. Gültige Werte werden von der benutzerdefinierten Entität prebuilt_components_lock_card_lock_type_active definiert. Standardmäßig werden "blocked" (dauerhafte Sperre) und "inactive (temporäre Sperre) unterstützt. |
String |
| $flow.lock_reason | Gibt den Grund an, warum der Nutzer das Sperren der Karte angefordert hat. Gültige Werte werden von der benutzerdefinierten Entität prebuilt_components_lock_card_locked_reason definiert. Standardmäßig werden "damaged", "stolen", "lost" und "others" unterstützt. |
String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| ticket_number | Die Ticketnummer für die erstellte Sperrkartenanforderung. | integer |
Wenn Sie den Sperrkarten-Webhook für diese Komponente konfigurieren möchten, maximieren Sie den Bereich für eine Anleitung.
- Ö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_lock_card:lock_card_ticket_number“ aus.
- 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.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- 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.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Karte neu ausstellen
Der Webhook prebuilt_components_lock_card:reissue_card_number wird von der Komponente verwendet, um eine Anfrage zum erneuten Ausstellen einer neuen oder aktualisierten Karte zu erstellen.
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 sperren möchte. | String |
| zip_code | Postleitzahl, die für das Konto des Nutzers registriert ist. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, damit sie von der Komponente verwendet werden können.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| acknowledgement_number | Die Ticketnummer für die erstellte Neuausstellungskartenanforderung. | integer |
Um den Webhook der Karte zur Neuausstellung für diese Komponente zu konfigurieren, maximieren Sie die entsprechende Anleitung.
- Ö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_lock_card:reissue_card_number“ aus.
- 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.
- Prüfen Sie den Anfragetext und aktualisieren Sie ihn, um das richtige Anfrageformat für den Webhook zu erstellen.
- 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.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.