Die vordefinierte Komponente „Karte sperren“ authentifiziert den Nutzer, ruft die für den Nutzer registrierten Karten ab und ermöglicht es dem Nutzer, eine Karte vorübergehend oder dauerhaft zu sperren oder eine Karte wieder zu aktivieren. Nachdem der Nutzer eine gesperrte Karte bestätigt hat, kann er über die Komponente eine neue Karte anfordern. Diese Komponente verwendet eine angepasste Version der vordefinierten Komponente 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 verfassen
Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des Agents zu Beginn der Unterhaltung ausgelöst.
Nicht authentifizierter Nutzer mit mehreren Karten
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erfasst Informationen, um zu prüfen, ob der Nutzer ein registrierter Karteninhaber ist. Nachdem sich der Nutzer authentifiziert hat, ruft der Agent Informationen zu den für den Nutzer registrierten Karten ab. 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 KI-Agenten |
|---|---|
| Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Authentifizierung. | |
| Vielen Dank, Sie wurden authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kartendetails abrufen. Wir haben mehrere Karten gefunden, die mit Ihrer Nummer registriert sind. 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 nenne uns die letzten vier Ziffern der Karte, die du sperren oder reaktivieren möchtest. |
|
| 4444 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 4444. Ist das richtig? | |
| Ja | |
| Möchtest du deine Karte vorübergehend oder dauerhaft sperren? | |
| Ich möchte es vorübergehend sperren | |
| Bitte teile uns mit, warum du deine Karte sperrst. Du kannst zwischen Optionen wie „Beschädigt“, „Gestohlen“, „Verloren“ oder „Sonstiges“ wä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 | |
| Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobilnummer. Könnten Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Nach dem Sperren können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassensystemen durchführen. Möchten Sie diese Aktion bestätigen? | |
| Ja | |
| Deine Karte wurde gesperrt. Ihre Anfragenummer lautet 9711485 und wurde an Ihre registrierte Mobilnummer gesendet. |
Authentifizierter Nutzer mit einer Karte
Der Agent stellt fest, dass der Nutzer bereits authentifiziert wurde, und ruft Informationen zur Karte ab, die für den Nutzer registriert ist. 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 den Nutzer dann, ob er eine neue Karte für die dauerhaft gesperrte Karte ausstellen möchte, und erstellt eine Anfrage zur Neuausstellung der Karte.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Bitte warten Sie, während wir Ihre Kartendetails abrufen. Wir haben Ihre MasterCard mit der Endung 4444 gefunden. Möchtest du deine Karte vorübergehend oder dauerhaft sperren? |
|
| Dauerhaft | |
| Bitte teile uns mit, warum du deine Karte sperrst. Du kannst zwischen Optionen wie „Beschädigt“, „Gestohlen“, „Verloren“ oder „Sonstiges“ wählen. | |
| Das Gerät wurde beschädigt. | |
| Das tut mir leid. Keine Sorge, wir sperren deine Karte dauerhaft. Können Sie bestätigen, dass die Kartennummer auf 4444 endet? | |
| Ja | |
| Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobilnummer. Könnten Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Nach dem Sperren können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassensystemen durchführen. Möchten Sie diese Aktion bestätigen? | |
| Ja | |
| Deine Karte wurde gesperrt. Ihre Anfragenummer lautet 6108410 und wurde erfolgreich an Ihre registrierte Mobilnummer gesendet. Möchten Sie eine neue Karte ausstellen lassen? |
|
| Ja | |
| Wir liefern die Karte an deine registrierte Adresse. Könnten Sie bitte die Postleitzahl Ihrer Lieferadresse bestätigen? Ist es 12345? | |
| Das ist richtig | |
| Bitte warte einen Moment, während wir die Anfrage für die Neuausstellung einer Karte stellen. Die Anfrage für die Neuausstellung einer Karte war erfolgreich. Ihre Anfragenummer lautet 3808109 und wurde erfolgreich an Ihre registrierte Mobilnummer 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 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 bittet darum, eine Karte wieder zu aktivieren, und der KI-Agent leitet ihn an einen menschlichen Kundenservicemitarbeiter weiter, um fortzufahren.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber telefonisch erhalten? | |
| Ja | |
| Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 5041 gesendet. Dies kann einige Sekunden dauern. Können Sie den Code bitte bestätigen? | |
| 123456 | |
| Vielen Dank, Sie wurden erfolgreich validiert. Bitte warten Sie, während wir Ihre Kartendetails abrufen. Wir haben mehrere Karten gefunden, die mit Ihrer Nummer registriert sind. 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 mit den Endziffern 3456. Bitte nenne uns die letzten vier Ziffern der Karte, die du sperren oder reaktivieren möchtest. |
|
| 1456 | |
| Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, sind 1456. Ist das richtig? | |
| Ja | |
| Die angeforderte Karte ist bereits vorübergehend gesperrt. Möchten Sie die Karte reaktivieren oder dauerhaft sperren? | |
| Reaktivieren Sie es. | |
| Bitte bleiben Sie dran, während wir Ihren Anruf weiterleiten, damit wir Ihnen besser helfen können. |
Namenskonventionen
Für diese vordefinierte 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
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. Ablaufbezogene Parameter müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder von einem aufrufenden Ablauf 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 seinen Transaktionsverlauf zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg 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 des Fulfillments für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false. |
boolean |
| $session.params.card_auth_enabled | Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg 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 „Karte 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 Webhook zur Kartenvalidierung 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 zur Kartenvalidierung 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 zur Kartenvalidierung zurückgegeben wird, um anzugeben, dass die ausgewählte Karte reaktiviert wurde. Der Standardwert ist "reactivate". |
String |
| $flow.max_retry_card_number | Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen der letzten vier Ziffern der Kreditkarte an. Der Standardwert ist 3. |
integer |
| $flow.max_otp_retry_count | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Einmalpasswort (OTP) vom Nutzer abgefragt wird. Der Standardwert ist 3. |
integer |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Abschnitt Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen 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 Aufrufers 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 mit der registrierten Telefonnummer verknüpft 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, 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 für das Beenden des Ablaufs an, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat sich geweigert, die von der Komponente angeforderten Informationen weiterzugeben.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Eingabe.max_no_match: Die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Übereinstimmung wurde erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse für „Keine Ü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 Integriertes Ereignis „webhook.error.not-found“. |
String |
Grundlegende Einrichtung
So richten Sie diese vordefinierte 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 im Abschnitt „Webhook-Einrichtung“.
Webhook-Einrichtung
Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie sie konfigurieren, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. 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 zu den 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, um von der Komponente verwendet zu werden.
| 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 Karte, die für den Nutzer registriert ist, 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 mit dem authentifizierten Nutzer verknüpft sind. | integer |
Maximieren Sie den Bereich, um eine Anleitung zum Konfigurieren des Webhooks „Kartendetails abrufen“ für diese Komponente zu erhalten.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, 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 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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 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 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 lassen möchte. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| zip_code | Postleitzahl, die im Konto des Nutzers registriert ist. | String |
| card_vendor | Der Kreditkartenanbieter für die ausgewählte Karte. | String |
| card_status | Gibt den aktuellen Status der Karte an. Standardmäßig sind die gültigen Werte „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 die Anleitung zum Konfigurieren des Webhooks „Karte validieren“ für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, 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 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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 lassen 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 durch die benutzerdefinierte 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 die Sperrung der Karte beantragt hat. Gültige Werte werden durch die benutzerdefinierte 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, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| ticket_number | Die Ticketnummer für die erstellte Anfrage zum Sperren der Karte. | integer |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Karte sperren“ für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, 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 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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 Neuausstellen 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 lassen möchte. | String |
| zip_code | Postleitzahl, die im Konto des Nutzers registriert ist. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| acknowledgement_number | Die Ticketnummer für die erstellte Anfrage zur Neuausstellung der Karte. | integer |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für die Neuausstellung von Karten für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, 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 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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.