Vordefinierte Komponente für Angebote und Deals

Die vorgefertigte Komponente für Angebote und Deals prüft, ob der Anrufer ein registrierter Nutzer ist. Wenn der Nutzer eine registrierte Konto enthält, kann die Komponente Informationen zu nutzerspezifischen Angeboten Angebote. Der Nutzer kann auch Informationen zu allgemeinen Angeboten und Deals abrufen oder Berichte dazu erstellen. Probleme mit einem bestimmten Gutscheincode auftreten. 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, für diese vordefinierte Komponente gelten 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 Beispieldialogfelder zeigen das Verhalten, wenn die Komponente wird per Telefonie aufgerufen, wodurch der Standard-Begrüßungs-Intent und der erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.

Nutzerspezifische und allgemeine Angebote

Der Endnutzer wurde bereits authentifiziert. Die nutzende Person fragt nach ihren neuesten Angeboten. und der Agent präsentiert eine Liste mit Angeboten, die sich speziell auf den Nutzer beziehen. Der Nutzer stellt einige Fragen zu den Angeboten und bittet dann um Angebote in einer bestimmten Kategorie. Die stellt der Kundenservicemitarbeiter die Liste der Angebote in der Kategorie bereit. Der Kundenservicemitarbeiter bietet an, und der Nutzer lehnt ab.

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
Zur Bestätigung: 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 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.
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 holt den Gutscheincode ein und stellt Nutzer mit Details zur Einlösung des Gutscheincodes. Die Nutzenden bestätigen, dass sie Probleme mit dem Gutscheincode haben und der Kundenservicemitarbeiter ein Ticket an melden Sie das Problem.

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 bitte 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 kannst beispielsweise angeben, 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?
Ja
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:

Funktion Format Beispiel
Ablauf [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. Auf Sitzungsebene Parameter können entweder von einem aufrufenden Ablauf oder beim Start Seite dieser Komponente.

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 folgende optionale Parameter konfiguriert werden: das Verhalten der Komponente, einschließlich Wiederholungsversuchen.

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 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, 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, der 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 Build aus.
  5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
  6. Klicken Sie im Abschnitt Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Parametervoreinstellungen nach Bedarf.
  9. Klicken Sie auf Speichern.

Ausgabeparameter

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

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 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: Bei der Unterhaltung wurde die maximale Anzahl von Wiederholungen für No-Input-Ereignisse erreicht. Siehe Integrierte Ereignisse ohne Eingabe.

max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung.

webhook_error: Es ist ein Webhook-Fehler aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“.

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 ermöglichen.

Zusammenfassung

Mit dem Generator Summarization wird nach dem Anruf eine Zusammenfassung die von der Komponente abgewickelt wird.

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 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 nutzerspezifische Angebote auf Grundlage der von der get_offers_details zur Verfügung gestellten Informationen Webhook.

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 Sonderangebote für Neukunden?
  • Wie kann ich über anstehende Angebote informiert werden?
  • Gibt es Angebote ausschließlich im Geschäft oder online?
  • Wie oft werden deiner Plattform neue Angebote hinzugefügt?

FAQs 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 vergessen habe, an der Kasse einen Rabattcode einzulösen?

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte Komponente ein:

  1. Importieren Sie die vordefinierte Komponente.
  2. Konfigurieren Sie die flexible Webhooks mit Konfiguration, die Ihre externen Dienste beschreibt, siehe Webhook einrichten.

Webhook-Einrichtung

Zur Verwendung dieser Komponente müssen Sie die in flexiblen Webhooks zum Abrufen Informationen von Ihren externen Diensten benötigt.

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 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 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 gewünschte Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Details zum Gutscheincode erhalten

Ü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

Wenn Sie den Webhook „Gutscheincodedetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung 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 gewünschte Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  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 von der Entität prebuilt_components_channel_email_phone 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 Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Ticket erhöhen

Der prebuilt_components_offers_and_deals:raise_ticket-Webhook wird von der Komponente verwendet, um ein Ticket mit einem Gutscheincode zu erstellen, 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, bei dem 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

Zum Konfigurieren des Webhook-Webhooks für diese Komponente maximieren Sie das Fenster, um die Anleitung 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 Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
  8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
  9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
  10. Prüfen und aktualisieren Sie nach Bedarf die Einstellungen für die Authentifizierung.
  11. Klicken Sie auf Speichern.

Abgeschlossen

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