Die Sperrkarte ist eine vorgefertigte Komponente, mit der der Nutzer authentifiziert wird. Außerdem werden die für den Nutzer registrierten Karten abgerufen und der Nutzer kann eine Karte vorübergehend oder dauerhaft sperren oder eine Karte reaktivieren. Nachdem eine gesperrte Karte bestätigt wurde, kann der Nutzer über die Komponente eine neue Karte anfordern. Diese Komponente verwendet eine angepasste Version der vorgefertigten 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
Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.
Nicht authentifizierter Nutzer mit mehreren Karten
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erfasst Informationen, um zu bestätigen, dass der Nutzer ein registrierter Karteninhaber ist. Nachdem sich der Nutzer authentifiziert hat, ruft der Kundenservicemitarbeiter 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 |
|---|---|
| Agent authentifiziert Nutzer mit der vordefinierten Komponente Authentifizierung | |
| Vielen Dank, Sie wurden erfolgreich 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, 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, sind 4444. Stimmt das? | |
| 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“, „Gestohlen“, „Verloren“ oder „Andere“ auswählen. | |
| Es wurde beschädigt | |
| Das tut uns leid. Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Wir senden Ihnen daher 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 Mobilfunknummer. Könnten Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, deine Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Sobald die Karte gesperrt ist, können Sie damit keine Transaktionen mehr online oder an Zahlungsterminals durchführen. Möchten Sie diese Aktion bestätigen? | |
| Ja | |
| Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 9711485 und wurde an Ihre registrierte Mobilnummer gesendet. |
Authentifizierter Nutzer mit einer einzelnen Karte
Der Kundenservicemitarbeiter stellt fest, 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 Anfrage zum dauerhaften Sperren der Karte. Der Kundenservicemitarbeiter fragt den Nutzer, 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 KI-Agenten |
|---|---|
| Wir rufen gerade Ihre Kartendetails ab. Wir haben Ihre MasterCard mit der Endnummer 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 aus Optionen wie „Beschädigt“, „Gestohlen“, „Verloren“ oder „Andere“ auswählen. | |
| Es war beschädigt | |
| Das tut uns leid. Keine Sorge, wir werden Ihre Karte dauerhaft sperren. Können Sie bestätigen, dass die Karte auf 4444 endet? | |
| Ja | |
| Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobilfunknummer. Könnten Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren? | |
| 123456 | |
| Okay, deine Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Sobald die Karte gesperrt ist, können Sie damit keine Transaktionen mehr online oder an Zahlungsterminals durchführen. Möchten Sie diese Aktion bestätigen? | |
| Ja | |
| Ihre Karte wurde gesperrt. Ihre Antragsnummer lautet 6108410 und wurde erfolgreich an Ihre registrierte Mobilnummer gesendet. Möchten Sie eine neue Karte ausstellen lassen? |
|
| Ja | |
| Wir liefern die Karte an Ihre registrierte Adresse. Könnten Sie bitte die Postleitzahl Ihrer Lieferadresse (12345) bestätigen? | |
| Das stimmt. | |
| Okay, bitte warte einige Sekunden, während wir die Anfrage zum Ausstellen einer neuen Karte stellen. Die Anfrage zum Ausstellen einer neuen Karte wurde erfolgreich gestellt. Ihre Anfragenummer lautet 3808109 und wurde erfolgreich an Ihre registrierte Mobilfunknummer gesendet. Die Karte wird innerhalb von drei 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 stellt fest, dass der Nutzer eine zusätzliche Authentifizierung benötigt, und sendet ein Einmalkennwort, um die Identität des Nutzers zu bestätigen. Der Nutzer bittet darum, eine Karte zu reaktivieren, und der Agent leitet ihn an einen menschlichen Kundenservicemitarbeiter weiter.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Wir senden Ihnen daher einen Code. Möchten Sie den Code lieber telefonisch erhalten? | |
| Ja | |
| Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 5041 gesendet. Das kann einige Sekunden dauern. Können Sie den Code bitte bestätigen? | |
| 123456 | |
| Vielen Dank. Die Validierung war erfolgreich. Wir rufen jetzt Ihre Kartendaten ab. 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 teilen Sie uns die letzten vier Ziffern der Karte mit, die Sie sperren oder reaktivieren möchten. |
|
| 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 | |
| Bitte haben Sie einen Moment Geduld, während wir Ihren Anruf 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
Eingabeparameter werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Parameter mit Flow-Bereich müssen auf der Startseite der Komponente festgelegt werden, wie unten beschrieben. Parameter mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.
Diese vorgefertigte 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 der Auftragsausführung 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 als Kontoinhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung 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 der Auftragsausführung für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true. |
boolean |
| $session.params.phone_number | (Optional) 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 Validate card webhook 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 Validate card webhook 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 Validate card-Webhook 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 Validate card webhook 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 beim Erfassen des Einmalpassworts (OTP) vom Nutzer an. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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 Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die richtige Route.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden 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 lokale Telefonnummer 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 mehrere Karten hat, ist der Wert dieses Parameters die letzten vier Ziffern der Karte, die der Nutzer zum Sperren oder zum Ausstellen einer neuen Karte ausgewählt hat. | String |
| transfer_reason | Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, 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 weiterzugeben.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Input-Ereignisse 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 ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter webhook.error (integriertes Ereignis). webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter webhook.error.not-found (integriertes Ereignis). |
String |
Grundlegende Einrichtung
So richten Sie diese vordefinierte Komponente ein:
- Vordefinierte Komponente importieren
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook-Einrichtung“.
Webhook-Einrichtung
Um diese Komponente verwenden zu können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies tun, um die Authentifizierung von Nutzern für diese Komponente zu aktivieren. Eine ausführliche Anleitung finden Sie unter Authentifizierungs-Webhook einrichten.
Kartendetails abrufen
Der prebuilt_components_account_services:get_card_details-Webhook wird von der Komponente verwendet, um Informationen zu den Karten abzurufen, 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 lokale Telefonnummer 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 stellt dieselbe Karte wie das Element mit demselben Index in card_vendor_all dar. |
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 wie das Element mit demselben Index in last_four_digit_of_all_cards dar. |
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 die Anleitung.
- Ö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 Feld Webhook-URL von 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, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Karte bestätigen
Der prebuilt_components_lock_card:validate_card-Webhook 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 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 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 gültige Werte „Aktiv“, „Vorübergehend gesperrt“ oder „Dauerhaft gesperrt“. Diese Status werden durch die Parameter $flow.card_status_active, $flow.card_status_lock_temp und $flow.card_status_lock_permanent angegeben. Eingabeparameter |
String |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Karte validieren“ für diese Komponente aufzurufen.
- Ö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 Feld Webhook-URL von 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, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei 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 lokale Telefonnummer 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 den Typ 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" (permanente Sperrung) und "inactive (temporäre Sperrung) unterstützt. |
String |
| $flow.lock_reason | Gibt den Grund an, aus dem 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 und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| ticket_number | Die Ticketnummer für die erstellte Anfrage für eine Sperrkarte. | integer |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karte sperren“ für diese Komponente aufzurufen.
- Ö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 Feld Webhook-URL von 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, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Karte neu ausstellen
Der prebuilt_components_lock_card:reissue_card_number-Webhook wird von der Komponente verwendet, um eine Anfrage zum 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 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 im Konto des Nutzers registriert 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 der Karte. | integer |
Wenn Sie den Webhook „Karte neu ausstellen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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 Feld Webhook-URL von 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, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.