Le composant prédéfini "Offres et offres" vérifie si l'appelant est un utilisateur inscrit. Si l'utilisateur dispose d'un compte enregistré, le composant peut lui fournir des informations sur des offres qui lui sont spécifiques. L'utilisateur peut également obtenir des informations sur des offres et des offres générales, ou signaler des problèmes avec un code promotionnel spécifique. Ce composant utilise le composant prédéfini Collection alphanumérique pour collecter les codes promotionnels. Il utilise également des générateurs pour la synthèse post-appel, les questions fréquentes et les détails des offres.
Limites
En plus des limites courantes des composants prédéfinis, ce composant prédéfini présente les limites suivantes:
- Ce composant ne chiffre aucune donnée.
Exemples de boîtes de dialogue
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 boîtes de dialogue 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 offres spécifiques à un utilisateur et à caractère général
L'utilisateur final a déjà été authentifié. L'utilisateur demande ses dernières offres, et l'agent présente une liste d'offres spécifiques à l'utilisateur. L'utilisateur pose quelques 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, qui la 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 | |
| Me confirmez-vous que vous recherchez des offres ? Est-ce bien cela ? | |
| oui | |
| Voici les offres que nous avons trouvées pour vous: Offre 1: 5% de réduction sur des vêtements, utilisez le code APPARELS5, valable jusqu'au 28/03/2024. Offre 2: bénéficiez de 15% de remise sur vos courses en utilisant le code GROCERY500, valable jusqu'au 28/03/2024. Nous espérons que vous trouverez ces offres. Avez-vous des questions concernant des offres et des promotions auxquelles nous pouvons répondre pour vous ? |
|
| L'offre de produits alimentaires est-elle soumise à un montant minimal d'achat ? | |
| Oui, la valeur d'achat minimale est de 10 pour bénéficier de 15% de remise sur les courses. Le code GROCERY500 est valable jusqu'au 28/03/2024. Nous espérons pouvoir vous fournir les informations dont vous avez besoin. Avez-vous des questions concernant des offres et des promotions auxquelles nous pouvons répondre pour vous ? |
|
| Proposez-vous des offres pour des appareils électroniques ? | |
| Bien sûr ! Voici les détails de l'offre: Offre 1: profitez de 5% de remise sur les appareils électroniques, utilisez le code ELECTRIC5, valable jusqu'au 28/03/2024. Offre 2 : -15% sur les appareils électroniques en utilisant 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 concernant des offres et des promotions auxquelles nous pouvons répondre pour vous ? |
|
| Non, j'ai terminé | |
| Voulez-vous que les détails de l'offre soient partagés sur le numéro de mobile ou l'adresse e-mail que vous avez enregistré ? | |
| Non merci | |
| Merci de votre appel. |
Problème lié à un code promotionnel
L'utilisateur final a déjà été authentifié. L'utilisateur mentionne qu'il a 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 a un problème avec le code promotionnel et l'agent envoie une demande pour le signaler.
| 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 | |
| Vous recherchez des codes promotionnels. Est-ce bien cela ? | |
| oui | |
| Nous le regrettons. Pourriez-vous indiquer le code promotionnel que vous utilisez ? | |
| L'agent collecte le code promotionnel à l'aide du composant prédéfini de collecte alphanumérique. | |
| Le code APPARELS5 associé aux vêtements avait une valeur d'achat minimale de 100$ et valable jusqu'au 28/03/2024. Veuillez vous assurer que les conditions telles que le montant minimal d'achat sont remplies. Ces informations vous sont-elles utiles ? |
|
| 0 | |
| Veuillez préciser le problème que vous rencontrez. Vous pouvez dire, par exemple, que mon code promotionnel ne fonctionne pas ou que mon code ne fonctionne pas dans ma région. | |
| le code promotionnel ne fonctionne pas | |
| Nous vous confirmons que le problème de code promotionnel indiqué est que le code promotionnel ne fonctionne pas. Est-ce correct ? | |
| oui | |
| Nous avons envoyé une demande pour signaler votre problème. Merci de votre appel. |
Conventions de nommage
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes:
| Sélection | Format | Exemple |
|---|---|---|
| Flow | [Nom du composant] | Offres spéciales |
| 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 des paramètres 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 flux doivent être définis sur la page d'accueil du composant. Les paramètres de portée session peuvent être définis par un flux d'appel ou sur la page d'accueil 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 l'indicatif du pays, qui permet d'identifier l'utilisateur. | chaîne |
Ce composant prédéfini permet aux paramètres facultatifs suivants de configurer son comportement, 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 vous indiquez si l'utilisateur souhaite entendre les offres ou signaler un problème concernant un code promotionnel. La valeur par défaut est 2. |
entier |
| $flow.max_retry_offers_category | Spécifie le nombre de tentatives autorisées lorsque vous indiquez une catégorie pour laquelle les offres sont entendues. La valeur par défaut est 2. |
entier |
| $flow.max_retry_another_coupon_code | Spécifie le nombre de tentatives autorisées lorsque vous fournissez le code promotionnel spécifique avec lequel l'utilisateur rencontre un 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 vous indiquez le problème rencontré par l'utilisateur 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 lorsque vous indiquez un canal sur lequel 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é par le webhook get_coupon_code_details indiquant que le code promotionnel est valide. La valeur par défaut est "valid". |
chaîne |
| $flow.invalid_coupon_code_status | Spécifie la valeur du champ coupon_code_status renvoyé par le webhook get_coupon_code_details indiquant que le code promotionnel n'est pas valide. La valeur par défaut est "invalid". |
chaîne |
| $flow.expired_coupon_code_status | Spécifie la valeur du champ coupon_code_status renvoyé par le webhook get_coupon_code_details indiquant que le code promotionnel a expiré. La valeur par défaut est "expired". |
chaîne |
Pour configurer les paramètres d'entrée de ce composant, développez les instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Build (Compiler).
- Cliquez sur le composant importé dans la section Flux.
- Cliquez sur "Page d'accueil" dans la section Pages.
- Cliquez sur la route true (vraie) sur la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs Parameter Presets (Préréglages) si nécessaire.
- Cliquez sur Enregistrer.
Paramètres de sortie
Les paramètres de sortie sont des paramètres de session qui restent 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. | chaîne |
| transfer_reason | Ce paramètre indique la raison pour laquelle le flux a été interrompu, en cas d'échec. La valeur renvoyée est l'une des suivantes:agent: l'utilisateur final a demandé un agent humain à un moment donné au cours 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 les événements intégrés sans entrée.max_no_match: la conversation a atteint le nombre maximal de tentatives pour les événements sans correspondance. Consultez les événements intégrés sans correspondance.webhook_error: une erreur de webhook s'est produite. Consultez Événement intégré webhook.error. webhook_not_found: une URL de webhook est inaccessible. Consultez Événement intégré webhook.error.not-found. |
chaîne |
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ésumé post-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 gérer les questions fréquentes liées aux remises, aux ventes, aux achats et aux programmes de fidélité.
- Puis-je retourner des produits en promotion si je change d'avis ?
- Puis-je obtenir des échantillons gratuits ou des cadeaux pour l'achat de certains produits ?
- Proposez-vous des ajustements de prix si l'article que j'ai acheté est en promotion ultérieurement ?
- Y a-t-il une limite de temps pour utiliser 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 permet de fournir des détails sur des offres spécifiques à un utilisateur en fonction des informations fournies par le webhook get_offers_details.
Détails des offres et des offres
Le générateur Offers and deals details permet de fournir des détails sur des offres 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 offres spéciales
Le générateur Offers and deals FAQ permet de gérer les questions fréquentes liées aux offres.
- Existe-t-il des offres spéciales pour les nouveaux clients ?
- Comment être informé des offres à venir ?
- Existe-t-il des offres disponibles exclusivement en magasin ou en ligne ?
- À quelle fréquence les nouveaux accords sont-ils ajoutés à votre plate-forme ?
Questions fréquentes sur les remises et les codes promotionnels
Discount and promo code FAQ permet de gérer les questions fréquentes concernant 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 réduction 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 une configuration décrivant vos services externes Dialogflow. Consultez la section "Configurer des webhooks".
Configuration du 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.
Obtenir les détails des offres
Le webhook prebuilt_components_offers_and_deals:get_offers_details permet au composant de récupérer des informations sur les offres spécifiques aux utilisateurs et les offres générales.
Paramètres de requête API
Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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. | chaîne |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API et 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 sur le compte indiqué, utilisée pour envoyer les détails de l'offre. | chaîne |
| user_offer | Liste des détails de l'offre spécifique à l'utilisateur. Chaque élément de la liste représente une offre unique, avec des paires clé-valeur décrivant les 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 offre unique, qui respecte le même format que le champ user_offer. |
Liste (objet) |
Pour configurer le webhook "Obtenir les informations sur les offres" pour ce composant, développez 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:get_offers_details.
- Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 qu'il crée le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
- Cliquez sur Enregistrer.
Obtenir les détails du code promotionnel
Le webhook prebuilt_components_offers_and_deals:get_coupon_code_details permet au composant de 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 API
Les paramètres suivants sont fournis par le composant en tant qu'entrées dans la requête API.
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $flow.coupon_code | Code promotionnel permettant d'obtenir des informations. | chaîne |
| $session.params.phone_number | Numéro de téléphone associé au compte de l'utilisateur. | chaîne |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API et utilisés par le composant.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| offer_id | Identifiant de l'offre pour le code promotionnel. | chaîne |
| offer_category_name | Catégorie du code promotionnel. Les valeurs valides sont définies par l'entité prebuilt_components_offers_and_deals_category. |
chaîne |
| 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. |
chaîne |
| valid_until | Date limite de validité du code promotionnel, au format YYYY-MM-DD. |
chaîne |
| minimum_order_value | Montant minimal de commande pour le code promotionnel. | chaîne |
Pour configurer le webhook "Obtenir les détails du code promotionnel" pour ce composant, développez 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:get_coupon_code_details.
- Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 qu'il crée le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
- Cliquez sur Enregistrer.
Envoyer un message
Le webhook prebuilt_components_offers_and_deals:send_message permet au composant d'envoyer un message contenant les détails de l'offre au canal sélectionné de l'utilisateur.
Paramètres de requête API
Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. | chaîne |
| $flow.confirmation_channel | Canal pour lequel l'utilisateur a choisi de recevoir les détails de l'offre. Les valeurs valides sont définies par l'entité prebuilt_components_channel_email_phone. |
chaîne |
Pour configurer le webhook d'envoi de message pour ce composant, développez 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 indiquée dans le champ URL du webhook Dialogflow 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 qu'il crée le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
- Cliquez sur Enregistrer.
Envoyer une demande d'assistance
Le webhook prebuilt_components_offers_and_deals:raise_ticket permet au composant d'envoyer une demande d'assistance signalant un problème lié à un utilisateur avec un code promotionnel.
Paramètres de requête API
Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. | chaîne |
| $flow.coupon_code | Code promotionnel pour lequel l'utilisateur a signalé un problème. | chaîne |
| $flow.offer_id | Identifiant de l'offre associée au code promotionnel fourni. | chaîne |
| $flow.coupon_code_issue | Problème lié au code promotionnel fourni par l'utilisateur. | chaîne |
Pour configurer le webhook de demande d'assistance pour ce composant, développez la section correspondante 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 indiquée dans le champ URL du webhook Dialogflow 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 qu'il crée le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
- Cliquez sur Enregistrer.
Exhaustivité
Votre agent et ses webhooks doivent maintenant être configurés et prêts à être testés.