Vordefinierte Komponente „Angebote“

Die vorgefertigte Komponente für Angebote und Deals prüft, ob der Anrufer ein registrierter Nutzer ist. Wenn der Nutzer ein registriertes Konto hat, kann die Komponente Informationen zu nutzerspezifischen Angeboten und Deals bereitstellen. Außerdem können Nutzer Details zu allgemeinen Angeboten und Deals abrufen oder Probleme mit einem bestimmten Gutscheincode melden. In dieser Komponente wird die vorgefertigte Komponente Alphanumerische Sammlung verwendet, um Gutscheincodes zu erfassen. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf, FAQs und Angebotsdetails.

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.

Nutzerspezifische und allgemeine Angebote

Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach seinen neuesten Angeboten und der Kundenservicemitarbeiter präsentiert ihm eine Liste mit Angeboten, die speziell für ihn gelten. Der Nutzer stellt einige Fragen zu den Angeboten und bittet dann um Angebote in einer bestimmten Kategorie. Der Kundenservicemitarbeiter präsentiert die Liste der Angebote in der Kategorie. Der Kundenservicemitarbeiter bietet an, die Angebotsdetails an den Nutzer zu senden, der dies jedoch ablehnt.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Herzlich willkommen! Möchtest du unsere neuesten Angebote kennenlernen oder hast du Probleme mit einem bestimmten Gutscheincode?
Ich möchte die neuesten Angebote sehen
Sie suchen nach Angeboten. Ist das richtig?
Ja
Wir haben die folgenden Angebote für Sie gefunden:
Angebot 1: 5% Rabatt auf Bekleidung mit dem Code APPARELS5, gültig bis 28. März 2024.
Angebot 2: 15% Rabatt auf Lebensmittel mit dem Code GROCERY500, gültig bis 28. März 2024.

Wir hoffen, dass Ihnen diese Angebote gefallen. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es für das Angebot für Lebensmittel einen Mindestbestellwert?
Ja, für 15% Rabatt auf Lebensmittel ist ein Mindestbestellwert von 10 € erforderlich. Das Angebot kann mit dem Code GROCERY500 eingelöst werden und ist bis zum 28. März 2024 gültig.

Wir hoffen, Ihnen die gewünschten Informationen zukommen lassen zu können. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Haben Sie Angebote für Elektronik?
Natürlich! Hier sind die Angebotsdetails:
Angebot 1: 5% Rabatt auf Elektronik mit dem Code ELECTRIC5, gültig bis 28. März 2024.
Angebot 2: 15% Rabatt auf Elektronik mit dem Code ELECTRIC15, gültig bis 28. März 2024.

Wir hoffen, dass wir Ihnen die gewünschten Informationen zukommen lassen konnten. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Nein, ich bin fertig.
Sollen Angebotsdetails an Ihre registrierte Mobiltelefonnummer oder E-Mail-Adresse gesendet 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 gibt dem Nutzer Details zur Einlösung des Gutscheincodes. Der Nutzer bestätigt, dass er ein Problem mit dem Gutscheincode hat, und der Kundenservicemitarbeiter sendet ein Ticket, um das Problem zu melden.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Herzlich willkommen! Möchtest du unsere neuesten Angebote kennenlernen oder hast du Probleme mit einem bestimmten Gutscheincode?
Ich habe Probleme mit einem Gutscheincode
Sie suchen nach Gutscheincodes. Ist das richtig?
Ja
Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Können Sie mir den Gutscheincode nennen, den Sie verwenden?
Der Kundenservicemitarbeiter erfasst den Gutscheincode mithilfe der vordefinierten Komponente Alphanumerische Sammlung.
Der Angebotscode APPARELS5 für Bekleidung erfordert einen Mindestbestellwert von 100$ und ist bis zum 28. März 2024 gültig. Achten Sie darauf, dass die Bedingungen wie der Mindestbestellwert erfüllt sind.

Sind diese Informationen hilfreich für Sie?
no
Bitte geben Sie das Problem an, das aufgetreten ist. Du könntest beispielsweise sagen: „Mein Gutscheincode funktioniert nicht.“
Gutscheincode funktioniert nicht
Zur Bestätigung: Das angegebene Problem mit dem Gutscheincode ist, dass er nicht funktioniert. Ist das richtig?
Ja
Wir haben ein Ticket erstellt, um Ihr Problem zu melden. Vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

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

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

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_concern_type Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Nutzer auswählen möchte, ob er Angebote erhalten oder ein Problem mit einem Gutscheincode melden möchte. Der Standardwert ist 2. integer
$flow.max_retry_offers_category Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn eine Kategorie angegeben wird, für die Angebote angehört werden sollen. Der Standardwert ist 2. integer
$flow.max_retry_another_coupon_code Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Gutscheincode angegeben wird, 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 Wiederholungen an, wenn das Problem mit einem Gutscheincode angegeben wird. Der Standardwert ist 2. integer
$flow.max_retry_message_confirm_channel Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn ein Kanal angegeben wird, über den 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 und angibt, 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 und angibt, 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 und angibt, dass der Gutscheincode abgelaufen ist. Der Standardwert ist "expired". String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  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 Bereich Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben 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 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
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.

Zusammenfassung

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

Allgemeine FAQ

Der General FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Rabatten, Angeboten, Käufen und Treuepunkteprogrammen zu beantworten.

  • Kann ich Sonderangebotsprodukte zurückgeben, wenn ich meine Meinung ändere?
  • Erhalte ich beim Kauf bestimmter Produkte kostenlose Proben oder Geschenke?
  • Bieten Sie Preisanpassungen an, wenn der gekaufte Artikel später im Angebot ist?
  • Gibt es eine Frist für das Einlösen von Prämien im Treuepunkteprogramm?

Nutzerspezifische Angebotsdetails

Der User-specific offer details-Generator wird verwendet, um anhand der Informationen aus dem get_offers_details-webhook Details zu nutzerspezifischen Angeboten bereitzustellen.

Details zu Angeboten

Mit dem Offers and deals details-Generator werden Details zu allgemeinen Angeboten und Deals anhand der Informationen aus dem get_offers_details-webhook 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

Der Offers and deals FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Angeboten zu beantworten.

  • Gibt es spezielle Angebote für Neukunden?
  • Wie kann ich über anstehende Angebote informiert werden?
  • Gibt es Angebote, die nur im Geschäft oder online erhältlich sind?
  • Wie oft werden Ihrer Plattform neue Angebote hinzugefügt?

Häufig gestellte Fragen zu Rabatten und Gutscheincodes

Die 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 auf eine einzelne Bestellung anwenden?
  • Wie kann ich einen Rabattcode an der Kasse einlösen?
  • Was passiert, wenn ich beim Bezahlvorgang vergessen habe, einen Rabattcode anzuwenden?

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.

Angebotsdetails abrufen

Über den prebuilt_components_offers_and_deals:get_offers_details-Webhook ruft die Komponente Details zu nutzerspezifischen und allgemeinen Angeboten ab.

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 durch das prebuilt_components_offers_and_deals_category-Element definiert. Liste (String)
user_email Die für das angegebene Konto registrierte E-Mail-Adresse, über die Angebotsdetails gesendet werden. String
user_offer Liste der nutzerspezifischen Angebotsdetails. Jedes Element der Liste steht für ein einzelnes Angebot. Schlüssel/Wert-Paare beschreiben verschiedene Attribute des Angebots, 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 steht für ein einzelnes Angebot und entspricht dem Format des Felds user_offer. Liste (Objekt)

Maximieren Sie die Seite, um eine Anleitung zum Konfigurieren des Webhooks „Get offers details“ für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  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_offers_and_deals:get_offers_details“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Gutscheincode-Details abrufen

Über den prebuilt_components_offers_and_deals:get_coupon_code_details-Webhook ruft die Komponente Details zu einem bestimmten Gutscheincode ab, für den 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.coupon_code Gutscheincode, für den Details abgerufen werden sollen. String
$session.params.phone_number Die 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 durch das prebuilt_components_offers_and_deals_category-Element 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

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get coupon code details“ für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  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_offers_and_deals:get_coupon_code_details“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Nachricht senden

Über den prebuilt_components_offers_and_deals:send_message-Webhook sendet die Komponente eine Nachricht mit Angebotsdetails an den ausgewählten Kanal des Nutzers.

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.confirmation_channel Kanal, über den der Nutzer Angebotsdetails erhalten möchte. Gültige Werte werden durch das prebuilt_components_channel_email_phone-Element definiert. String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Nachricht senden“ für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  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_offers_and_deals:send_message“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Ticket erstellen

Der prebuilt_components_offers_and_deals:raise_ticket-Webhook wird von der Komponente verwendet, um ein Ticket mit einem Gutscheincode zu senden, in dem ein Nutzerproblem gemeldet wird.

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.coupon_code Gutscheincode, für den der Nutzer ein Problem gemeldet hat. String
$flow.offer_id Angebots-ID für den angegebenen Gutscheincode. String
$flow.coupon_code_issue Vom Nutzer angegebenes Problem mit dem Gutscheincode. String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks zum Erstellen von Tickets für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  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 „rebuilt_components_offers_and_deals:raise_ticket“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
  8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
  10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
  11. Klicken Sie auf Speichern.

Abgeschlossen

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