Die vordefinierte Komponente der Stornierungsanforderung prüft die Authentifizierungsstufe eines Nutzers. Sobald der Nutzer authentifiziert wurde, liefert die Komponente Informationen zu den letzten oder vergangenen Bestellungen des Nutzers. Der Nutzer kann dann eine gesamte Bestellung oder nur bestimmte Artikel einer Bestellung stornieren. Diese Komponente verwendet die vordefinierte Komponente für die Retail-Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet außerdem Generatoren für die Zusammenfassung nach dem Aufruf.
Beschränkungen
Neben 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 zeigen gängige Szenarien, in denen diese vordefinierte Komponente verwendet wird. Die Beispieldialogfelder veranschaulichen das Verhalten, wenn die Komponente über Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.
Einzelnes Produkt in letzter Bestellung stornieren
Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel der letzten Bestellung storniert werden sollen. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.
Nutzereingabe | Agent-Antwort |
---|---|
Rufen Sie wegen Ihrer letzten Bestellnummer mit den Endziffern 12978 an, die fünf Wasserflaschen und ein T-Shirt enthält, das am 09.11.2023 um 20:00 Uhr aufgegeben wurde? | |
yes | |
Ihre Bestellung enthält einige geeignete Produkte. Teile uns bitte mit, welches Produkt du stornieren möchtest. Produkt 1: Google Wasserflasche, Produkt 2: Google-T-Shirt. Bitte sage oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage „Weiter“, um weitere Produkte anzuzeigen. |
|
nächste(s/r) | |
Es wurden keine weiteren Einträge in unseren Daten gefunden. Bitte wähle einen Eintrag aus der freigegebenen Liste aus. Produkt 1: Google Wasserflasche, Produkt 2: Google-T-Shirt. Sag oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sag „Weiter“, um weitere Produkte anzuzeigen. |
|
1 | |
Zur Bestätigung: Du möchtest die Google-Wasserflasche stornieren. Ist das richtig? | |
yes | |
Wir sehen, dass die verfügbare Menge des ausgewählten Produkts 5 beträgt. Geben Sie die Anzahl der Produkte an, die Sie stornieren möchten. | |
4 | |
Bitte geben Sie den Grund für die Stornierung an. Du könntest zum Beispiel sagen: Ich habe meine Meinung geändert, brauche nicht mehr, ich möchte einen anderen Artikel kaufen, Lieferung verspätet, versehentlich gekauft, möchte die Zahlungsmethode ändern oder andere sagen. | |
Ich möchte noch einen Artikel kaufen | |
Vielen Dank für deine Nachricht. Möchtest du ein weiteres Produkt stornieren? |
|
no | |
Bei Käufen mit Google Wallet werden Erstattungen dem Wallet- oder Store-Guthaben-Konto gutgeschrieben. Es kann drei bis fünf Werktage dauern, bis die Erstattung in Ihrem Konto angezeigt wird. Beachten Sie, dass der Erstattungsbetrag keine Versand- und Bearbeitungsgebühren beinhaltet. |
Gesamte Bestellung stornieren
Der Endnutzer wurde bereits authentifiziert. Der Agent bestätigt, dass der Nutzer eine bestimmte Bestellung stornieren möchte, und ermittelt dann den Stornierungsgrund. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.
Nutzereingabe | Agent-Antwort |
---|---|
Rufen Sie wegen der letzten Bestellnummer mit den Endziffern 12345 an, die ein T-Shirt enthält, das am 10.11.2023 um 18:00 Uhr aufgegeben wurde? | |
no | |
Möchten Sie eine weitere Bestellung stornieren? | |
yes | |
Könnten Sie bitte die letzten fünf Ziffern Ihrer Bestell-ID angeben, die Sie verfolgen möchten? | |
12346 | |
Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346, richtig? | |
yes | |
Die Erfassung der Bestell-ID ist abgeschlossen. Möchtest du die gesamte Bestellung stornieren? |
|
yes | |
Bitte geben Sie den Grund für die Stornierung an. Du könntest zum Beispiel sagen: Ich habe meine Meinung geändert, brauche nicht mehr, ich möchte einen anderen Artikel kaufen, Lieferung verspätet, versehentlich gekauft, möchte die Zahlungsmethode ändern oder andere sagen. | |
nicht mehr benötigt | |
Vielen Dank für deine Nachricht. Dein Kündigungsantrag wurde erstellt. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
Funktion | Format | Beispiel |
---|---|---|
Fluss | [Komponentenname] | Bestellung stornieren |
Entitätstyp | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_cancel_reason |
Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_cancel_order:post_cancellation_details |
Eingabeparameter
Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Ablaufbezogene Parameter müssen auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder durch einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
Parametername | Beschreibung | Eingabeformat |
---|---|---|
$session.params.phone_number | Optional: Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
$session.params.all_recent_order_id | Optional: Über diesen Parameter werden die Bestell-IDs aufgelistet, die dem authentifizierten Nutzer zugeordnet sind und in absteigender Reihenfolge nach dem Datum der Bestellung sortiert sind. Das erste Element des Arrays steht für die letzte Reihenfolge. Wenn für einen Nutzer keine Bestellungen vorhanden sind, lautet der Wert dieses Parameters null . |
Liste (String) |
$session.params.email | (Optional) Die für das Konto registrierte E-Mail-Adresse. | String |
$session.params.user_first_name | (Optional) Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
Mit dieser vordefinierten Komponente können die folgenden optionalen Parameter das Verhalten der Komponente konfigurieren, einschließlich Wiederholungsversuche.
Parametername | Beschreibung | Format |
---|---|---|
$flow.max_retry_another_account_counter | Gibt die Anzahl der erlaubten Wiederholungsversuche an, wenn Sie auswählen, ob mit einem alternativen Konto fortgefahren werden soll. Der Standardwert ist 2 . |
integer |
$flow.max_retry_order_number | Gibt die Anzahl der zulässigen Wiederholungen bei Angabe der letzten fünf Ziffern einer Bestellnummer an. Der Standardwert ist 2 . |
integer |
$flow.max_retry_another_order | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine andere Bestellung ausgewählt wird und die Bestell-ID nicht gefunden wird oder die Bestellung nicht storniert werden kann. Der Standardwert ist 2 . |
integer |
$flow.max_retry_select_order_number | Gibt die Anzahl der zulässigen Wiederholungsversuche bei Angabe der vollständigen Bestellnummer an, wenn mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2 . |
integer |
$flow.max_product_display_counter | Gibt die maximale Anzahl von Produkten an, die in einer einzigen Runde präsentiert werden sollen. Der Standardwert ist 2 . |
integer |
$flow.max_product_display | Gibt die maximale Anzahl von Produkten an, die in der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 9 . |
integer |
$flow.max_retry_product_number_counter | Gibt die maximale Anzahl der zulässigen Wiederholungsversuche an, wenn ein Produkt, das abgebrochen werden soll, ausgewählt wird. Der Standardwert ist 2 . |
integer |
$flow.max_product_cancel_confirm_counter | Gibt die maximale Anzahl der zulässigen Wiederholungsversuche bei der Bestätigung des ausgewählten Produkts an. Der Standardwert ist 2 . |
integer |
$flow.max_retry_select_quantity | Gibt die maximale Anzahl der zulässigen Wiederholungsversuche an, wenn die Anzahl der zu stornierenden Produkte ausgewählt wird. Der Standardwert ist 2 . |
integer |
$flow.order_product_cancel_reason_others | Gibt den Wert der Entität prebuilt_components_product_cancel_reason an, der angibt, dass der Nutzer den Kündigungsgrund „Sonstige“ ausgewählt hat. Der Standardwert ist "others" . |
String |
$flow.max_retry_cancel_reason | Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Grund für den Abbruch bestätigt wird. Der Standardwert ist 2 . |
integer |
$flow.order_payment_mode_COD | Gibt den Wert des Feldes order_payment_mode an, der vom get_order_details -Webhook zurückgegeben wird und eine COD-Zahlungsmethode (Cash on Delivery) angibt. Der Standardwert ist "COD" . |
String |
$flow.order_payment_mode_store_credit | Gibt den Wert des Feldes order_payment_mode an, der vom Webhook get_order_details zurückgegeben wird und eine Zahlungsmethode für Google Store-Guthaben angibt. Der Standardwert ist "store_credit" . |
String |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um weitere Anweisungen zu erhalten.
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Build aus.
- Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die true-Route.
- Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Parametervoreinstellungen).
- 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 stellt Werte für die folgenden Ausgabeparameter bereit:
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
phone_number | Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, mit der er identifiziert werden kann. | String |
all_recent_order_id | In diesem Parameter werden die Bestell-IDs aufgelistet, die dem authentifizierten Nutzer zugeordnet sind, und zwar in absteigender Reihenfolge nach dem Datum der Bestellung. Das erste Element des Arrays steht für die letzte Reihenfolge. Wenn für einen Nutzer keine Bestellungen vorhanden sind, lautet der Wert dieses Parameters null . |
Liste (String) |
E‑Mail | Die für das Konto registrierte E-Mail-Adresse. | String |
user_first_name | Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
transfer_reason | Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Folgender Wert wird zurückgegeben:agent : Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information : Der Endnutzer hat die Weitergabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input : Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Integrierte Ereignisse ohne Eingabe ansehen.max_no_match : Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Weitere Informationen finden Sie unter Integrierte No-Match-Ereignisse.webhook_error : Ein Webhook-Fehler ist aufgetreten. Siehe integriertes Ereignis „webhook.error“. webhook_not_found : Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error.not-found“. |
String |
Generatoren
Diese Komponente verwendet Generatoren, um bestimmte Teile der Unterhaltung zu aktivieren.
Zusammenfassung
Mit dem Generator Summarization
wird nach dem Anruf eine Zusammenfassung der von der Komponente geführten Unterhaltung erstellt.
Grundlegende Einstellungen
So richten Sie diese vordefinierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dialogflow-Dienste beschreibt. Weitere Informationen finden Sie unter „Webhook-Einrichtung“.
Webhook-Einrichtung
Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Authentifizierung
Wenn Sie bisher noch keine externen Dienste konfiguriert haben, die für die Authentifizierung erforderlich sind, müssen Sie diese so konfigurieren, dass die Authentifizierung von Nutzern für diese Komponente aktiviert wird. Eine ausführliche Anleitung finden Sie unter Webhook für Einzelhandelsauthentifizierung einrichten.
Bestelldetails abrufen
Der Webhook prebuilt_components_cancel_order:get_order_details
wird von der Komponente verwendet, um Bestelldetails für eine bestimmte Bestellung abzurufen.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
Parametername | Beschreibung | Eingabeformat |
---|---|---|
$flow.order_id | Bestell-ID, für die Details abgerufen werden sollen. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
order_date | Datum der Bestellung im Format YYYY-MM-DD . |
String |
order_time | Zeitpunkt der Bestellung im Format HH:MM . |
String |
order_product_count | Die Anzahl der eindeutigen Produkte innerhalb einer Bestellung. | integer |
order_payment_mode | Gibt die beim Aufgeben der Bestellung verwendete Zahlungsart an. | String |
cancelable_product_id | Liste der Produkt-IDs für stornierbare Produkte in der Bestellung. | Liste (String) |
cancelable_product_name | Liste der Produktnamen für stornierbare Produkte in der Bestellung. | Liste (String) |
cancelable_product_brand_name | Liste der Markennamen für stornierbare Produkte in der Bestellung. | Liste (String) |
cancelable_product_quantity | Liste der Mengen für stornierbare Produkte in der Bestellung. | Liste (String) |
Wenn Sie den Webhook „Bestelldetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich für die Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_cancel_order:get_order_details“ aus.
- Ersetzen Sie die URL im Feld Webhook URL (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Doppelte Bestelldetails abrufen
Der Webhook prebuilt_components_retail_services:get_duplicate_order_details
wird von der Komponente verwendet, um detaillierte Informationen abzurufen, um Bestellungen zu unterscheiden, wenn mehrere Bestellnummern dieselben letzten fünf Ziffern haben.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
Parametername | Beschreibung | Eingabeformat |
---|---|---|
$flow.double_order_id | Liste mit den letzten fünf Ziffern der Bestellnummern, die in einer oder mehreren Bestellungen für den Nutzer verwendet werden. | Liste (String) |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
all_order_date | Liste der Bestelldaten für doppelte Bestellungen mit den angegebenen letzten fünf Ziffern im Format YYYY-MM-DD . Jedes Element in diesem Array entspricht demselben Element im Array all_order_time . |
Liste (String) |
all_order_time | Liste der Bestellzeiten für doppelte Bestellungen mit den letzten fünf Ziffern im Format HH:MM . Jedes Element in diesem Array entspricht demselben Element im Array all_order_date . |
Liste (String) |
Wenn Sie den Webhook „Details zu doppelten Bestelldetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_retail_services:get_Duplicate_order_details“ aus.
- Ersetzen Sie die URL im Feld Webhook URL (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Details zur Kündigung nach dem Update
Der Webhook prebuilt_components_cancel_order:post_cancellation_details
wird von der Komponente verwendet, um eine Abbruchanfrage 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 Ländervorwahl, mit der er identifiziert werden kann. | String |
$flow.order_id | Bestell-ID, für die ein Ticket eingereicht werden soll. | String |
$flow.cancel_product_id_list | Liste der Produkt-IDs, die der Nutzer stornieren möchte. | Liste (String) |
$flow.cancel_product_quantity_list | Liste der Produktmengen, die der Nutzer stornieren möchte, entsprechend jedem Element in $flow.cancel_product_id_list . |
Liste (String) |
$flow.cancel_reason_list | Liste der Kündigungsgründe für jedes stornierte Produkt, die jedem Element in $flow.cancel_product_id_list entsprechen. |
Liste (String) |
$flow.order_refund_mode | Die Zahlungsart für die Erstattung. Gültige Werte werden durch die Entität prebuilt_components_cancel_mode_of_refund definiert. |
String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername | Beschreibung | Ausgabeformat |
---|---|---|
order_cancellation_ticket_id | Ticket-ID für die eingereichte Stornierung. | String |
Wenn Sie den Webhook „Details zu den Details nach Kündigung“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um Anleitungen zu erhalten.
- Ö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_cancel_order:post_cancel_details“ aus.
- Ersetzen Sie die URL im Feld Webhook URL (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.