Bestellung für vorgefertigte Komponente stornieren

Die vorgefertigte Komponente für die Stornierung einer Bestellung prüft die Authentifizierungsstufe eines Nutzers. Nach der Authentifizierung des Nutzers liefert die Komponente Informationen zu seinen letzten oder früheren Bestellungen. Die kann der Nutzer eine komplette Bestellung stornieren oder bestimmte Artikel in einem Reihenfolge. Diese Komponente verwendet den Authentifizierung für den Einzelhandel vordefinierte Komponente zur Nutzerauthentifizierung. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

  • Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialogfelder zeigen das Verhalten, wenn die Komponente wird per Telefonie aufgerufen, wodurch der Standard-Begrüßungs-Intent und der erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.

Einzelnes Produkt in letzter Bestellung stornieren

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung storniert werden sollen. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Details zur Stornierung mit dem Nutzer.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Geht es um Ihre letzte Bestellung mit der Bestellnummer, die auf 12978 endet, die am 09.11.2023 um 20:00 Uhr aufgegeben wurde und 5 Wasserflaschen und 1 T-Shirt enthält?
Ja
Wir haben in Ihrer Bestellung einige infrage kommende Produkte gefunden. Nennen Sie uns bitte, welches Produkt Sie stornieren möchten.
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Nennen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Produkte zu sehen.
nächste(s/r)
In unseren Daten wurden keine weiteren Artikel gefunden. Bitte wählen Sie aus der geteilten Liste aus.
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Bitte sprechen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Produkte anzuzeigen.
1
Sie möchten die Google-Wasserflasche kündigen. Ist das richtig?
Ja
Die verfügbare Menge des von Ihnen ausgewählten Produkts beträgt 5. Gib die Anzahl der Produkte an, die du stornieren möchtest.
4
Geben Sie bitte den Grund für die Stornierung an. Du kannst beispielsweise Folgendes sagen: Ich habe meine Meinung geändert, „nicht mehr benötigt“, „Ich möchte einen weiteren Artikel kaufen“, „Lieferung verzögert“, „Versehentlich gekauft“ oder „Möchte die Zahlungsmethode ändern“.
Ich möchte einen weiteren Artikel kaufen
Vielen Dank für deine Nachricht.

Möchtest du ein weiteres Produkt stornieren?
no
Bei Käufen, die über Ihr Wallet getätigt wurden, werden Erstattungen dem Wallet- oder Store-Guthabenkonto gutgeschrieben. Es kann drei bis fünf Arbeitstage dauern, bis die Erstattung auf Ihrem Konto angezeigt wird. Beachten Sie, dass der Erstattungsbetrag keine Versand- und Bearbeitungsgebühren enthält.

Gesamte Bestellung stornieren

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, dass der Nutzer eine bestimmte Bestellung stornieren möchte, und erfragt dann den Grund für die Stornierung. Die Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierung mit den Nutzenden.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Rufen Sie wegen Ihrer letzten Bestellung an, die auf 12345 endet und ein T-Shirt enthält, das am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
no
Möchten Sie eine weitere Bestellung stornieren?
Ja
Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie verfolgen möchten.
12346
Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12346. Ist das richtig?
Ja
Sehr gut. Wir haben die Bestell-ID erfasst.

Möchten Sie die gesamte Bestellung stornieren?
Ja
Bitte geben Sie den Grund für die Stornierung an. Du kannst beispielsweise Folgendes sagen: Ich habe meine Meinung geändert, „nicht mehr benötigt“, „Ich möchte einen weiteren Artikel kaufen“, „Lieferung verzögert“, „Versehentlich gekauft“ oder „Möchte die Zahlungsmethode ändern“.
nicht mehr benötigt
Vielen Dank für Ihre Mitteilung.

Ihre Kündigungsanfrage wurde generiert.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Ablauf [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 eines Komponente. Die Parameter werden von mindestens einer Bedingung im um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente festgelegt werden. Auf Sitzungsebene Parameter können entweder von einem aufrufenden Ablauf oder beim Start Seite dieser Komponente.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$session.params.phone_number (Optional) Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird. String
$session.params.all_recent_order_id (Optional) Dieser Parameter listet die mit dem authentifizierten Nutzer verknüpften Bestell-IDs auf, die nach dem Datum der Auftragsplatzierung in absteigender Reihenfolge sortiert sind. Das erste Element des Arrays steht für die letzte Bestellung. Hat ein Nutzer keine Bestellungen, hat dieser Parameter den Wert 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 folgende optionale Parameter konfiguriert werden: das Verhalten der Komponente, einschließlich Wiederholungsversuchen.

Parametername Beschreibung Format
$flow.max_retry_another_account_counter Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ausgewählt wird, ob mit einem alternativen Konto fortzufahren. Der Standardwert ist 2. integer
$flow.max_retry_order_number Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten fünf Ziffern einer Bestellnummer angegeben werden. Der Standardwert ist 2. integer
$flow.max_retry_another_order Gibt an, wie oft die Auswahl einer anderen Bestellung wiederholt werden darf, wenn 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 zulässige Anzahl von Wiederholungsversuchen an, wenn die vollständige Bestellnummer angegeben wird, in Fällen, in denen 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 einzelnen Drehung 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 angezeigt werden sollen. Der Standardwert ist 9. integer
$flow.max_retry_product_number_counter Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt zum Kündigen ausgewählt wird. Der Standardwert ist 2. integer
$flow.max_product_cancel_confirm_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen 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 Menge des zu stornierenden Produkts ausgewählt wird. Der Standardwert ist 2. integer
$flow.order_product_cancel_reason_others Gibt den Wert der prebuilt_components_product_cancel_reason-Entität an, der angibt, dass der Nutzer „Sonstige“ ausgewählt hat Stornierungsgrund. Der Standardwert ist "others". String
$flow.max_retry_cancel_reason Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Grund für die Stornierung bestätigt wird. Der Standardwert ist 2. integer
$flow.order_payment_mode_COD Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-Webhook zurückgegeben wird und eine Zahlung per Nachnahme angibt. Der Standardwert ist "COD". String
$flow.order_payment_mode_store_credit Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-Webhook zurückgegeben wird und eine Zahlungsmethode für Store-Guthaben angibt. Der Standardwert ist "store_credit". String

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie das Fenster, um die Anleitung aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Build aus.
  5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
  6. Klicken Sie im Abschnitt Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben nach Bedarf.
  9. 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
phone_number Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird String
all_recent_order_id Dieser Parameter enthält die Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays steht für die letzte Bestellung. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null. Liste (String)
E-Mail Die mit dem 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. Der zurückgegebene Wert ist einer der folgenden:

agent: Der Endnutzer hat irgendwann während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.

denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt.

max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Siehe Integrierte Ereignisse ohne Eingabe.

max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung.

webhook_error: Es ist ein Webhook-Fehler aufgetreten. Siehe webhook.error built-in event.

webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event.
String

Generatoren

Diese Komponente verwendet Generatoren. bestimmte Teile der Unterhaltung aktivieren.

Zusammenfassung

Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, die die von der Komponente verarbeitete Unterhaltung beschreibt.

Grundlegende Einstellungen

So richten Sie diese vordefinierte Komponente ein:

  1. Importieren Sie die vordefinierte Komponente.
  2. Konfigurieren Sie die flexible Webhooks mit Konfiguration, die Ihre externen Dienste beschreibt, siehe Webhook einrichten.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen aus Ihren externen Diensten abzurufen.

Authentifizierung

Wenn Sie noch keine externen Dienste konfiguriert haben, die für müssen Sie diese so konfigurieren, dass die Authentifizierung für diese Komponente. Eine ausführliche Anleitung finden Sie unter Webhook für die Authentifizierung im Einzelhandel einrichten.

Ruf Bestellinformationen ab

Der Webhook prebuilt_components_cancel_order:get_order_details wird verwendet von der Komponente verwendet, um Auftragsdetails für einen bestimmten Auftrag 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 Die Uhrzeit, zu der die Bestellung aufgegeben wurde, 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 Stückzahlen 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, um die Anleitung aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_cancel_order:get_order_details“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Details zur doppelten Bestellung abrufen

Der prebuilt_components_retail_services:get_duplicate_order_details-Webhook 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.duplicate_order_id Liste mit den letzten fünf Ziffern der Bestellnummern, die für einen oder mehrere Bestellungen des Nutzers freigegeben sind. 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 Aufträge mit den angegebenen letzten fünf Stellen im Format YYYY-MM-DD. Jedes Element in diesem Array entspricht demselben Element im all_order_time-Array. Liste (String)
all_order_time Liste der Bestellzeiten für doppelte Bestellungen mit den angegebenen letzten fünf Ziffern im Format HH:MM. Jedes Element in diesem Array entspricht demselben Element im all_order_date-Array. Liste (String)

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Details zu doppelten Bestellungen abrufen“ für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_retail_services:get_duplicate_order_details“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Details nach der Stornierung

Der Webhook prebuilt_components_cancel_order:post_cancellation_details wird verwendet um eine Stornierungsanfrage 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. 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 den einzelnen Elementen in $flow.cancel_product_id_list. Liste (String)
$flow.cancel_reason_list Liste der Kündigungsgründe für jedes stornierte Produkt, das jedem Element in $flow.cancel_product_id_list entspricht. Liste (String)
$flow.order_refund_mode Die Zahlungsart für die Erstattung. Gültige Werte werden von der 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 der eingereichten Stornierung. String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Post cancellation details“ für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_cancel_order:post_cancel_details“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Abgeschlossen

Der Agent und seine Webhooks sollten jetzt eingerichtet und zum Testen bereit sein.