Bestellung für vorgefertigte Komponente stornieren

Die vordefinierte Komponente zum Stornieren von Bestellungen prüft die Authentifizierungsstufe eines Nutzers. Nachdem der Nutzer authentifiziert wurde, stellt die Komponente Informationen zu den letzten oder früheren Bestellungen des Nutzers bereit. Der Nutzer kann dann eine gesamte Bestellung oder bestimmte Artikel in einer Bestellung stornieren.

Diese Komponente verwendet die vordefinierte Komponente Retail authentication, um Nutzer zu authentifizieren. 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 verfassen

Die Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Sie zeigen das Verhalten, wenn der Nutzer die Komponente per Telefonie aufruft. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des KI-Agenten zu Beginn der Unterhaltung ausgelöst.

Einzelnes Produkt in einer aktuellen Bestellung stornieren

  1. Der Nutzer wurde bereits authentifiziert.
  2. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung storniert werden sollen.
  3. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.
Nutzereingabe Antwort des KI-Agenten
Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer, die auf 12978 endet, an? Sie enthält 5 Wasserflaschen und 1 T-Shirt und wurde am 09.11.2023 um 20:00 Uhr aufgegeben.
Ja
Wir haben in deiner Bestellung einige Produkte gefunden, die für eine Rückgabe infrage kommen. Welches Produkt möchtest du stornieren?
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Nenne oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage „Weiter“, um weitere Produkte anzuzeigen.
Weiter
Wir haben keine weiteren Artikel in unseren Aufzeichnungen gefunden. Bitte wähle ein Produkt aus der Liste aus.
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Nenne oder gib die Produktnummer des gewünschten Artikels ein oder sag „Weiter“, um weitere Produkte anzeigen zu lassen.
1
Sie möchten die Bestellung der Google-Wasserflasche stornieren. Ist das richtig?
Ja
Die verfügbare Menge des ausgewählten Produkts beträgt 5. Geben Sie die Anzahl der Produkte an, die Sie stornieren möchten.
4
Bitte geben Sie den Grund für die Kündigung an. Sie können beispielsweise Folgendes sagen: „Ich habe meine Meinung geändert“, „Ich benötige den Artikel nicht mehr“, „Ich möchte einen anderen Artikel kaufen“, „Die Lieferung hat sich verzögert“, „Ich habe den Artikel versehentlich gekauft“, „Ich möchte die Zahlungsmethode ändern“ oder „Sonstiges“.
Ich möchte einen anderen Artikel kaufen
Vielen Dank für die Information.

Möchten Sie ein weiteres Produkt kündigen?
no
Bei Käufen, die mit Ihrem Wallet getätigt wurden, werden Erstattungen dem Wallet oder Store-Guthabenkonto gutgeschrieben. Es dauert 3 bis 5 Arbeitstage, bis die Erstattung auf deinem Konto eingeht. Versand- und Bearbeitungsgebühren werden nicht erstattet.

Gesamte Bestellung stornieren

  1. Der Nutzer wurde bereits authentifiziert.
  2. Der KI-Agent bestätigt, dass der Nutzer eine bestimmte Bestellung stornieren möchte, und erfragt den Grund für die Stornierung.
  3. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.
Nutzereingabe Antwort des KI-Agenten
Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer 12345 an, die ein Hemd enthält und am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
no
Möchten Sie eine andere Bestellung stornieren?
Ja
Könnten Sie bitte die letzten fünf Ziffern der Bestell-ID angeben, die Sie verfolgen möchten?
12346
Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346. Ist das richtig?
Ja
Wir haben die Bestell-ID erfasst.

Möchten Sie die gesamte Bestellung stornieren?
Ja
Bitte geben Sie den Grund für die Kündigung an. Sie können beispielsweise Folgendes sagen: „Ich habe meine Meinung geändert“, „Ich benötige den Artikel nicht mehr“, „Ich möchte einen anderen Artikel kaufen“, „Die Lieferung hat sich verzögert“, „Ich habe den Artikel versehentlich gekauft“, „Ich möchte die Zahlungsmethode ändern“ oder „Sonstiges“.
nicht mehr benötigt
Vielen Dank für Ihre Mitteilung.

Ihre Kündigungsanfrage wurde erstellt.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Auftrag annullieren
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

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Eine oder mehrere Bedingungen im Ablauf verwenden diese Parameter, um das Verhalten der Komponente zu bestimmen. Sie müssen Parameter mit Ablaufbereich auf der Startseite der Komponente festlegen. Sie können Parameter auf Sitzungsebene mithilfe eines Aufrufflusses oder auf der Startseite dieser Komponente festlegen.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$session.params.phone_number (Optional) Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird. String
$session.params.all_recent_order_id (Optional) Mit diesem Parameter werden Bestell-IDs aufgelistet, die dem authentifizierten Nutzer zugeordnet sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist 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) Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. String

Mit dieser vordefinierten Komponente können Sie die folgenden optionalen Parameter verwenden, um das Verhalten der Komponente zu konfigurieren, 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 fortgefahren werden soll. Der Standardwert ist 2. integer
$flow.max_retry_order_number Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten fünf Ziffern einer Bestellnummer angegeben werden. 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, falls 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 an, wenn die vollständige Bestellnummer angegeben wird, falls 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 Runde präsentiert werden sollen. Der Standardwert ist 2. integer
$flow.max_product_display Gibt die maximale Anzahl von Produkten an, die während der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 9. integer
$flow.max_retry_product_number_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen an, wenn ein Produkt zum Abbrechen ausgewählt wird. Der Standardwert ist 2. integer
$flow.max_product_cancel_confirm_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen beim Bestätigen des ausgewählten Produkts an. Der Standardwert ist 2. integer
$flow.max_retry_select_quantity Gibt die maximal zulässige Anzahl von Wiederholungsversuchen 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 Entität prebuilt_components_product_cancel_reason an, der darauf hinweist, dass der Nutzer den Kündigungsgrund „Sonstiges“ ausgewählt hat. 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 Zahlungsmethode 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 mit Store-Guthaben angibt. Der Standardwert ist "store_credit". String

Maximieren Sie den Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.

  1. Öffnen Sie die Dialogflow CX-Konsole.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Erstellen 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 Parametervoreinstellungen 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 gibt Werte für die folgenden Ausgabeparameter zurück:

Parametername Beschreibung Ausgabeformat
phone_number Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. String
all_recent_order_id Die Bestell-IDs, die dem authentifizierten Nutzer zugeordnet sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null. Liste (String)
E-Mail Die mit dem Konto verknüpfte E‑Mail-Adresse. String
user_first_name Der Vorname des Nutzers, der zur Begrüßung und zur Bestätigung der Inhaberschaft des Kontos verwendet wird. String
transfer_reason Der Grund, warum der Ablauf beendet wurde, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:

agent: Der Nutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.

denial_of_information: Der Nutzer 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. Siehe 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

Generatoren

Generatoren steuern bestimmte Teile der Unterhaltung.

Zusammenfassung

Der Summarization-Generator erstellt eine Zusammenfassung nach dem Anruf, in der die von der Komponente verarbeitete Unterhaltung beschrieben wird.

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

  1. Importieren Sie die vordefinierte Komponente.
  2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks, indem Sie eine Konfiguration angeben, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie im Abschnitt Webhook einrichten.

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, konfigurieren Sie sie, um die Nutzerauthentifizierung für diese Komponente zu aktivieren. Weitere Informationen zur Authentifizierung finden Sie im Leitfaden Retail-Authentifizierungs-Webhook einrichten.

Ruf Bestellinformationen ab

Der Webhook prebuilt_components_cancel_order:get_order_details ruft Bestelldetails für eine bestimmte Bestellung ab.

API-Anfrageparameter

Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:

Parametername Beschreibung Eingabeformat
$flow.order_id Bestell-ID, für die Details abgerufen werden sollen. String

API-Antwortparameter

Die Komponente ruft die folgenden Parameter aus der API-Antwort ab:

Parametername Beschreibung Ausgabeformat
order_date Das Datum, an dem die Bestellung aufgegeben wurde, im Format YYYY-MM-DD. String
order_time Der Zeitpunkt, zu dem die Bestellung aufgegeben wurde, im Format HH:MM. String
order_product_count Die Anzahl der eindeutigen Produkte in einer Bestellung. integer
order_payment_mode Gibt die Zahlungsart an, die bei der Bestellung verwendet wurde. String
cancelable_product_id Eine Liste der Produkt-IDs für stornierbare Produkte innerhalb der Bestellung. Liste (String)
cancelable_product_name Eine Liste der Produktnamen für stornierbare Produkte innerhalb der Bestellung. Liste (String)
cancelable_product_brand_name Eine Liste der Markennamen für stornierbare Produkte in der Bestellung. Liste (String)
cancelable_product_quantity Eine Liste der Mengen für stornierbare Produkte innerhalb der Bestellung. Liste (String)

Maximieren Sie den Bereich, um eine Anleitung zum Konfigurieren des Webhooks „Bestelldetails abrufen“ für diese Komponente zu erhalten.

  1. Öffnen Sie die Dialogflow CX-Konsole.
  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 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.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
  9. 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.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Details zu doppelten Bestellungen abrufen

Mit dem Webhook prebuilt_components_retail_services:get_duplicate_order_details kann die Komponente detaillierte Informationen abrufen, um zwischen Bestellungen zu unterscheiden, wenn mehrere Bestellnummern dieselben letzten fünf Ziffern haben.

API-Anfrageparameter

Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:

Parametername Beschreibung Eingabeformat
$flow.duplicate_order_id Eine Liste mit den letzten fünf Ziffern der Bestellnummern, die für eine oder mehrere Bestellungen des Nutzers verwendet wurden. Liste (String)

API-Antwortparameter

Die Komponente ruft die folgenden Parameter aus der API-Antwort ab:

Parametername Beschreibung Ausgabeformat
all_order_date Eine 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 Eine 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 Array all_order_date. Liste (String)

Maximieren Sie die Anleitung, um den Webhook „Get duplicate order details“ für diese Komponente zu konfigurieren.

  1. Öffnen Sie die Dialogflow CX-Konsole.
  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 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.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
  9. 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.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Details zur Kündigung des Abos

Die Komponente verwendet den Webhook prebuilt_components_cancel_order:post_cancellation_details, um eine Stornierungsanfrage zu senden.

API-Anfrageparameter

Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:

Parametername Beschreibung Eingabeformat
$session.params.phone_number Die lokale Telefonnummer des Nutzers ohne Ländercode, 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 Eine Liste der Produkt-IDs, die der Nutzer kündigen möchte. Liste (String)
$flow.cancel_product_quantity_list Eine Liste der Produktmengen, die der Nutzer stornieren möchte, entsprechend jedem Element in $flow.cancel_product_id_list. Liste (String)
$flow.cancel_reason_list Eine Liste der Stornierungsgründe für jedes stornierte Produkt, die den einzelnen Elementen 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 Komponente ruft die folgenden Parameter aus der API-Antwort ab:

Parametername Beschreibung Ausgabeformat
order_cancellation_ticket_id Ticket-ID für die eingereichte Kündigung. String

Wenn Sie den Webhook „Details nach Kündigung“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

  1. Öffnen Sie die Dialogflow CX-Konsole.
  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_cancellation_details“ aus.
  7. 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.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
  9. 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.
  10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
  11. Klicken Sie auf Speichern.

Abgeschlossen

Die vordefinierte Komponente „Bestellung stornieren“ und die zugehörigen Webhooks sind jetzt eingerichtet und können getestet werden.