Mit der vorgefertigten Komponente für die Registrierung von Kreditkarten können neue und bestehende Kunden eine neue Kreditkarte beantragen.
Die Komponente beginnt mit der Erfassung der Telefonnummer des Endnutzers, um festzustellen, ob er ein neuer oder bestehender Kunde ist. Bei einem neuen Nutzer werden über die Komponente die erforderlichen Details erfasst, darunter das monatliche Einkommen und die Ausgabenkategorie oder die Kartenleistungen, die der Nutzer anfordert. Sobald alle erforderlichen Informationen erfasst wurden, wird ein Rückruf vereinbart und dem Nutzer wird die Anfragenummer mitgeteilt.
Bei einem Bestandskunden ruft die Komponente registrierte Nutzerinformationen ab und präsentiert dem Endnutzer verfügbare Kartenoptionen basierend auf seinen Einstellungen und abgerufenen Informationen, einschließlich seiner Kreditwürdigkeit. Nachdem der Kunde eine Kartenoption ausgewählt hat, sendet die Komponente einen Link, über den er die Registrierung über registrierte Kanäle wie WhatsApp oder SMS abschließen kann.
In dieser Komponente werden die vorgefertigten Komponenten Telefonnummernerfassung und Postleitzahlerfassung verwendet, um Nutzerdetails zu erfassen und zu validieren.
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.
Neuer Nutzer
Die Komponente prüft, ob der Nutzer mit einer registrierten Telefonnummer anruft, und stellt fest, dass es sich um einen neuen Nutzer handelt. Die Komponente erfasst die Kategorie der Karte, für die sich der Nutzer registrieren möchte, sowie Informationen zur Identifizierung des Nutzers, einschließlich Postleitzahl und Telefonnummer. Die Komponente veranlasst dann einen Rückruf und gibt dem Nutzer die Anfragenummer.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Können Sie bestätigen, dass Sie bereits Kunde unserer Bank sind? | |
| Ich bin nicht | |
| Wir freuen uns, dass Sie bei uns eine Kreditkarte beantragen möchten. Wir haben eine große Auswahl an Kreditkarten, die für Sie infrage kommen. Damit wir Ihnen die besten verfügbaren Karten anbieten können, geben Sie bitte Ihr monatliches Einkommen in US-Dollar an. |
|
| 5.000 $ | |
| Für welche Ausgaben oder Vorteile interessieren Sie sich? Wir haben verschiedene Optionen, z. B. für Reisen, Kraftstoff und Shopping. | |
| Ich gehe gern einkaufen | |
| Ihre ausgewählte Antwort fällt unter die Kategorie „Shopping“. Wenn du fortfahren möchtest, sag „Ja“. | |
| Ja | |
| Agent erfasst die Postleitzahl des Nutzers mit der vordefinierten Komponente Postleitzahlerfassung | |
| Du hast die Postleitzahl 10011 angegeben. Ist das richtig? | |
| Ja, das ist richtig. | |
| Das war der letzte Schritt. | |
| Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mit der vordefinierten Komponente Telefonnummer erfassen. | |
| Ok. Die von Ihnen angegebene Nummer ist +1 6502530000, richtig? | |
| Ja | |
| Gut, wir haben die Telefonnummer erfasst. Einer unserer Kundenservicemitarbeiter wird Sie anhand Ihrer Kriterien für die entsprechenden Karten zurückrufen. Ihre Anfragenummer lautet 993835. |
Bestandskunden
Die Komponente identifiziert registrierte Kunden anhand ihrer Telefonnummer. Die Komponente fordert dann Informationen wie die Kategorie und den Kartentyp an, für die sich der Nutzer registrieren möchte. Sobald diese Informationen bestätigt wurden, fordert die Komponente den Kunden auf, einen Kanal auszuwählen, über den er die Registrierung abschließen möchte, und sendet den Link an den registrierten Kanal des Kunden.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Wir freuen uns, dass Sie sich weiterhin für unsere Produkte und Dienste entscheiden. Wir haben eine große Auswahl an Kreditkarten, die für Sie infrage kommen. Für welche Ausgaben oder Vorteile interessieren Sie sich? Wir haben verschiedene Optionen, z. B. für Reisen, Kraftstoff und Shopping. |
|
| Ich möchte eine Karte, die ich für meinen nächsten Urlaub verwenden kann | |
| Ihre ausgewählte Antwort fällt unter die Kategorie „Reisen“. Wenn du fortfahren möchtest, sag „Ja“. | |
| Ja | |
| Es gibt drei Arten von Karten, die zu Ihrer Anfrage passen: Platinum Travel Card, Gold Travel Card und Classic Travel Card. Möchten Sie Informationen zu allen Karten oder zu einer bestimmten Karte erhalten? Wenn Sie beispielsweise nach einer klassischen Karte suchen, sagen Sie „klassische Karte“. | |
| Kannst du mir etwas über die Platinum Card erzählen? | |
| Ja, die Jahresgebühr für eine Platinum-Reisekarte beträgt 95 $. Zu den Vorteilen gehören: 10.000 Bonuspunkte pro Jahr, unbegrenzte doppelte Meilen bei allen anderen Käufen, Meilen lassen sich einfach sammeln und einlösen. Weitere Informationen zu Vorteilen oder Boni finden Sie auf unserer Website. Bitte bestätigen Sie, ob Sie sich für die Platinum-Reisekarte registrieren möchten. |
|
| Ja, los gehts | |
| Wir senden Ihnen einen Link mit den Schritten für die Registrierung. Sollen wir diese Kartendetails per SMS oder WhatsApp an Ihre Mobiltelefonnummer senden? | |
| SMS bitte | |
| Okay, wir senden den Link an Ihre registrierte Mobilnummer. Diese Aktion kann einige Sekunden dauern. Können Sie bitte mit „Ja“ oder „Nein“ bestätigen, ob Sie den Link erhalten haben? | |
| Ich habe es | |
| Sie können jetzt den Link öffnen und die Details zur Kartenregistrierung aufrufen. Sobald die Daten vollständig sind, wird die Ausstellung der neuen Karte veranlasst und an Ihre aktuelle Adresse gesendet. |
Verweigerung von Informationen
Der Nutzer weigert sich, die für die Registrierung für eine Kreditkarte erforderlichen Informationen anzugeben. Die Komponente wird mit einer Fehlermeldung beendet.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Können Sie bestätigen, dass Sie bereits Kunde unserer Bank sind? | |
| Nein | |
| Wir freuen uns, dass Sie bei uns eine Kreditkarte beantragen möchten. Wir haben eine große Auswahl an Kreditkarten, die für Sie infrage kommen. Damit wir Ihnen die besten verfügbaren Karten anbieten können, geben Sie bitte Ihr monatliches Einkommen in US-Dollar an. |
|
| Das möchte ich dir nicht verraten | |
| Vielen Dank für Ihren Anruf. Leider können wir ohne die angeforderten Informationen derzeit nicht fortfahren. |
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Registrierung für Kreditkarte |
| Komponentenspezifische Intention | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_cc_enroll_collect_cardtype |
| Entitätstyp | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_cc_enroll_expense_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_credit_card_enrollment:get_available_card |
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 aktuelle Authentifizierungsebene des Endnutzers an. | integer |
| $session.params.phone_number | Optional: Telefonnummer des Endnutzers. Wenn dieser Parameter nicht angegeben wird, erfasst die Komponente die Telefonnummer vom Endnutzer. | String |
| $flow.max_retry_count | Gibt die Anzahl der Wiederholungsversuche an, die dem Endnutzer zur Verfügung stehen. Der Standardwert ist 3. |
integer |
| $flow.currency_name | Gibt die Währung an, die bei der Erfassung der monatlichen Einkommensdetails erwartet wird. Der Standardwert ist "USD". |
String |
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 |
|---|---|---|
| phone_number | Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | 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.
Kontodetails abrufen
Der prebuilt_components_credit_card_enrollment:get_account_details-Webhook wird von der Komponente verwendet, um die Kontodetails des Nutzers abzurufen, sofern ein Konto vorhanden 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 |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| account_count | Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. | integer |
| credit_score | Die registrierte Bonität des Nutzers. | integer |
Wenn Sie den Webhook „Kontodetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung 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_credit_card_enrollment:get_account_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.
Anzahl der Karten abrufen
Der prebuilt_components_credit_card_enrollment:get_card_count-Webhook wird von der Komponente verwendet, um die Anzahl der Kreditkarten abzurufen, die mit den Konten eines registrierten Nutzers verknüpft sind.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.phone_number | Die 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 |
|---|---|---|
| card_count | Die Gesamtzahl der Kreditkarten im Konto bzw. in den Konten eines registrierten Nutzers. | integer |
Wenn Sie den Webhook „Get card count“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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_credit_card_enrollment:get_card_count“ 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.
Verfügbare Karten abrufen
Der prebuilt_components_credit_card_enrollment:get_available_card-Webhook wird von der Komponente verwendet, um die Liste der Karten abzurufen, die dem Nutzer für eine bestimmte Kategorie basierend auf seiner Bonität zur Verfügung stehen.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $flow.expense_category | Die Ausgabenkategorie, die der Nutzer für die Registrierung ausgewählt hat. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_cc_enroll_expense_category definiert. Standardmäßig werden fuel, shopping und travel unterstützt. |
String |
| $flow.credit_score | Die Bonität des Nutzers, die von der Komponente über den Webhook Get account details (Kontodetails abrufen) abgerufen wird. | integer |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| available_card_names | Liste der für den Nutzer verfügbaren Karten, z. B. ["gold shopping card","classic shopping card"]. |
Liste (String) |
| cards_count | Die Anzahl der Karten, die dem Nutzer zur Verfügung stehen. | integer |
Wenn Sie den Webhook „Get available cards“ 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_credit_card_enrollment:get_available_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.
Details zur ausgewählten Karte abrufen
Der prebuilt_components_credit_card_enrollment:get_selected_card-Webhook wird von der Komponente verwendet, um Jahresgebühren und Vorteile für die ausgewählte Karte abzurufen.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $flow.card_type | Der Kartentyp, den der Nutzer für die Registrierung ausgewählt hat. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_cc_enroll_card_type definiert. Standardmäßig werden classic, gold und platinum unterstützt. |
String |
| $flow.expense_category | Die Ausgabenkategorie, die der Nutzer für die Registrierung ausgewählt hat. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_cc_enroll_expense_category definiert. Standardmäßig werden fuel, shopping und travel unterstützt. |
String |
| $flow.credit_score | Die Bonität des Nutzers, die von der Komponente über den Webhook Get account details (Kontodetails abrufen) abgerufen wird. | integer |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| selected_card_benefits | Informationen zu den Vorteilen der ausgewählten Karte. | String |
| selected_card_annual_fee | Die Jahresgebühr der ausgewählten Karte. | integer |
| selected_card_name | Der Name der ausgewählten Karte. | String |
Wenn Sie den Webhook „Get selected card details“ 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_credit_card_enrollment:get_selected_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.
Registrierungsantrag einreichen
Der prebuilt_components_credit_card_enrollment:submit_enroll-Webhook wird von der Komponente verwendet, um eine Kartenregistrierungsanfrage basierend auf den vom neuen Nutzer angegebenen Einstellungen und Nutzerdetails 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 |
| $flow.zipcode | Vom Nutzer angegebene Postleitzahl. | String |
| $flow.monthly_salary | Das vom Nutzer angegebene monatliche Gehalt. | integer |
| $flow.currency_name | Währung des monatlichen Gehalts, die in den Eingabeparametern der Komponente konfiguriert ist. Eingabeparameter | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| request_number | Antragsnummer für die erfolgreiche Registrierung der Kartenregistrierungsanfrage. | integer |
Wenn Sie den Webhook zum Senden von Registrierungsanfragen für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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_credit_card_enrollment:submit_enroll“ 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.
Nachricht senden
Der prebuilt_components_credit_card_enrollment:send_message-Webhook wird von der Komponente verwendet, um eine Nachricht mit einem Link zum Abschließen der Kreditkartenregistrierung für Bestandskunden zu senden.
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 |
| $flow.channel | Der Kanal, den der Nutzer ausgewählt hat, um die Nachricht zu empfangen. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_cc_enroll_channel definiert. Standardmäßig werden SMS und WhatsApp unterstützt. |
String |
| $flow.selected_card_name | Liste der vom Nutzer ausgewählten Karten, z. B. ["gold shopping card","classic shopping card"]. |
Liste (String) |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| message_sent | Gibt an, ob die Nachricht erfolgreich an den vom Nutzer angegebenen Kanal gesendet wurde. | boolean |
Wenn Sie den Webhook „Nachricht senden“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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_credit_card_enrollment:send_message“ 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.