Vordefinierte Komponente für Angebote und Deals

Die vordefinierte Komponente für Angebote und Deals prüft, ob der Aufrufer ein registrierter Nutzer ist. Wenn der Nutzer ein registriertes Konto hat, kann die Komponente Informationen zu nutzerspezifischen Angeboten liefern. Der Nutzer kann auch Details zu allgemeinen Angeboten und Deals abrufen oder Probleme mit einem bestimmten Gutscheincode melden. Diese Komponente verwendet die vordefinierte Komponente alphanumerische Sammlung zum Erfassen von Gutscheincodes. Die Komponente verwendet außerdem Generatoren für die Zusammenfassung nach dem Anruf, für FAQs und Angebotsdetails.

Beschränkungen

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

• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialogfelder zeigen 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.

Nutzerspezifische und allgemeine Angebote und Deals

Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach seinen neuesten Angeboten und der Agent zeigt eine Liste mit Angeboten an, die speziell auf den Nutzer zugeschnitten sind. Der Nutzer stellt einige Fragen zu den Angeboten und fragt dann in einer bestimmten Kategorie nach Angeboten. Der Agent zeigt die Liste der Angebote in der Kategorie an. Der Agent bietet an, die Angebotsdetails an den Nutzer zu senden, und der Nutzer lehnt ab.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Herzlich willkommen! Möchten Sie sich unsere neuesten Angebote ansehen oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich möchte die neuesten Angebote sehen
	Zur Bestätigung: Sie suchen nach Angeboten. Ist das richtig?
yes
	Wir haben die folgenden Angebote für dich gefunden. Hier sind die Details: Angebot 1: 5% Rabatt auf Bekleidung mit dem Code APPARELS5, gültig bis 28.03.2024. Angebot 2: 15% Rabatt auf Lebensmittel mit dem Code GROCERY500; gültig bis 28.03.2024. Ich hoffe, diese Angebote sind interessant für dich. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es einen Mindestbestellwert für das Lebensmittelangebot?
	Ja, für den 15 %-Rabatt auf Lebensmittel muss ein Mindestbestellwert von 10 % eingehalten werden. Nutze den Code GROCERY500, um dieses Angebot einzulösen. Das Angebot gilt bis zum 28.03.2024. Wir hoffen, dir alles Wichtige zu geben. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es Angebote für Elektronik?
	Natürlich! Hier die Angebotsdetails: Angebot 1: 5% Rabatt auf Elektronikartikel mit dem Code ELECTRIC5, gültig bis 28.03.2024. Angebot 2: Mit dem Code ELECTRIC15 erhältst du 15% Rabatt auf Elektronikartikel. Der Code gilt bis zum 28.03.2024. Wir können dir gerne alles mitteilen, was du brauchst. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Nein, ich bin fertig.
	Möchten Sie, dass Angebotsdetails über Ihr registriertes Smartphone oder Ihre E-Mail-Adresse geteilt werden?
Nein danke
	Vielen Dank für Ihren Anruf.

Problem mit einem Gutscheincode

Der Endnutzer wurde bereits authentifiziert. Der Nutzer erwähnt, dass er ein Problem mit einem Gutscheincode hat. Der Kundenservicemitarbeiter erfasst den Gutscheincode und informiert den Nutzer über die Einlösung des Gutscheincodes. Der Nutzer bestätigt, dass er ein Problem mit dem Gutscheincode hat, und der Kundenservicemitarbeiter reicht ein Ticket ein, um das Problem zu melden.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Herzlich willkommen! Möchten Sie sich unsere neuesten Angebote ansehen oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich habe Probleme mit einem Gutscheincode
	Zur Bestätigung: Sie suchen nach Gutscheincodes. Ist das richtig?
yes
	Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Bitte teilen Sie uns den verwendeten Gutscheincode mit.
	Kundenservicemitarbeiter erfasst den Gutscheincode mithilfe der vordefinierten Komponente für die alphanumerische Erfassung
	Der Angebotscode APPARELS5 für Bekleidung erforderte einen Mindestbestellwert von 100$ und ist bis zum 28.03.2024 gültig. Bitte achten Sie darauf, dass die Bedingungen wie die Mindestabnahmemenge erfüllt sind. Sind diese Informationen hilfreich für Sie?
no
	Beschreiben Sie das auftretende Problem. Du kannst beispielsweise sagen, dass mein Gutscheincode oder der Code in meiner Region nicht funktioniert.
Gutscheincode funktioniert nicht
	Das angegebene Problem mit dem Gutscheincode ist: Der Gutscheincode funktioniert nicht. Ist das richtig?
yes
	Wir haben ein Ticket erstellt, um Ihr Problem zu melden. Vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:

Feature	Format	Beispiel
Flow	[Komponentenname]	Angebote
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_offers_and_deals_category
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_offers_and_deals:get_offers_details

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 festzulegen. Parameter für den Datenfluss 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) Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird.	String

Mit dieser vordefinierten Komponente können Sie mit den folgenden optionalen Parametern das Verhalten der Komponente konfigurieren, einschließlich Wiederholungen.

Parametername	Beschreibung	Format
$flow.max_retry_concern_type	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ausgewählt wird, ob der Nutzer Angebote erhalten oder ein Problem mit einem Gutscheincode melden möchte. Der Standardwert ist 2.	integer
$flow.max_retry_offers_category	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine Kategorie angegeben wird, für die Angebote angesagt werden sollen. Der Standardwert ist 2.	integer
$flow.max_retry_another_coupon_code	Gibt die Anzahl der zulässigen Wiederholungsversuche bei der Angabe des Gutscheincodes an, mit dem der Nutzer ein Problem hat. Der Standardwert ist 2.	integer
$flow.max_retry_coupon_code_issue_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Problem des Nutzers mit einem Gutscheincode angegeben wird. Der Standardwert ist 2.	integer
$flow.max_retry_message_confirm_channel	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Angeben eines Kanals an, zu dem Angebotsdetails empfangen werden sollen. Der Standardwert ist 2.	integer
$flow.valid_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, das vom get_coupon_code_details-Webhook zurückgegeben wird, um anzugeben, dass der Gutscheincode gültig ist. Der Standardwert ist "valid".	String
$flow.invalid_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, das vom get_coupon_code_details-Webhook zurückgegeben wird, um anzugeben, dass der Gutscheincode ungültig ist. Der Standardwert ist "invalid".	String
$flow.expired_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, das vom get_coupon_code_details-Webhook zurückgegeben wird, um anzugeben, dass der Gutscheincode abgelaufen ist. Der Standardwert ist "expired".	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 stellt Werte für die folgenden Ausgabeparameter bereit:

Parametername	Beschreibung	Ausgabeformat
phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String
transfer_reason	Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden: agent: Der Endnutzer hat irgendwann während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt. max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Siehe Integrierte Ereignisse ohne Eingabe. max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Siehe Integrierte Ereignisse ohne Übereinstimmung. webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe webhook.error built-in event. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event.	String

Generatoren

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

Zusammenfassung

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

Allgemeine FAQ

Der General FAQ-Generator wird für die Beantwortung häufig gestellter Fragen zu Rabatten, Verkäufen, Käufen und Treuepunkteprogrammen verwendet.

• Kann ich Sonderangebotsprodukte zurückgeben, wenn ich meine Meinung ändere?
• Kann ich bei bestimmten Produktkäufen kostenlose Proben oder Geschenke erhalten?
• Bieten Sie Preisanpassungen an, wenn der gekaufte Artikel später im Angebot ist?
• Gibt es ein Zeitlimit für das Einlösen von Prämien aus dem Treuepunkteprogramm?

Nutzerspezifische Angebotsdetails

Der User-specific offer details-Generator wird verwendet, um Details zu nutzerspezifischen Angeboten anhand der vom get_offers_details-Webhook bereitgestellten Informationen bereitzustellen.

Angebots- und Angebotsdetails

Mit dem Offers and deals details-Generator werden Details zu allgemeinen Angeboten anhand der vom get_offers_details-Webhook bereitgestellten Informationen bereitgestellt. Der Nutzer kann nach Angeboten in einer bestimmten Kategorie fragen oder nach weiteren Details zu bestimmten Angeboten fragen.

Häufig gestellte Fragen zu Angeboten und Deals

Mit dem Offers and deals FAQ-Generator werden häufig gestellte Fragen zu Angeboten und Deals beantwortet.

• Gibt es Sonderangebote für Neukunden?
• Wie werde ich über anstehende Angebote informiert?
• Gibt es Angebote ausschließlich im Geschäft oder online?
• Wie oft werden deiner Plattform neue Angebote hinzugefügt?

FAQs zu Rabatten und Gutscheincodes

Discount and promo code FAQ wird verwendet, um häufig gestellte Fragen zu Rabatten und Gutscheincodes zu beantworten.

• Kann ich einen Rabattcode mehrmals verwenden?
• Kann ich mehrere Rabatte für eine einzelne Bestellung verwenden?
• Wie kann ich an der Kasse einen Rabattcode einlösen?
• Was passiert, wenn ich vergessen habe, an der Kasse einen Rabattcode einzulösen?

Grundlegende Einstellungen

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 Dialogflow-Dienste beschreibt. Siehe Webhook-Einrichtung.

Webhook-Einrichtung

Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die benötigten Informationen von Ihren externen Diensten abgerufen werden.

Angebotsdetails abrufen

Der Webhook prebuilt_components_offers_and_deals:get_offers_details wird von der Komponente verwendet, um Details zu nutzerspezifischen und allgemeinen Angeboten abzurufen.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Telefonnummer, für die Angebotsdetails abgerufen werden sollen.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
active_category	Liste der Angebotskategorien, die für den Nutzer verfügbar sind. Gültige Werte werden von der Entität prebuilt_components_offers_and_deals_category definiert.	Liste (String)
user_email	Für das angegebene Konto registrierte E-Mail-Adresse, über die die Angebotsdetails gesendet werden.	String
user_offer	Liste der nutzerspezifischen Angebotsdetails. Jedes Element der Liste stellt ein einzelnes Angebot mit Schlüssel/Wert-Paaren dar, die verschiedene Attribute des Angebots beschreiben, z. B. {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}.	Liste (Objekt)
all_offers	Liste der allgemeinen Angebotsdetails. Jedes Element der Liste stellt ein einzelnes Angebot dar. Das Format entspricht dem Format des Felds user_offer.	Liste (Objekt)

Details zum Gutscheincode erhalten

Der Webhook prebuilt_components_offers_and_deals:get_coupon_code_details wird von der Komponente verwendet, um Details zu einem bestimmten Gutscheincode abzurufen, mit dem ein Nutzer Probleme gemeldet hat.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$flow.gutscheincode	Gutscheincode, für den Details abgerufen werden sollen.	String
$session.params.phone_number	Mit dem Konto des Nutzers verknüpfte Telefonnummer.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
offer_id	Angebots-ID für den Gutscheincode.	String
offer_category_name	Kategorie für den Gutscheincode. Gültige Werte werden von der Entität prebuilt_components_offers_and_deals_category definiert.	String
coupon_code_status	Status des Gutscheincodes. Gültige Werte werden durch die Eingabeparameter $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status und $flow.valid_coupon_code_status definiert.	String
valid_until	Datum, bis zu dem der Gutscheincode gültig ist, im Format YYYY-MM-DD.	String
minimum_order_value	Mindestbestellwert für den Gutscheincode.	String

Nachricht senden

Der Webhook prebuilt_components_offers_and_deals:send_message wird von der Komponente verwendet, um eine Nachricht mit Angebotsdetails an den vom Nutzer ausgewählten Kanal 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	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String
$flow.confirmation_channel	Kanal, über den der Nutzer Angebotsdetails erhalten möchte. Gültige Werte werden von der Entität prebuilt_components_channel_email_phone definiert.	String

Ticket erhöhen

Der Webhook prebuilt_components_offers_and_deals:raise_ticket wird von der Komponente verwendet, um ein Ticket zu senden, das ein Nutzerproblem mit einem Gutscheincode meldet.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String
$flow.gutscheincode	Gutscheincode, bei dem der Nutzer ein Problem gemeldet hat.	String
$flow.offer_id	Angebots-ID für den angegebenen Gutscheincode.	String
$flow.gutscheincode_problem	Vom Nutzer angegebenes Problem mit dem Gutscheincode.	String

Fertig

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