Le composant prédéfini des offres et des promotions vérifie si l'appelant est un utilisateur enregistré. Si l'utilisateur possède un compte enregistré, le composant peut fournir des informations sur les offres et les promotions spécifiques à l'utilisateur. L'utilisateur peut également obtenir des informations sur les offres et les promotions générales, ou signaler des problèmes liés à un code promotionnel spécifique. Ce composant utilise le composant prédéfini Collecte alphanumérique pour collecter les codes promotionnels. Le composant utilise également des générateurs pour résumer les appels, répondre aux questions fréquentes et fournir des informations sur les offres.
Limites
En plus des limites communes des composants prédéfinis, ce composant prédéfini présente les limites suivantes :
- Ce composant ne chiffre aucune donnée.
Exemples de dialogues
Les exemples de boîtes de dialogue suivants illustrent des scénarios courants gérés par ce composant prédéfini. Les exemples de dialogues illustrent le comportement lorsque le composant est appelé à l'aide de la téléphonie, ce qui déclenche l'intent d'accueil par défaut et la première réponse de l'agent au début de la conversation.
Offres et promotions générales et spécifiques aux utilisateurs
L'utilisateur final a déjà été authentifié. L'utilisateur demande ses dernières offres et l'agent lui présente une liste d'offres spécifiques. L'utilisateur pose des questions sur les offres, puis demande des offres dans une catégorie spécifique. L'agent présente la liste des offres de la catégorie. L'agent propose d'envoyer les détails de l'offre à l'utilisateur, mais celui-ci refuse.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bienvenue ! Souhaitez-vous découvrir nos dernières offres ou rencontrez-vous des problèmes avec un code promotionnel spécifique ? | |
| Je veux voir les dernières offres | |
| Pour confirmer, vous recherchez des offres. Est-ce bien cela ? | |
| oui | |
| Nous avons trouvé les offres suivantes pour vous. Voici les détails : Offre 1 : Bénéficiez de 5 % de remise sur les vêtements avec le code APPARELS5, valable jusqu'au 28/03/2024. Offre 2 : Bénéficiez de 15 % de remise sur les produits d'épicerie avec le code GROCERY500, valable jusqu'au 28/03/2024.8. Nous espérons que ces offres vous intéressent. Avez-vous des questions sur les offres ou les promotions auxquelles nous pouvons répondre ? |
|
| Existe-t-il un minimum d'achat pour l'offre sur les produits d'épicerie ? | |
| Oui, un minimum d'achat de 10 € est requis pour bénéficier de la remise de 15 % sur les produits d'épicerie. Pour profiter de cette offre, utilisez le code GROCERY500, valable jusqu'au 28/03/2024. Nous espérons pouvoir vous fournir les informations dont vous avez besoin. Avez-vous des questions sur les offres ou les promotions auxquelles nous pouvons répondre ? |
|
| Avez-vous des offres pour les appareils électroniques ? | |
| Bien sûr ! Voici les détails de l'offre : Offre 1 : Profitez de 5 % de remise sur les appareils électroniques avec le code ELECTRIC5, valable jusqu'au 28/03/2024. Offre 2 : Profitez de 15 % de remise sur les appareils électroniques avec le code ELECTRIC15, valable jusqu'au 28/03/2024. Nous espérons pouvoir vous fournir les informations dont vous avez besoin. Avez-vous des questions sur les offres ou les promotions auxquelles nous pouvons répondre ? |
|
| Non, j'ai terminé | |
| Souhaitez-vous que les détails de l'offre soient partagés sur votre mobile ou votre adresse e-mail enregistrés ? | |
| Non, merci | |
| Merci de votre appel. |
Problème lié à un code promotionnel
L'utilisateur final a déjà été authentifié. L'utilisateur indique qu'il rencontre un problème avec un code promotionnel. L'agent récupère le code promotionnel et fournit à l'utilisateur des informations sur son utilisation. L'utilisateur confirme qu'il rencontre un problème avec le code promotionnel et l'agent envoie une demande pour signaler le problème.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bienvenue ! Souhaitez-vous découvrir nos dernières offres ou rencontrez-vous des problèmes avec un code promotionnel spécifique ? | |
| Je rencontre des problèmes avec un code promotionnel | |
| Pour confirmer, vous recherchez des codes promotionnels. Est-ce bien cela ? | |
| oui | |
| Nous le regrettons. Pourriez-vous nous indiquer le code promotionnel que vous utilisez ? | |
| L'agent collecte le code promotionnel à l'aide du composant prédéfini Collecte alphanumérique. | |
| Le code promotionnel APPARELS5 associé aux vêtements nécessitait un montant d'achat minimum de 100$ et était valable jusqu'au 28/03/2024. Veuillez vous assurer que les conditions, telles que le montant d'achat minimum, sont respectées. Ces informations vous ont-elles été utiles ? |
|
| non | |
| Veuillez préciser le problème que vous rencontrez. Vous pouvez dire, par exemple, que votre code promotionnel ne fonctionne pas ou qu'il n'est pas valable dans votre région. | |
| Code promotionnel ne fonctionne pas | |
| Pour confirmer, le problème lié au code promotionnel fourni est que le code promotionnel ne fonctionne pas. Est-ce correct ? | |
| oui | |
| Nous avons créé une demande pour signaler votre problème. Merci de votre appel. |
Conventions d'attribution de noms
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes :
| Fonctionnalité | Format | Exemple |
|---|---|---|
| Flow | [Nom du composant] | Offres et promotions |
| Type d'entité | 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 |
Paramètres d'entrée
Les paramètres d'entrée sont utilisés pour configurer certains comportements du composant. Les paramètres seront utilisés par une ou plusieurs conditions dans le flux pour déterminer le comportement du composant. Les paramètres de portée de flux doivent être définis sur la page de démarrage du composant. Les paramètres de portée session peuvent être définis par un flux d'appel ou sur la page de démarrage de ce composant.
Ce composant prédéfini accepte les paramètres d'entrée suivants :
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $session.params.phone_number | (Facultatif) Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour identifier l'utilisateur. | string |
Ce composant prédéfini permet aux paramètres facultatifs suivants de configurer le comportement du composant, y compris les nouvelles tentatives.
| Nom du paramètre | Description | Format |
|---|---|---|
| $flow.max_retry_concern_type | Spécifie le nombre de tentatives autorisées lorsque l'utilisateur choisit d'entendre des offres ou de signaler un problème avec un code promotionnel. La valeur par défaut est 2. |
entier |
| $flow.max_retry_offers_category | Spécifie le nombre de tentatives autorisées lors de la fourniture d'une catégorie pour entendre les offres. La valeur par défaut est 2. |
entier |
| $flow.max_retry_another_coupon_code | Spécifie le nombre de tentatives autorisées lorsque l'utilisateur fournit le code promotionnel spécifique qui pose problème. La valeur par défaut est 2. |
entier |
| $flow.max_retry_coupon_code_issue_counter | Spécifie le nombre de tentatives autorisées lorsque l'utilisateur indique le problème qu'il rencontre avec un code promotionnel. La valeur par défaut est 2. |
entier |
| $flow.max_retry_message_confirm_channel | Spécifie le nombre de tentatives autorisées lors de la fourniture d'un canal pour recevoir les détails de l'offre. La valeur par défaut est 2. |
entier |
| $flow.valid_coupon_code_status | Spécifie la valeur du champ coupon_code_status renvoyée par le webhook get_coupon_code_details indiquant que le code promotionnel est valide. La valeur par défaut est "valid". |
string |
| $flow.invalid_coupon_code_status | Spécifie la valeur du champ coupon_code_status renvoyée par le webhook get_coupon_code_details indiquant que le code promotionnel n'est pas valide. La valeur par défaut est "invalid". |
string |
| $flow.expired_coupon_code_status | Spécifie la valeur du champ coupon_code_status renvoyée par le webhook get_coupon_code_details, indiquant que le code promotionnel a expiré. La valeur par défaut est "expired". |
string |
Pour configurer les paramètres d'entrée de ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Build (Créer).
- Cliquez sur le composant importé dans la section Flux.
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vrai) sur la page de démarrage.
- Dans la fenêtre "Route", modifiez les valeurs de Parameter Presets (Préréglages des paramètres) si nécessaire.
- Cliquez sur Enregistrer.
Paramètres de sortie
Les paramètres de sortie sont des paramètres de session qui resteront actifs après la fermeture du composant. Ces paramètres contiennent des informations importantes collectées par le composant. Ce composant prédéfini fournit des valeurs pour les paramètres de sortie suivants :
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| phone_number | Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour l'identifier. | string |
| transfer_reason | Ce paramètre indique la raison pour laquelle le flux s'est arrêté, s'il n'a pas abouti. La valeur renvoyée est l'une des suivantes :agent : l'utilisateur final a demandé à parler à un agent humain à un moment donné de la conversation.denial_of_information : l'utilisateur final a refusé de partager les informations demandées par le composant.max_no_input : la conversation a atteint le nombre maximal de tentatives pour les événements sans saisie. Consultez Événements intégrés sans saisie.max_no_match : la conversation a atteint le nombre maximal de tentatives pour les événements de non-correspondance. Consultez Événements intégrés "aucune correspondance".webhook_error : une erreur de webhook s'est produite. Consultez Événement intégré webhook.error. webhook_not_found : une URL de webhook était inaccessible. Consultez l'événement intégré webhook.error.not-found. |
string |
Générateurs
Ce composant utilise des générateurs pour activer des parties spécifiques de la conversation.
Synthèse
Le générateur Summarization permet de générer un récapitulatif après appel décrivant la conversation gérée par le composant.
Questions fréquentes générales
Le générateur General FAQ permet de répondre aux questions fréquentes concernant les remises, les promotions, les achats et les programmes de fidélité.
- Puis-je retourner des produits soldés si je change d'avis ?
- Puis-je recevoir des échantillons ou des cadeaux sans frais pour l'achat de certains produits ?
- Proposez-vous des ajustements de prix si l'article que j'ai acheté est soldé par la suite ?
- Existe-t-il une limite de temps pour échanger les récompenses du programme de fidélité ?
Détails de l'offre spécifiques à l'utilisateur
Le générateur User-specific offer details est utilisé pour fournir des informations sur les offres spécifiques aux utilisateurs en fonction des informations fournies par le webhook get_offers_details.
Détails des offres et des promotions
Le générateur Offers and deals details est utilisé pour fournir des informations sur les offres et les promotions générales en fonction des informations fournies par le webhook get_offers_details.
L'utilisateur peut poser des questions sur les offres d'une catégorie spécifique ou demander plus de détails sur des offres spécifiques.
Questions fréquentes sur les offres et les promotions
Le générateur Offers and deals FAQ est utilisé pour répondre aux questions fréquentes sur les offres et les promotions.
- Des offres spéciales sont-elles proposées aux nouveaux clients ?
- Comment puis-je être informé des prochaines offres ?
- Existe-t-il des offres disponibles exclusivement en magasin ou en ligne ?
- À quelle fréquence de nouvelles offres sont-elles ajoutées à votre plate-forme ?
Questions fréquentes sur les remises et les codes promotionnels
Le Discount and promo code FAQ permet de répondre aux questions fréquentes sur les remises et les codes promotionnels.
- Puis-je utiliser un code de réduction plusieurs fois ?
- Puis-je utiliser plusieurs remises sur une même commande ?
- Comment utiliser un code de remise lors du règlement ?
- Que faire si j'ai oublié d'appliquer un code de réduction lors du règlement ?
Configuration de base
Pour configurer ce composant prédéfini :
- Importez le composant prédéfini.
- Configurez les webhooks flexibles fournis avec la configuration décrivant vos services externes. Pour en savoir plus, consultez la section sur la configuration des webhooks.
Configurer un webhook
Pour utiliser ce composant, vous devez configurer les webhooks flexibles inclus afin de récupérer les informations nécessaires à partir de vos services externes.
Afficher les détails des offres
Le webhook prebuilt_components_offers_and_deals:get_offers_details est utilisé par le composant pour récupérer des informations sur les offres spécifiques aux utilisateurs et générales.
Paramètres de requête de l'API
Les paramètres suivants sont fournis par le composant en tant qu'entrées de la requête API.
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $session.params.phone_number | Numéro de téléphone pour lequel récupérer les détails de l'offre. | string |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour être utilisés par le composant.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| active_category | Liste des catégories d'offres disponibles pour l'utilisateur. Les valeurs valides sont définies par l'entité prebuilt_components_offers_and_deals_category. |
Liste (chaîne) |
| user_email | Adresse e-mail enregistrée pour le compte fourni, utilisée pour envoyer les détails de l'offre. | string |
| user_offer | Liste des détails de l'offre spécifiques à l'utilisateur. Chaque élément de la liste représente une offre unique, avec des paires clé/valeur décrivant différents attributs de l'offre, par exemple {"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 (objet) |
| all_offers | Liste des détails généraux de l'offre. Chaque élément de la liste représente une seule offre, suivant le même format que le champ user_offer. |
Liste (objet) |
Pour configurer le webhook "Obtenir les détails des offres" pour ce composant, développez les instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook prebuilt_components_offers_and_deals:get_offers_details.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont nécessaires au composant pour accéder aux valeurs des champs renvoyés.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Obtenir les détails d'un code promotionnel
Le webhook prebuilt_components_offers_and_deals:get_coupon_code_details est utilisé par le composant pour récupérer des informations sur un code promotionnel spécifique pour lequel un utilisateur a signalé des problèmes.
Paramètres de requête de l'API
Les paramètres suivants sont fournis par le composant en tant qu'entrées de la requête API.
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $flow.coupon_code | Code du bon de réduction pour lequel récupérer les détails. | string |
| $session.params.phone_number | Numéro de téléphone associé au compte de l'utilisateur. | string |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour être utilisés par le composant.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| offer_id | ID de l'offre pour le code promotionnel. | string |
| offer_category_name | Catégorie du code promotionnel. Les valeurs valides sont définies par l'entité prebuilt_components_offers_and_deals_category. |
string |
| coupon_code_status | État du code promotionnel. Les valeurs valides sont définies par les paramètres d'entrée $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status et $flow.valid_coupon_code_status. |
string |
| valid_until | Date de validité du code promotionnel, au format YYYY-MM-DD. |
string |
| minimum_order_value | Montant minimal de commande pour le code promotionnel. | string |
Pour configurer le webhook "Obtenir les détails du code promotionnel; pour ce composant, développez les instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook prebuilt_components_offers_and_deals:get_coupon_code_details.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont nécessaires au composant pour accéder aux valeurs des champs renvoyés.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Envoyer un message
Le webhook prebuilt_components_offers_and_deals:send_message est utilisé par le composant pour envoyer un message contenant les détails de l'offre au canal sélectionné par l'utilisateur.
Paramètres de requête de l'API
Les paramètres suivants sont fournis par le composant en tant qu'entrées de la requête API.
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $session.params.phone_number | Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour l'identifier. | string |
| $flow.confirmation_channel | Canal sélectionné par l'utilisateur pour recevoir les détails de l'offre. Les valeurs valides sont définies par l'entité prebuilt_components_channel_email_phone. |
string |
Pour configurer le webhook "Envoyer un message" pour ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook prebuilt_components_offers_and_deals:send_message.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont nécessaires au composant pour accéder aux valeurs des champs renvoyés.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Signaler un problème
Le webhook prebuilt_components_offers_and_deals:raise_ticket est utilisé par le composant pour envoyer une demande signalant un problème d'utilisateur avec un code promotionnel.
Paramètres de requête de l'API
Les paramètres suivants sont fournis par le composant en tant qu'entrées de la requête API.
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $session.params.phone_number | Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour l'identifier. | string |
| $flow.coupon_code | Code du bon de réduction pour lequel l'utilisateur a signalé un problème. | string |
| $flow.offer_id | ID de l'offre pour le code promotionnel fourni. | string |
| $flow.coupon_code_issue | Problème rencontré par l'utilisateur avec le code promotionnel. | string |
Pour configurer le webhook "Raise ticket" (Créer une demande) pour ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook rebuilt_components_offers_and_deals:raise_ticket.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont nécessaires au composant pour accéder aux valeurs des champs renvoyés.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Votre agent et ses webhook devraient maintenant être configurés et prêts à être testés.