Vordefinierte Komponente für Eintauschbestellungen

Die vordefinierte Komponente für die Umtauschbestellung prüft die Authentifizierungsebene des Nutzers. Nachdem du den Nutzer authentifiziert hast, stellt die Komponente Informationen zu den letzten oder früheren Bestellungen des Nutzers bereit. Der Nutzer kann dann mehrere Artikel in einer Bestellung umtauschen und Optionen wie Erstattungs- und Versandmethoden auswählen.

Diese Komponente verwendet die vordefinierte Komponente Retail authentication, um Nutzer zu authentifizieren.

Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf und für FAQs.

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.

Umtausch eines defekten Artikels im Geschäft

  1. Der Nutzer ist bereits authentifiziert.
  2. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung umgetauscht werden sollen, und erfragt den Grund für den Umtausch.
  3. Der Nutzer wählt die Option aus, die Artikel in einem Geschäft umzutauschen.
  4. Der Agent stellt eine Liste der nächstgelegenen Geschäfte bereit.
  5. Der Nutzer wählt ein Geschäft aus.
  6. Der Agent erstellt ein Versandlabel, das an die registrierten Kanäle des Nutzers gesendet wird.
Nutzereingabe Antwort des KI-Agenten
Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer 12375 an, die am 10.11.2023 aufgegeben wurde und 2 Lampen, 2 Pixel und 10 andere Produkte enthält?
Ja
Wir haben in deiner Bestellung einige Produkte gefunden, die für eine Rückgabe infrage kommen. Teile uns mit, welches Produkt du umtauschen möchtest. Produkt 1: Google-Lampe, Produkt 2: Google Pixel, Produkt 3: Google-LED-Leuchte.

Nenne oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage „Weiter“, um weitere Produkte anzuzeigen.
1
Sie möchten also die Google-Lampe umtauschen. Ist das richtig?
Ja
Die verfügbare Menge des ausgewählten Produkts ist 2. Geben Sie die Anzahl der Produkte an, die Sie umtauschen möchten.
Zwei
Geben Sie den Grund für den Umtausch an. Beispiele: Artikel defekt oder funktioniert nicht, Problem mit Größe oder Passform, unvollständige Bestellung, Problem mit dem Stil, falsche Farbe oder andere Probleme.
Artikel defekt
Vielen Dank für die Information.

Wie möchtest du das Produkt umtauschen? Sie können beispielsweise „Im Geschäft umtauschen“ oder „Abholung planen“ sagen.
Ich möchte das Gerät in einem Geschäft umtauschen.
Wir können ein Geschäft in deiner Nähe finden.
Der Agent erfasst die Postleitzahl mithilfe der vordefinierten Komponente Postleitzahlenerfassung.
Hier ist die Liste der Standorte in der Nähe der von Ihnen eingegebenen Postleitzahl.
Adresse 1: Google Texas, 500 W 2nd St, Suite 2900, Austin, Texas 78701, USA.
Adresse 2: Google California, 19510 Jamboree Road, Irvine, California 92612, USA.

Sagen oder geben Sie die Nummer der Adresse ein, die Sie auswählen möchten, oder sagen Sie „Weiter“, um weitere Adressen von Geschäften aufzurufen.
Das erste Geschäft
Sie haben Google Texas, 500 W 2nd St, Suite 2900, Austin, Texas 78701, USA ausgewählt. Ist das richtig?
Ja
Perfekt. Wir haben ein Versandlabel und eine Ticketnummer an deine registrierte Telefonnummer und E‑Mail-Adresse gesendet. Drucke es aus, bringe es am Paket an und gib das Paket innerhalb von 30 Tagen ab. Sobald der Artikel in unserem Lager eingegangen ist, dauert es 3 bis 5 Arbeitstage, bis der Umtausch in deinem Konto angezeigt wird. Der Erstattungsbetrag enthält keine Versand- und Bearbeitungsgebühren.

Dein Ersatzprodukt hat einen höheren Wert. Der Preisunterschied beträgt 20 $. Du erhältst den Zahlungslink demnächst an deine registrierte Mobilnummer. Nimm die Zahlung innerhalb von 24 Stunden vor, um den Umtausch zu veranlassen.

Möchtest du eine weitere Bestellung umtauschen?
Nein, das war alles.
Vielen Dank für deinen Anruf.

Erstattung der Preisdifferenz

  1. Der Nutzer ist bereits authentifiziert.
  2. Der KI-Agent erfasst die Bestellnummer, das umzutauschende Produkt und den Grund für den Umtausch.
  3. Der Nutzer entscheidet sich, die Artikel gegen eine andere Größe umzutauschen, und vereinbart eine Abholung.
  4. Der Kundenservicemitarbeiter stellt fest, dass der umgetauschte Artikel günstiger ist als der neue Artikel, und bestätigt die Zahlungsmethode für eine Erstattung mit dem Nutzer.
Nutzereingabe Antwort des KI-Agenten
Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer, die auf 12345 endet, an? Sie enthält 2 Lampen und wurde am 10.11.2023 aufgegeben.
Nein
Möchten Sie eine andere Bestellung umtauschen?
Ja
Könnten Sie mir die letzten fünf Ziffern der Bestell-ID des Artikels nennen, den Sie umtauschen 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.

Wir haben in Ihrer Bestellung einige Produkte gefunden, die für eine Rückgabe infrage kommen. Teile uns mit, welches Produkt du umtauschen möchtest. Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Sagen Sie die Produktnummer des gewünschten Artikels oder geben Sie sie ein. Sie können auch „Weiter“ sagen, um weitere Produkte anzeigen zu lassen.
Zwei
Sie möchten das Google-T-Shirt umtauschen. Ist das richtig?
Ja
Geben Sie den Grund für den Umtausch an. Sie können beispielsweise Folgendes sagen: „Artikel defekt oder funktioniert nicht“, „Problem mit Größe oder Passform“, „Unvollständige Bestellung“, „Problem mit Stil“, „Falsche Farbe“ oder „Sonstiges“.
Problem mit der Größe oder Passform
Vielen Dank, dass du uns den Grund für den Umtausch mitgeteilt hast. Können Sie uns die Größe nennen, in die Sie umtauschen möchten? Wir haben die folgenden Größen verfügbar:
Sagen Sie 1 für S.
Sagen Sie 2 für M.
Sagen Sie 3 für L.
Sagen Sie 4 für XL.
Sagen Sie 5 für XXL.
1
Wie möchten Sie das Produkt umtauschen? Du kannst beispielsweise „Im Geschäft umtauschen“ oder „Abholung vereinbaren“ sagen.
Abholung planen
Perfekt. Wir haben ein Versandlabel an deine hinterlegte Telefonnummer und E‑Mail-Adresse gesendet. Drucke es aus und klebe es auf das Paket. Unser Team wird sich innerhalb der nächsten 24 bis 48 Stunden bei dir melden, um einen Abholtermin zu vereinbaren. Sobald der Artikel in unserem Lager eingegangen ist, dauert es 3 bis 5 Arbeitstage, bis die Erstattung für den Umtausch auf deinem Konto eingeht.

Das umgetauschte Produkt hat einen geringeren Wert und du hast Anspruch auf eine Erstattung in Höhe von 5 $.
Teile uns mit, wohin wir die Erstattung senden sollen. Du kannst beispielsweise „Store-Guthaben“ oder „Quellkonto“ sagen.
Store-Guthaben
Vielen Dank für die Bestätigung, dass du deine Erstattung in Form von Wallet-Guthaben erhalten möchtest.

Möchtest du eine weitere Bestellung umtauschen?
no
Vielen Dank für deinen Anruf.

Nicht berechtigte Bestellung

  1. Der Nutzer hat sich bereits authentifiziert.
  2. Der Kundenservicemitarbeiter prüft die letzte Bestellung und stellt fest, dass keine Produkte für einen Umtausch infrage kommen.
  3. Der Agent erfasst eine Bestellnummer vom Nutzer und stellt fest, dass die angegebene Bestellung keine berechtigten Produkte enthält.
Nutzereingabe Antwort des KI-Agenten
Wir haben in deiner letzten Bestellung keine Produkte gefunden, die umgetauscht werden können.

Möchtest du Produkte aus einer anderen Bestellung umtauschen?
Ja
Könnten Sie mir die letzten fünf Ziffern der Bestell-ID des Artikels nennen, den Sie umtauschen möchten?
23487
Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 23487. Ist das richtig?
Ja
Vielen Dank, dass Sie uns die Bestell-ID mitgeteilt haben.
Leider enthält deine Bestellung keine Produkte, die gemäß unseren Richtlinien umgetauscht werden können. Weitere Informationen zu unseren Umtauschrichtlinien findest du auf unserer Website.

Möchtest du eine weitere Bestellung umtauschen?
no
Vielen Dank für deinen Anruf.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Order Status
Entitätstyp prebuilt_components_[component_name]_[entity_type] prebuilt_components_exchange_order_location
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_exchange_order:get_product_exchange_availability

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, wie unten beschrieben. 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) 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 der authentifizierte 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 optionale Parameter konfigurieren, um das Verhalten der Komponente zu steuern, einschließlich Wiederholungsversuchen.

Parametername Beschreibung Format
$flow.max_retry_another_account Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ausgewählt wird, ob mit einem alternativen Konto fortgefahren werden soll. Der Standardwert ist 3. 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 3. integer
$flow.max_retry_another_order Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine andere Bestellung für die Rückgabe ausgewählt wird, falls die Bestell-ID nicht gefunden wird oder die Bestellung nicht für den Umtausch infrage kommt. 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 mehr als eine Bestellung dieselben letzten fünf Ziffern hat. Der Standardwert ist 2. integer
$flow.max_retry_exchange_reason Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Grund für den Umtausch angegeben wird. Der Standardwert ist 3. integer
$flow.max_retry_exchange_reason_counter Gibt die Anzahl der zulässigen Wiederholungsversuche beim Bestätigen des Grundes für den Umtausch an. Der Standardwert ist 2. integer
$flow.order_product_exchange_reason_others Gibt den Wert der Entität prebuilt_components_exchange_order_reason an, der darauf hinweist, dass der Nutzer „Andere“ als Grund für den Umtausch ausgewählt hat. Der Standardwert ist "others". String
$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_product_exchange_confirm Gibt die maximal zulässige Anzahl von Wiederholungsversuchen beim Bestätigen des ausgewählten Produkts an. Der Standardwert ist 2. integer
$flow.max_retry_product_number_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen beim Auswählen eines Produkts für den Umtausch an. Der Standardwert ist 3. integer
$flow.max_retry_select_quantity Gibt die maximal zulässige Anzahl von Wiederholungsversuchen bei der Auswahl der Menge des umzutauschenden Produkts an. Der Standardwert ist 2. integer
$flow.max_retry_size_number_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen an, wenn die Größe für den Umtausch ausgewählt wird. Der Standardwert ist 2. integer
$flow.max_retry_another_zip_code Gibt die maximal zulässige Anzahl von Wiederholungsversuchen bei der Angabe einer Postleitzahl an. Der Standardwert ist 2. integer
$flow.max_store_display_counter Gibt die maximale Anzahl von Geschäften an, die in einer einzelnen Runde präsentiert werden sollen. Der Standardwert ist 1. integer
$flow.max_store_display Gibt die maximale Anzahl von Geschäften an, die während der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 10. integer
$flow.max_retry_store_number_counter Gibt die maximal zulässige Anzahl von Wiederholungsversuchen bei der Auswahl eines Geschäfts an. Der Standardwert ist 2. integer
$flow.max_retry_store_selection Gibt die Anzahl der zulässigen Wiederholungsversuche beim Bestätigen der Geschäftsauswahl an. Der Standardwert ist 3. integer
$flow.max_available_address_reselection_counter Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn bestätigt werden soll, ob der Nutzer eine andere Geschäftsadresse auswählen möchte. 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
$flow.order_refund_mode_source_account Gibt den Wert der Entität prebuilt_components_exchange_order_refund_mode an, der zeigt, dass der Nutzer die Erstattung auf sein ursprüngliches Konto ausgewählt hat. Der Standardwert ist source_account. String
$flow.order_exchange_location_scheduled_for_pickup Gibt den Wert der Entität prebuilt_components_exchange_order_location an, der zeigt, dass der Nutzer eine Abholung für den Umtausch ausgewählt hat. Der Standardwert ist scheduled_for_pickup. 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 bietet die folgenden Ausgabeparameter:

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 der authentifizierte 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 Gibt den Grund an, 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

Diese Komponente verwendet Generatoren, um bestimmte Teile der Unterhaltung zu aktivieren.

FAQ

Der Generator FAQ verarbeitet häufig gestellte Fragen zu Rückgaben und Umtausch, darunter:

  • Gibt es eine Frist für die Rückgabe?
  • Kann ich ein Geschenk umtauschen?
  • Der Produktpreis und der Erstattungsbetrag sind unterschiedlich. Warum ist das so?

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 mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie im Abschnitt Webhook einrichten.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, konfigurieren Sie die enthaltenen flexiblen Webhooks so, 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 Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Weitere Informationen finden Sie in der Dokumentation zum Einrichten des Webhooks für die Retail-Authentifizierung.

Ruf Bestellinformationen ab

Die Komponente verwendet den Webhook prebuilt_components_exchange_order:get_order_details, um Bestelldetails für eine bestimmte Bestellung abzurufen.

API-Anfrageparameter

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

Parametername Beschreibung Eingabeformat
$flow.order_id Die 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 Datum, an dem die Bestellung aufgegeben wurde, im Format YYYY-MM-DD. String
order_product_count Die Anzahl der eindeutigen Produkte in der Bestellung. integer
order_payment_mode Gibt die Zahlungsart an, die bei der Bestellung verwendet wurde. String
exchangeable_product_id Eine Liste der Produkt-IDs für umtauschbare Produkte innerhalb der Bestellung. Liste (String)
exchangeable_product_name Eine Liste der Produktnamen für umtauschbare Produkte innerhalb der Bestellung. Liste (String)
exchangeable_product_brand_name Eine Liste der Markennamen für umtauschbare Produkte in der Bestellung. Liste (String)
exchangeable_product_quantity Eine Liste der Mengen für umtauschbare Produkte innerhalb der Bestellung. Liste (String)
exchangeable_product_price Eine Liste der Preise für umtauschbare 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_exchange_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

Die Komponente verwendet den Webhook prebuilt_components_retail_services:get_duplicate_order_details, um detaillierte Informationen abzurufen, mit denen Sie zwischen Bestellungen unterscheiden können, 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.

Verfügbare Trade-In-Größe abrufen

Mit dem Webhook prebuilt_components_exchange_order:get_available_exchange_size kann die Komponente verfügbare Größen für den Umtausch abrufen, wenn der Nutzer einen Artikel aufgrund von Größen- oder Passformproblemen umtauschen möchte.

API-Anfrageparameter

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

Parametername Beschreibung Eingabeformat
$flow.selected_order_product_id Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
product_available_sizes Eine Liste der verfügbaren Größen für das ausgewählte Produkt. Liste (String)

Maximieren Sie den Bereich, um die Anleitung zum Konfigurieren des Webhooks „Verfügbare Umtauschgröße abrufen“ für diese Komponente 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_exchange_order:get_available_exchange_size“ 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.

Verfügbarkeit des Produktumtauschs abrufen

Mit dem Webhook prebuilt_components_exchange_order:get_product_exchange_availability kann die Komponente prüfen, ob das vom Nutzer ausgewählte Produkt, die Menge und die Größe für den Umtausch verfügbar sind.

API-Anfrageparameter

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

Parametername Beschreibung Eingabeformat
$flow.order_id Die Bestell-ID, für die Details abgerufen werden sollen. String
$flow.selected_order_product_id Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte. String
$flow.order_product_quantity_exchange_count Die Anzahl der Produkte, die der Nutzer umtauschen möchte. integer
$flow.product_selected_size Die Größe des Produkts, gegen das der Nutzer das Produkt umtauschen möchte. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
product_exchange_availability Gibt an, ob das ausgewählte Produkt, die Menge und die Größe für einen Umtausch verfügbar sind. boolean
product_exchange_price Gibt den Umtauschpreis für einen einzelnen Artikel des ausgewählten Produkts und der ausgewählten Größe an. Zahl

Wenn Sie den Webhook „Verfügbarkeit des Produktumtauschs abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

  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_exchange_order:get_product_exchange_availability“ 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.

Ticket für unvollständige Bestellung erstellen

Die Komponente verwendet den Webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket, um ein Ticket zu erstellen, wenn ein Nutzer ein Produkt innerhalb einer Bestellung umtauschen möchte, weil die Bestellung unvollständig ist.

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 Die Bestell-ID, für die ein Ticket eingereicht werden soll. String
$flow.selected_order_product_id Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte. String
$flow.order_product_quantity_exchange_count Die Anzahl der Produkte, die der Nutzer umtauschen möchte. integer
$flow.order_product_exchange_reason Der Grund, warum der Nutzer das Produkt umtauschen möchte. String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Ticket für unvollständige Bestellung erstellen“ 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 Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_exchange_order:raise_incomplete_order_ticket“ 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 zum App-Shop abrufen

Mit dem Webhook prebuilt_components_exchange_order:get_store_details kann die Komponente die Liste der Geschäfte in der Nähe der vom Nutzer angegebenen Postleitzahl abrufen.

API-Anfrageparameter

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

Parametername Beschreibung Eingabeformat
$flow.zip_code Postleitzahl, um nach Geschäften in der Nähe zu suchen. String

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
store_id Eine Liste der Geschäfts-IDs. Liste (String)
store_address Eine Liste der Adressen der Geschäfte, die den einzelnen Elementen von store_id entsprechen. Liste (String)

Maximieren Sie die Anleitung, um den Webhook „Geschäftsdetails abrufen“ 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_exchange_order:get_store_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 zum Umtausch per Post

Die Komponente verwendet den Webhook prebuilt_components_exchange_order:post_exchange_details, um einen Austausch 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 Die Bestell-ID, für die ein Ticket eingereicht werden soll. String
$flow.selected_order_product_id Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte. String
$flow.order_product_quantity_exchange_count Die Anzahl der Produkte, die der Nutzer umtauschen möchte. integer
$flow.product_selected_size Die Größe des Produkts, gegen das der Nutzer das Produkt umtauschen möchte. String
$flow.order_product_exchange_reason Der Grund, warum der Nutzer das Produkt umtauschen möchte. String
$flow.order_exchange_location Der ausgewählte Modus für die Anzeigenplattform. Gültige Werte werden durch die Entität prebuilt_components_exchange_order_location definiert. String
$flow.order_exchange_store_id Die ID des Geschäfts, das der Nutzer für einen Umtausch im Geschäft ausgewählt hat. String
$flow.order_refund_mode Die Zahlungsart für die Erstattung, falls zutreffend. Gültige Werte werden durch die Entität prebuilt_components_exchange_order_refund_mode definiert. Wenn keine Erstattung erforderlich ist, ist dieser Wert null. String
$flow.total_refund_amount Der zu erstattende Betrag, wenn der Preis des umzutauschenden Produkts höher ist als der des neuen Produkts. Wenn keine Erstattung erforderlich ist, ist dieser Wert null. integer

API-Antwortparameter

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

Parametername Beschreibung Ausgabeformat
order_exchange_ticket_id Die Ticket-ID für den eingereichten Umtausch. String

Maximieren Sie die Anleitung, um den Webhook für die Details zum Post-Austausch 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_exchange_order:post_exchange_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.

Informationen zur Erstattung per Nachnahme senden

Über den Webhook prebuilt_components_exchange_order:send_COD_refund_information kann die Komponente umtauschbezogene Zahlungsinformationen an den Nutzer 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 Die Bestell-ID, für die ein Ticket eingereicht werden soll. String
$flow.channel Der spezifische Kanal, an den Informationen gesendet werden sollen. Gültige Werte werden durch die Entität prebuilt_components_channel_email_phone definiert. Standardmäßig werden phone und email unterstützt. String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Send COD refund information“ (Informationen zur Erstattung per Nachnahme senden) 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 Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_exchange_order:send_COD_refund_information“ 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 und ihre Webhooks sind jetzt eingerichtet und können getestet werden.