Vordefinierte Komponente für Anzeigenplattform-Bestellung

Die vordefinierte Komponente der Exchange-Bestellung 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 mehrere Artikel einer Bestellung umtauschen und Optionen wie Erstattung und Versandoptionen auswählen. Diese Komponente verwendet die vordefinierte Komponente für die Retail-Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet außerdem Generatoren für eine Zusammenfassung nach dem Aufruf und häufig gestellte Fragen.

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.

Umtausch eines defekten Artikels

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung umgetauscht werden sollen, und ermittelt den Grund für den Austausch. Der Nutzer entscheidet sich für den Umtausch der Artikel in einem Geschäft und der Agent stellt eine Liste der nächstgelegenen Geschäfte bereit. Der Nutzer wählt ein Geschäft aus und der Agent generiert ein Versandlabel, das an die registrierten Kanäle des Nutzers gesendet wird.

Nutzereingabe	Agent-Antwort
	Rufen Sie wegen Ihrer letzten Bestellnummer mit den Endziffern 12375 an, die 2 Lampen, 2 Pixel und 10 weitere Produkte enthält, die am 10.11.2023 aufgegeben wurden?
yes
	Ihre Bestellung enthält einige geeignete Produkte. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Lampe, Produkt 2: Google Pixel, Produkt 3: Google-LED-Leuchte. Bitte sage oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage neben, um weitere Produkte anzuzeigen.
1
	Zur Bestätigung: Sie möchten die Google-Lampe austauschen. Ist das richtig?
yes
	Wir sehen, dass die verfügbare Menge des ausgewählten Produkts 2 beträgt. Gib die Anzahl der Produkte an, die du umtauschen möchtest.
Zwei
	Bitte geben Sie den Grund für den Austausch an. Sie könnten z. B. sagen: Artikel defekt oder funktioniert nicht, Größe oder Passform, unvollständige Bestellung, Stilproblem, falsche Farbe oder andere Angaben.
Artikel defekt
	Vielen Dank für deine Nachricht. Als Letztes: Wie möchtest du das Produkt umtauschen? Du kannst zum Beispiel „In einem Geschäft umtauschen“ oder „Abholung planen“ sagen.
Ich möchte in einem Geschäft eintauschen
	Lass uns ein Geschäft in deiner Nähe suchen.
	Der Kundenservicemitarbeiter erfasst die Postleitzahl mithilfe der vordefinierten Komponente für die Erfassung von Postleitzahlen
	Hier ist die Liste der Standorte in der Nähe der Postleitzahl, die du eingegeben hast. Adresse 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, USA. Adresse 2: Google California, 19510 Jamboree Road, Irvine, Kalifornien 92612, USA. Sag oder gib neben der Adresse „Weiter“, um weitere Adressen anzuzeigen oder weitere Adressen anzeigen zu lassen.
Das erste Geschäft
	Zur Bestätigung: Sie haben „Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, USA“ ausgewählt. Ist das richtig?
yes
	Perfekt. Wir haben ein Versandlabel und eine Ticketnummer an Ihre registrierte Telefonnummer und E-Mail-Adresse gesendet. Drucken Sie die Kopie aus, fügen Sie sie Ihrer Bestellung bei und geben Sie den Austausch innerhalb von 30 Tagen ab. Nachdem wir den Artikel in unserem Lager erhalten haben, dauert es 3 bis 5 Werktage, bis der Umtausch (sofern zutreffend) in deinem Konto erscheint. Hinweis: Der Erstattungsbetrag versteht sich ohne Versand- und Bearbeitungsgebühren. Das Produkt in deiner Gerätetausch hat einen höheren Wert. Der Preisunterschied beträgt 20$. Du erhältst den Zahlungslink in Kürze unter deiner registrierten Mobilnummer. Bitte führen Sie die Zahlung innerhalb von 24 Stunden aus, um den Umtausch vorzunehmen. Möchten Sie eine weitere Bestellung umtauschen?
Nein, das war's
	Vielen Dank für Ihren Anruf.

Erstattung wegen Preisdifferenz

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter erfasst die Bestellnummer, das umzutauschende Produkt und den Grund für den Austausch. Der Nutzer entscheidet sich für den Umtausch der Artikel für eine andere Größe und plant eine Abholung. Der Kundenservicemitarbeiter gibt an, dass der umgetauschte Artikel niedriger ist als der neue Artikel, und bestätigt dem Nutzer die Zahlungsmethode für die Erstattung.

Nutzereingabe	Agent-Antwort
	Rufen Sie wegen der letzten Bestellnummer mit den Endziffern 12345 an, die zwei Lampe auf dem 10.11.2023 enthält?
Nein
	Möchten Sie eine weitere Bestellung umtauschen?
Ja
	Könnten Sie bitte die letzten fünf Ziffern Ihrer Bestell-ID angeben, die Sie umtauschen möchten?
12346
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346, richtig?
Ja
	Die Erfassung der Bestell-ID ist abgeschlossen. Wir haben geeignete Produkte in Ihrer Bestellung gefunden. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google Wasserflasche, Produkt 2: Google-T-Shirt. Sagen Sie die Nummer des Artikels, den Sie auswählen möchten, oder geben Sie ihn ein, oder sagen Sie neben, um weitere Produkte anzuzeigen.
Zwei
	Zur Bestätigung: Sie möchten das Google-T-Shirt gegen Tausch eintauschen. Ist das richtig?
Ja
	Bitte geben Sie den Grund für den Austausch an. Sie könnten z. B. sagen: Artikel defekt oder funktioniert nicht, Größe oder Passform, unvollständige Bestellung, Stilproblem, falsche Farbe oder andere Angaben.
Problem mit der Größe oder Passform
	Vielen Dank, dass du uns den Grund für den Austausch mitgeteilt hast. Kannst du uns bitte die Größe nennen, die du gerne umtauschen möchtest? Folgende Größen sind verfügbar: Sagen Sie 1 für klein. Sagen Sie 2 für mittel. Sagen Sie 3 für groß. Sagen Sie 4 für XL. Sagen Sie 5 für doppelt XL.
1
	Als letzten Schritt: Wie möchten Sie das Produkt umtauschen? Du kannst zum Beispiel „In einem Geschäft umtauschen“ oder „Abholung planen“ sagen.
Abholung planen
	Perfekt. Wir haben ein Versandlabel an Ihre registrierte Telefonnummer und E-Mail-Adresse gesendet. Bitte drucke ihn aus und lege ihn dem Paket bei. Unser Team wird sich innerhalb der nächsten 24 bis 48 Stunden bei Ihnen melden, um einen Abholtermin zu vereinbaren. Nachdem wir den Artikel in unserem Lager erhalten haben, dauert es drei bis fünf Werktage, bis die Erstattung, die du mit dem Produkttausch erhalten hast, in deinem Konto angezeigt wird. Dein eingetauschtes Produkt hat einen geringeren Wert und du hast Anspruch auf eine Erstattung in Höhe von 5$. Bitte teile uns mit, wo du die Erstattung erhalten möchtest. Du kannst zum Beispiel „Google Store-Guthaben“ oder „Quellkonto“ sagen.
Store-Guthaben
	Vielen Dank für die Bestätigung, dass Sie möchten, dass die Erstattung an Google Wallet zurückgesendet wird. Möchten Sie eine weitere Bestellung umtauschen?
no
	Vielen Dank für Ihren Anruf.

Unzulässige Bestellung

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter prüft die letzte Bestellung und findet keine geeigneten Produkte für den Austausch. Der Kundenservicemitarbeiter erfasst vom Nutzer eine Bestellnummer und stellt fest, dass die Bestellung keine geeigneten Produkte enthält.

Nutzereingabe	Agent-Antwort
	Wir haben in Ihrer letzten Bestellung keine Produkte gefunden, die umtauschbar sind. Möchten Sie eine weitere Bestellung umtauschen?
yes
	Könnten Sie bitte die letzten fünf Ziffern Ihrer Bestell-ID angeben, die Sie umtauschen möchten?
23487
	Die letzten fünf Ziffern der Bestell-ID lauten 23487, richtig?
yes
	Die Erfassung der Bestell-ID ist abgeschlossen.
	Deine Bestellung enthält leider keine Produkte, die gemäß unseren Richtlinien umgetauscht werden können. Weitere Informationen zu unseren Richtlinien für Umtausch finden Sie auf unserer Website. Möchten Sie eine weitere Bestellung umtauschen?
no
	Vielen Dank für Ihren Anruf.

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Fluss	[Komponentenname]	Bestellstatus
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

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	Gibt die Anzahl der erlaubten Wiederholungsversuche an, wenn Sie auswählen, ob mit einem alternativen Konto fortgefahren werden soll. Der Standardwert ist `3`.	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 `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 und die Bestell-ID nicht gefunden wird oder die Bestellung nicht für den Austausch infrage kommt. Der Standardwert ist `2`.	integer
$flow.max_retry_select_order_number	Gibt die Anzahl der zulässigen Wiederholungsversuche bei Angabe der vollständigen Bestellnummer in Fällen an, in denen mehr als eine Bestellung die 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 Austausch angegeben wird. Der Standardwert ist `3`.	integer
$flow.max_retry_exchange_reason_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Grund für den Austausch bestätigt wird. Der Standardwert ist `2`.	integer
$flow.order_product_exchange_reason_others	Gibt den Wert der Entität `prebuilt_components_exchange_order_reason` an, der angibt, dass der Nutzer den Austauschgrund „Andere“ ausgewählt hat. Der Standardwert ist `"others"`.	String
$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_product_exchange_confirm	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_product_number_counter	Gibt die maximale Anzahl der Wiederholungsversuche an, die bei der Auswahl eines Produkts für den Austausch zulässig sind. Der Standardwert ist `3`.	integer
$flow.max_retry_select_quantity	Gibt die maximal zulässige Anzahl von Wiederholungen an, wenn die Anzahl der ausgetauschten Produkte ausgewählt wird. Der Standardwert ist `2`.	integer
$flow.max_retry_size_number_counter	Gibt die maximal zulässige Anzahl der Wiederholungsversuche an, wenn die Größe für den Austausch ausgewählt wird. Der Standardwert ist `2`.	integer
$flow.max_retry_another_zip_code	Gibt die maximale Anzahl der Wiederholungsversuche an, die bei Angabe einer Postleitzahl zulässig sind. Der Standardwert ist `2`.	integer
$flow.max_store_display_counter	Gibt die maximale Anzahl von Geschäften an, die in einer einzelnen Runde angezeigt werden sollen. Der Standardwert ist `1`.	integer
$flow.max_store_display	Gibt die maximale Anzahl von Geschäften an, die in der gesamten Konversation angezeigt werden sollen. Der Standardwert ist `10`.	integer
$flow.max_retry_store_number_counter	Gibt die maximale Anzahl der Wiederholungsversuche an, die bei der Auswahl eines Speichers zulässig sind. Der Standardwert ist `2`.	integer
$flow.max_retry_store_selection	Gibt die Anzahl der zulässigen Wiederholungsversuche bei der Bestätigung 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 wird, dass der Nutzer eine andere Adresse des Geschäfts auswählen möchte. 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
$flow.order_refund_mode_source_account	Gibt den Wert der Entität `prebuilt_components_exchange_order_refund_mode` an, der angibt, dass der Nutzer die Erstattung auf sein Quellkonto 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 angibt, dass der Nutzer ausgewählt hat, eine Abholung für den Austausch zu planen. Der Standardwert ist `scheduled_for_pickup`.	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.

Häufig gestellte Fragen

Der FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Rückgaben und Umtausch zu verarbeiten, einschließlich:

Gibt es eine Frist für den Rückgabeprozess?
Kann ich einen Geschenkartikel umtauschen?
Der Produktpreis und der Erstattungsbetrag unterscheiden sich. Woran liegt das?

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_exchange_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_product_count	Die Anzahl der eindeutigen Produkte innerhalb einer Bestellung.	integer
order_payment_mode	Gibt die beim Aufgeben der Bestellung verwendete Zahlungsart an.	String
exchangeable_product_id	Liste der Produkt-IDs für tauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_name	Liste der Produktnamen für tauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_brand_name	Liste der Markennamen für tauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_quantity	Liste der Mengen für austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_price	Liste der Preise für tauschbare Produkte innerhalb 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_Exchange_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.

Verfügbare Anzeigenplattformgröße abrufen

Der Webhook prebuilt_components_exchange_order:get_available_exchange_size wird von der Komponente verwendet, um verfügbare Größen für den Austausch abzurufen, wenn der Nutzer ein Element aufgrund von Größen- oder Passproblemen umtauschen möchte.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

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

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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

Wenn Sie den Webhook „Verfügbare Anzeigenplattformgröße 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_Exchange_order:get_available_Exchange_size“ 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.

Verfügbarkeit von Produktplattformen abrufen

Mit dem Webhook prebuilt_components_exchange_order:get_product_exchange_availability wird von der Komponente geprüft, ob das vom Nutzer ausgewählte Produkt, die ausgewählte Menge und die optionale Größe für einen Austausch verfügbar sind.

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
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer austauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer austauschen möchte.	integer
$flow.product_selected_size	Größe des Produkts, das der Nutzer eintauschen möchte.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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

Wenn Sie den Webhook „Produktaustausch mit Verfügbarkeit 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_Exchange_order:get_product_Exchange_availability“ 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.

Unvollständiges Bestellticket melden

Der Webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket wird von der Komponente verwendet, um ein Ticket zu erstellen, wenn der Nutzer ein Produkt innerhalb einer Bestellung austauschen möchte, weil es unvollständig ist.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, mit der er identifiziert werden kann.	String
$flow.order_id	Bestell-ID, für die ein Ticket eingereicht werden soll.	String
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer austauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer austauschen möchte.	integer
$flow.order_product_exchange_reason	Der Grund, warum der Nutzer das Produkt umtauschen möchte.	String

Maximieren Sie den Bereich, um den Webhook „Unvollständige Bestellungsticket erhöhen“ für diese Komponente zu konfigurieren, um 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 Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_Exchange_order:raise_incomplete_order_ticket“ 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.

Händlerdetails abrufen

Der Webhook prebuilt_components_exchange_order:get_store_details wird von der Komponente verwendet, um die Liste der Geschäfte in der Nähe der vom Nutzer angegebenen Postleitzahl abzurufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

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

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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

Wenn Sie den Webhook „Händlerdetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um Anleitungen zu sehen.

Ö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_Exchange_order:get_store_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 nach Austausch

Der Webhook prebuilt_components_exchange_order:post_exchange_details wird von der Komponente verwendet, um eine Anzeigenplattform einzureichen.

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.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer austauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer austauschen möchte.	integer
$flow.product_selected_size	Größe des Produkts, das der Nutzer eintauschen 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 Shop-ID des Geschäfts, das der Nutzer für eine Anzeigenplattform 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, lautet dieser Wert `null`.	String
$flow.total_refund_amount [Betrag/Erstattung]	Der zu erstattende Betrag, wenn der Preis des umtauschbaren Produkts höher ist als der Preis des neuen Produkts. Wenn keine Erstattung erforderlich ist, lautet dieser Wert `null`.	integer

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
order_exchange_ticket_id	Ticket-ID für die eingereichte Anzeigenplattform.	String

Wenn Sie den Webhook „Post Exchange-Details“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um eine Anleitung zu sehen.

Ö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_Exchange_order:post_Exchange_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.

Informationen zur COD-Erstattung senden

Der Webhook prebuilt_components_exchange_order:send_COD_refund_information wird von der Komponente verwendet, um börsenbezogene Zahlungsinformationen an einen Nutzer 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.channel	Der 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

Wenn Sie den Webhook „COD-Erstattungsinformationen senden“ 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_Exchange_order:send_COD_refund_information“ 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.