Vorgefertigte Komponente zurückgeben und erstatten

Die vorgefertigte Komponente für Rückgaben und Erstattungen prüft die Authentifizierungsebene eines Nutzers. Nach der Authentifizierung des Nutzers liefert die Komponente Informationen zu seinen letzten oder früheren Bestellungen. Der Nutzer kann dann mehrere Artikel in einer Bestellung zurückgeben und Optionen wie Erstattungs- und Rückgabemethoden auswählen. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – Authentifizierung, 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

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

Rückgabe im Geschäft für ein einzelnes Produkt

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung zurückgegeben werden sollen, und erfragt den Grund für die Rückgabe. Der Nutzer entscheidet sich, die Artikel in einem Geschäft zurückzugeben, und der Kundenservicemitarbeiter stellt eine Liste der nächstgelegenen Geschäfte zur Verfügung. Der Nutzer wählt einen Shop aus und der Kundenservicemitarbeiter generiert ein Versandlabel, das an die registrierten Kanäle des Nutzers gesendet wird.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Geht es um Ihre letzte Bestellung mit der Nummer 12345, die am 10.11.2023 aufgegeben wurde und zwei Lampen enthält?
Ja
	Sie möchten die Google-Lampe zurückgeben. Ist das richtig?
Ja
	Die verfügbare Menge des von Ihnen ausgewählten Produkts beträgt 2. Geben Sie die Anzahl der Produkte an, die Sie zurückgeben möchten.
zwei
	Geben Sie den Grund für die Rückgabe an. Sie können beispielsweise sagen, dass der Artikel defekt oder nicht funktionsfähig ist, nicht mehr benötigt wird, ein Problem mit der Größe oder Passform vorliegt, der falsche Artikel gesendet wurde, der Artikel zu spät geliefert wurde oder dass Sie ihn versehentlich gekauft haben.
andere
	Geben Sie bitte den Grund für die Rückgabe an.
schlechte Qualität
	Prüfen, ob der Grund für die Rückgabe die schlechte Qualität ist. Ist das richtig?
Ja
	Bitte teilen Sie uns mit, wo Sie die Erstattung erhalten möchten. Sie können beispielsweise „Guthaben“ oder „Quellkonto“ sagen.
Quellkonto
	Vielen Dank, dass Sie bestätigt haben, dass die Erstattung auf die ursprüngliche Zahlungsmethode erfolgen soll. Wie möchten Sie das Produkt zurückgeben? Sie können z. B. „Im Geschäft zurückgeben“, „An einem Ort abgeben“ oder „Abholung planen“ sagen.
Rückgabe im Geschäft
	Suchen wir ein Geschäft in Ihrer Nähe.
	Kundenservicemitarbeiter erfasst die Postleitzahl mit der vorgefertigten Komponente Postleitzahlerfassung
	Hier ist eine 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. Nennen oder geben Sie die Adressennummer an, die Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Geschäftsadressen zu sehen.
1
	Zur Bestätigung: 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 Ihre registrierte Telefonnummer und E-Mail-Adresse gesendet. Bitte drucken Sie ihn aus, befestigen Sie ihn an Ihrem Paket und geben Sie die Rücksendung innerhalb von 30 Tagen ab. Nachdem wir den Artikel in unserem Lager erhalten haben, dauert es drei bis fünf Arbeitstage, bis die Erstattung auf Ihrem Konto angezeigt wird. Hinweis: Die Versand- und Bearbeitungskosten sind in der Erstattung nicht enthalten. Vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Rückgabe und Erstattung
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_return_refund_mode_of_return
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_return_refund:post_return_details

Eingabeparameter

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	(Optional) Die Ortstelefonnummer des Nutzers ohne Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.all_recent_order_id	Optional. Dieser Parameter enthält die Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays steht für die letzte Bestellung. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null.	Liste (String)
$session.params.email	Optional: Die mit dem 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 Sie das Verhalten der Komponente, einschließlich der Wiederholungen, mit den folgenden optionalen Parametern konfigurieren.

Parametername	Beschreibung	Format
$flow.max_retry_another_account_counter	Gibt die Anzahl der zulässigen Wiederholungen an, wenn Sie auswählen, ob Sie mit einem alternativen Konto fortfahren möchten. Der Standardwert ist 2.	integer
$flow.max_retry_order_number	Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten fünf Ziffern einer Bestellnummer angegeben werden. Der Standardwert ist 3.	integer
$flow.max_retry_another_order	Gibt an, wie oft eine andere Bestellung für die Rückgabe ausgewählt werden darf, wenn die Bestell-ID nicht gefunden wird oder die Bestellung nicht zurückgegeben werden kann. Der Standardwert ist 2.	integer
$flow.max_retry_select_order_number	Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die vollständige Bestellnummer angegeben wird, in Fällen, in denen mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.	integer
$flow.max_product_display_counter	Gibt die maximale Anzahl von Produkten an, die in einer einzelnen Drehung präsentiert werden sollen. Der Standardwert ist 2.	integer
$flow.max_product_display	Gibt die maximale Anzahl von Produkten an, die während der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 9.	integer
$flow.max_retry_product_number_counter	Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt zur Rückgabe ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_product_return_confirm_counter	Gibt die maximale Anzahl der zulässigen Wiederholungen bei der Bestätigung des ausgewählten Produkts an. Der Standardwert ist 2.	integer
$flow.max_retry_return_reason_counter	Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn der Grund für die Rückgabe bestätigt wird. Der Standardwert ist 2.	integer
$flow.order_product_return_reason_others	Gibt den Wert der Entität prebuilt_components_return_refund_reason an, der angibt, dass der Nutzer „Sonstiges“ als Rückgabegrund ausgewählt hat. Der Standardwert ist "others".	String
$flow.max_retry_select_quantity	Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn die Menge des zurückzugebenden Produkts ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_store_display_counter	Gibt die maximale Anzahl von Geschäften an, die bei einer einzelnen Abbiegung angezeigt 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 maximale Anzahl von Wiederholungsversuchen an, die bei der Auswahl eines Geschäfts zulässig sind. Der Standardwert ist 2.	integer
$flow.max_retry_store_selection	Gibt die zulässige Anzahl von Wiederholungsversuchen bei der Bestätigung der Auswahl des Geschäfts an. Der Standardwert ist 2.	integer
$flow.max_retry_another_zip_code	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche bei der Angabe einer Postleitzahl an. Der Standardwert ist 2.	integer
$flow.order_payment_mode_COD	Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-webhook zurückgegeben wird und eine Zahlung per Nachnahme angibt. Der Standardwert ist "COD".	String
$flow.order_payment_mode_store_credit	Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-webhook zurückgegeben wird und eine Zahlungsmethode für Store-Guthaben angibt. Der Standardwert ist "store_credit".	String
$flow.order_refund_mode_source_account	Gibt den Wert der prebuilt_components_return_refund_mode_of_refund-Entität an, der angibt, dass der Nutzer die Erstattung auf sein Quellkonto ausgewählt hat. Der Standardwert ist source_account.	String
$flow.order_return_location_scheduled_for_pickup	Gibt den Wert der Entität prebuilt_components_exchange_order_location an, der angibt, dass der Nutzer ausgewählt hat, einen Abholtermin für die Rückgabe zu vereinbaren. Der Standardwert ist scheduled_for_pickup.	String

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
phone_number	Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
all_recent_order_id	Dieser Parameter enthält Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays steht für die letzte Bestellung. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null.	Liste (String)
E-Mail	Die mit dem Konto registrierte E-Mail-Adresse.	String
user_first_name	Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Kontoinhaberschaft verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Der zurückgegebene Wert kann einer der folgenden sein: agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat die von der Komponente angeforderten Informationen abgelehnt. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungen für No-Input-Ereignisse erreicht. Weitere Informationen finden Sie unter Ereignisse ohne Eingabe. max_no_match: Die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung wurde für die Unterhaltung erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error.not-found“.	String

Generatoren

Diese Komponente verwendet Generatoren, um bestimmte Teile der Unterhaltung zu ermöglichen.

FAQ

Der FAQ-Generator wird für häufig gestellte Fragen zu Retouren und Umtausch verwendet, darunter:

• Gibt es eine Frist für die Rückgabe?
• Kann ich ein Geschenk zurückgeben?
• Der Produktpreis und der Erstattungsbetrag stimmen nicht überein. Warum ist das so?

Zusammenfassung

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

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte 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 unter Webhook einrichten.

Webhook-Einrichtung

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

Authentifizierung

Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies nachholen, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Eine ausführliche Anleitung finden Sie unter Webhook für die Authentifizierung im Einzelhandel einrichten.

Ruf Bestellinformationen ab

Der prebuilt_components_return_refund:get_order_details-Webhook 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 in einer Bestellung.	integer
order_payment_mode	Gibt die Zahlungsart an, die bei der Bestellung verwendet wurde.	String
returnable_product_id	Liste der Produkt-IDs für rückgabefähige Produkte in der Bestellung.	Liste (String)
returnable_product_name	Liste der Produktnamen für rücknehmbare Produkte in der Bestellung.	Liste (String)
returnable_product_brand_name	Liste der Markennamen für rückgabefähige Produkte in der Bestellung.	Liste (String)
returnable_product_quantity	Liste der Stückzahlen für rücknehmbare Produkte in der Bestellung.	Liste (String)

Details zur doppelten Bestellung abrufen

Der prebuilt_components_retail_services:get_duplicate_order_details-Webhook wird von der Komponente verwendet, um detaillierte Informationen abzurufen, um Bestellungen zu unterscheiden, wenn mehrere Bestellnummern dieselben letzten fünf Ziffern haben.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$flow.duplicate_order_id	Liste mit den letzten fünf Ziffern der Bestellnummern, die für eine oder mehrere Bestellungen des Nutzers freigegeben wurden.	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 all_order_time-Array.	Liste (String)
all_order_time	Liste der Bestellzeiten für doppelte Bestellungen mit den angegebenen letzten fünf Ziffern im Format HH:MM. Jedes Element in diesem Array entspricht demselben Element im all_order_date-Array.	Liste (String)

Geschäftsdetails abrufen

Über den prebuilt_components_return_refund:get_store_details-Webhook ruft die Komponente die Liste der Geschäfte in der Nähe der angegebenen Postleitzahl des Nutzers ab.

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 Geschäftsadressen, die den einzelnen Elementen von store_id entsprechen.	Liste (String)

Rücksendedetails posten

Der prebuilt_components_return_refund:post_return_details-Webhook wird von der Komponente verwendet, um eine Rückgabe 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Auftrags-ID, für die ein Ticket eingereicht werden soll.	String
$flow.return_product_id_list	Liste der Produkt-IDs, die der Nutzer zurückgeben möchte.	Liste (String)
$flow.return_product_quantity_list	Liste der Produktmengen, die der Nutzer zurückgeben möchte, die den einzelnen Elementen in $flow.return_product_id_list entsprechen.	Liste (String)
$flow.return_reason_list	Liste der Rückgabegründe für jedes zurückgegebene Produkt, die den einzelnen Elementen in $flow.return_product_id_list entspricht.	Liste (String)
$flow.order_return_location	Der für die Rückgabe ausgewählte Modus. Gültige Werte werden durch das prebuilt_components_exchange_order_location-Element definiert.	String
$flow.order_return_store_id	Die Geschäfts-ID des Geschäfts, das der Nutzer für eine Rückgabe im Geschäft ausgewählt hat.	String
$flow.order_refund_mode	Die Zahlungsart für die Erstattung. Gültige Werte werden durch das prebuilt_components_return_refund_mode_of_return-Element definiert. Wenn keine Erstattung erforderlich ist, ist dieser Wert null.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
order_return_ticket_id	Ticket-ID für die eingereichte Rücksendung.	String

Informationen zur Erstattung bei Zahlung per Nachnahme senden

Über den prebuilt_components_return_refund:send_COD_refund_information-Webhook sendet die Komponente rückgabebezogene Zahlungsinformationen an einen Nutzer.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Auftrags-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 das prebuilt_components_channel_email_phone-Element definiert. Standardmäßig werden phone und email unterstützt.	String

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.