Die vordefinierte Komponente zum Sperren von Karten authentifiziert den Nutzer, ruft Karten ab, die auf den Nutzer registriert sind, und ermöglicht es ihm, eine Karte vorübergehend oder dauerhaft zu sperren oder wieder zu aktivieren. Nachdem der Nutzer eine gesperrte Karte bestätigt hat, kann er über die Komponente eine neue Karte anfordern. Bei dieser Komponente wird eine benutzerdefinierte Version der vordefinierten Komponente Authentifizierung verwendet, 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 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.
Nicht authentifizierter Nutzer mit mehreren Karten
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Karteninhaber ist. Nachdem sich der Nutzer authentifiziert hat, ruft der Kundenservicemitarbeiter Informationen zu den Karten ab, die auf den Nutzer registriert sind. Der Nutzer bestätigt, dass er eine ausgewählte Karte vorübergehend sperren möchte, und der Kundenservicemitarbeiter generiert die Anfrage zum Sperren der Karte.
| 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 mehrere Karten mit Ihrer Nummer gefunden. Wir haben eine Visa-Karte, die auf 5555 endet, eine Visa-Karte, die auf 6666 endet, eine MasterCard, die auf 4444 endet, und eine MasterCard, die auf 4449 endet. Bitte teilen Sie uns die letzten vier Ziffern der Karte mit, die Sie sperren oder reaktivieren möchten. |
|
| 4444 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 4444. Ist das 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 möchten. Sie können Optionen wie „Beschädigt“, „Geklödert“ oder „Verloren“ auswählen. | |
| Es wurde beschädigt. | |
| Das tut mir leid. Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten? | |
| An mein Smartphone senden | |
| Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobiltelefonnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Danach können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassen durchführen. Bestätigen Sie diese Aktion? | |
| Ja | |
| Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 9711485 und wurde an Ihre registrierte Mobiltelefonnummer gesendet. |
Authentifizierter Nutzer mit einer einzelnen Karte
Der Kundenservicemitarbeiter erkennt, dass der Nutzer bereits authentifiziert wurde, und ruft Informationen zur für den Nutzer registrierten Karte ab. Der Nutzer wählt aus, dass die Karte dauerhaft gesperrt werden soll, und der Kundenservicemitarbeiter generiert die entsprechende Anfrage. Der Kundenservicemitarbeiter fragt den Nutzer dann, ob er eine neue Karte für die dauerhaft gesperrte Karte ausstellen lassen möchte, und erstellt einen Antrag auf Neuausstellung der Karte.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Bitte warten Sie, während wir Ihre Kartendetails abrufen. Wir haben Ihre MasterCard mit der Endung 4444 gefunden. Möchten Sie Ihre Karte vorübergehend oder dauerhaft sperren? |
|
| Dauerhaft | |
| Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren möchten. Sie können Optionen wie „Beschädigt“, „Geklödert“ oder „Verloren“ auswählen. | |
| Es war beschädigt | |
| Das tut mir leid. Keine Sorge, wir sperren Ihre Karte dauerhaft. Können Sie bestätigen, dass die Karte auf 4444 endet? | |
| Ja | |
| Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobiltelefonnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Danach können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassen durchführen. Bestätigen Sie diese Aktion? | |
| Ja | |
| Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 6108410 und wurde an Ihre registrierte Mobiltelefonnummer gesendet. Möchten Sie eine neue Karte ausstellen lassen? |
|
| Ja | |
| Wir liefern die Karte an Ihre registrierte Adresse. Können Sie bitte die Postleitzahl Ihrer Lieferadresse bestätigen, 12345? | |
| Das ist richtig. | |
| Okay, bitte warten Sie einen Moment, während wir die Neuausstellung einer neuen Karte beantragen. Der Antrag auf Neuausstellung der neuen Karte war erfolgreich. Ihre Anfragenummer lautet 3808109 und wurde an Ihre registrierte Mobiltelefonnummer gesendet. Die Karte wird innerhalb von 3 Arbeitstagen an Ihre registrierte Adresse geliefert. Folgen Sie der Anleitung, die Sie mit der Karte erhalten haben, um sie zu verwenden. |
Karte reaktivieren
Der Kundenservicemitarbeiter erkennt, dass für den Nutzer eine zusätzliche Authentifizierung erforderlich ist, und sendet ein Einmalpasswort, um die Identität des Nutzers zu bestätigen. Der Nutzer möchte eine Karte reaktivieren und der Kundenservicemitarbeiter leitet ihn an einen Kundenservicemitarbeiter weiter.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon erhalten? | |
| Ja | |
| Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 5041 gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen? | |
| 123456 | |
| Vielen Dank. Ihre Angaben wurden bestätigt. Bitte warten Sie, während wir Ihre Kartendetails abrufen. Wir haben mehrere Karten mit Ihrer Nummer gefunden. Wir haben eine Visa-Karte mit der Endung 1456, eine MasterCard mit der Endung 1457, eine American Express-Karte mit der Endung 1345 und eine Visa-Karte mit der Endung 3456. Nennen Sie uns die letzten vier Ziffern der Karte, die Sie sperren oder reaktivieren möchten. |
|
| 1456 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 1456. Ist das richtig? | |
| Ja | |
| Die angeforderte Karte ist bereits vorübergehend gesperrt. Möchten Sie die Karte reaktivieren oder dauerhaft sperren? | |
| Reaktivieren | |
| Bitte haben Sie einen Moment Geduld, während wir Sie weiterleiten, damit wir Ihnen besser helfen können. |
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | 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
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, damit ein Nutzer auf seinen Transaktionsverlauf 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 Authentifizierungstypen 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 Authentifizierungstypen 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.card_count | (Optional) Anzahl der Kreditkarten, die mit dem authentifizierten Nutzer verknüpft sind. | integer |
| $flow.card_status_active | Gibt den Wert des Parameters an, der vom Webhook „Validate card“ 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 Webhook „Validate card“ 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 Webhook „Validate card“ 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 Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte reaktiviert wurde. Der Standardwert ist "reactivate". |
String |
| $flow.max_retry_card_number | Gibt die zulässige Anzahl von Wiederholungsversuchen 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 Wiederholungen an, wenn das Einmalpasswort (OTP) vom Nutzer erfasst wird. Der Standardwert ist 3. |
integer |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter 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 Erstellen aus.
- Klicken Sie im Bereich 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 für die Parametervorgaben nach Bedarf.
- 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 Authentifizierungsebene des Anrufers an. | integer |
| phone_number | Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| card_count | Die Anzahl der Karten, 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 Karte, die der Nutzer zum Sperren oder Neuausstellen 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 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:
- Importieren Sie die vordefinierte Komponente.
- 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.
Kartendetails abrufen
Über den prebuilt_components_account_services:get_card_details-Webhook erhält die Komponente Informationen zu den Karten, die für einen Nutzer registriert 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 |
|---|---|---|
| last_four_digit_of_all_cards | Liste mit den letzten vier Ziffern jeder Karte, die für den Nutzer registriert ist, z. B. ["0000", "1111", "2222"]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in card_vendor_all. |
Liste (String) |
| card_vendor_all | Liste mit dem Kreditkartenanbieter für jede Karte, die für den Nutzer registriert ist, z. B. ["Visa", "Mastercard", "Discover"]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in last_four_digit_of_all_cards. |
Liste (String) |
| card_count | Anzahl der Karten, die mit dem authentifizierten Nutzer verknüpft sind. | integer |
Maximiere die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Kartendetails 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_account_services:get_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 Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Karte bestätigen
Über den prebuilt_components_lock_card:validate_card-Webhook erhält die Komponente Informationen zu einer bestimmten Karte, die im 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 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 sperren lassen möchte. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| zip_code | Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist. | String |
| card_vendor | Der Kreditkartenanbieter der ausgewählten Karte. | String |
| card_status | Gibt 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 |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karten prüfen“ 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_lock_card:validate_card“ 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 Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Karte sperren
Der prebuilt_components_lock_card:lock_card_ticket_number-Webhook 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 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 sperren lassen möchte. | String |
| $flow.lock_type | Gibt an, welche Art von Sperre auf die Karte des Nutzers angewendet werden soll. Gültige Werte werden durch das benutzerdefinierte Element 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 an, warum der Nutzer die Sperrung der Karte beantragt hat. Gültige Werte werden durch das benutzerdefinierte Element 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 und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| ticket_number | Die Ticketnummer für die erstellte Anfrage zur Sperrung einer Karte. | integer |
Wenn Sie den Webhook „Karte sperren“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt und folgen Sie der 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ähle den Webhook „prebuilt_components_lock_card:lock_card_ticket_number“ 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 Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Karte neu ausstellen
Mit dem prebuilt_components_lock_card:reissue_card_number-Webhook wird von der Komponente eine Anfrage zum Neuausstellen einer neuen oder aktualisierten Karte erstellt.
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 sperren lassen möchte. | String |
| zip_code | Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| acknowledgement_number | Die Ticketnummer für die erstellte Anfrage zur Neuausstellung einer Karte. | integer |
Wenn Sie den Webhook „Karte neu ausstellen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt und folgen Sie der 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 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 Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.