Offres et bonnes affaires composant prédéfini vérifie si l'appelant est un utilisateur enregistré. Si l'utilisateur dispose d'un compte le composant peut fournir des informations sur les offres des accords. L'utilisateur peut également obtenir des détails sur les offres générales et les offres spéciales, ou signaler les problèmes liés à un code promotionnel spécifique. Ce composant utilise la classe Collection alphanumérique un composant prédéfini permettant de collecter des codes de réduction. Le composant utilise également des générateurs pour la synthèse post-appel, les questions fréquentes et les informations sur l'offre.
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îte de dialogue suivants illustrent des scénarios courants gérés par ce un 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 promotions spécifiques à l'utilisateur et générales
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 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 et celui-ci refuse l'offre.
| 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 | |
| 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 en utilisant le code APPARELS5. Valable jusqu'au 28/03/2024. Offre 2 : Bénéficiez de 15 % de remise sur les produits alimentaires en utilisant le code GROCERY500. Valable jusqu'au 28/03/2024.8. Nous espérons que ces offres vous intéresseront. Avez-vous des questions sur les offres ou les promotions ? |
|
| Existe-t-il un montant minimal d'achat pour l'offre d'épicerie ? | |
| Oui, la valeur d'achat minimale est de 10 % pour bénéficier de la remise de 15 % sur les courses. Utilisez le code GROCERY500 pour profiter de cette offre, valable jusqu'au 28/03/2024. Nous espérons être en mesure de vous fournir les informations dont vous avez besoin. Avez-vous des questions sur des offres auxquelles nous pouvons répondre pour vous ? |
|
| Avez-vous des offres pour des appareils électroniques ? | |
| Bien sûr ! Voici les détails de l'offre : Offre 1 : Bénéficiez de 5 % de remise sur les appareils électroniques avec le code ELECTRIC5, valable jusqu'au 28/03/2024. Offre 2 : Bénéficiez de 15 % de remise sur les appareils électroniques avec le code ELECTRIC15, valable jusqu'au 28/03/2024. Nous espérons avoir répondu à vos questions. Avez-vous des questions sur des offres auxquelles nous pouvons répondre pour vous ? |
|
| Non, j'ai terminé | |
| Voulez-vous que les détails de l'offre soient partagés sur votre téléphone 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 a un problème avec un code promotionnel. L'agent collecte le code promotionnel et fournit avec des informations détaillées sur l'utilisation du code promotionnel. L’utilisateur confirme qu’il si vous rencontrez un problème avec le code promotionnel et que l'agent envoie une demande à 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 | |
| Me confirmez-vous que vous recherchez des codes promotionnels ? Est-ce bien cela ? | |
| oui | |
| Nous le regrettons. Pourriez-vous m'indiquer le code promotionnel que vous utilisez ? | |
| L'agent collecte le code promotionnel à l'aide du composant prédéfini de la collection alphanumérique. | |
| Le code promotionnel APPARELS5 associé aux vêtements nécessite un montant minimal d'achat de 100$ et est valable jusqu'au 28/03/2024. Veuillez vous assurer que les conditions telles que l'obligation d'achat minimale sont remplies. Ces informations vous sont-elles utiles ? |
|
| non | |
| Veuillez indiquer le problème que vous rencontrez. Vous pouvez par exemple indiquer que mon code promotionnel ne fonctionne pas dans ma région. | |
| le code promotionnel ne fonctionne pas | |
| Pour confirmer, le problème lié au code promotionnel indiqué est le suivant : le code promotionnel ne fonctionne pas. Est-ce correct ? | |
| oui | |
| Nous avons envoyé une demande d'assistance 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:
| Caractéristique | Format | Exemple |
|---|---|---|
| Flux | [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 des paramètres utilisés pour configurer certains comportements de le composant. Les paramètres seront utilisés par une ou plusieurs conditions du flux pour déterminer le comportement du composant. Les paramètres à l'échelle du flux doivent être défini sur la page d'accueil du composant. Avec une portée session les paramètres peuvent être définis par un flux d'appel ou au début 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 l'identifier. | chaîne |
Ce composant prédéfini permet de configurer les paramètres facultatifs suivants 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 pour indiquer si l'utilisateur souhaite entendre les offres ou 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 lorsque vous indiquez une catégorie pour laquelle vous souhaitez recevoir des offres. La valeur par défaut est 2. |
entier |
| $flow.max_retry_another_coupon_code | Indique le nombre de nouvelles tentatives autorisées lorsque vous fournissez le code promotionnel spécifique qui pose problème à l'utilisateur. La valeur par défaut est 2. |
entier |
| $flow.max_retry_coupon_code_issue_counter | Spécifie le nombre de tentatives autorisées lors de la transmission du 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 fournissez 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". |
chaîne |
| $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". |
chaîne |
| $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". |
chaîne |
Pour configurer les paramètres d'entrée de ce composant, développez la section pour obtenir les instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Build (Compilation).
- 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 dans la page d'accueil.
- Dans la fenêtre "Itinéraire", modifiez les valeurs des préréglages de paramètres 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. le composant. Ces paramètres contiennent des informations importantes collectées par la . Ce composant prédéfini fournit des valeurs pour la sortie suivante : paramètres:
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| phone_number | Numéro de téléphone local de l'utilisateur, sans code pays, utilisé pour l'identifier. | chaîne |
| transfer_reason | Ce paramètre indique la raison de l'arrêt du flux, s'il n'a pas réussi. 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 entrée. Consultez la section Événements intégrés sans entrée.max_no_match : la conversation a atteint le nombre maximal de tentatives pour les événements de non-correspondance. Consultez les événements intégrés sans correspondance.webhook_error: une erreur de webhook s'est produite. Consultez l'événement intégré webhook.error. webhook_not_found: une URL de webhook est inaccessible. Consultez l'é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 concernant
en passant par les remises, les ventes,
les achats et les programmes de fidélité.
- Puis-je retourner des produits en promotion si je change d'avis ?
- Puis-je recevoir des échantillons ou des cadeaux gratuits avec l'achat de certains produits ?
- Proposez-vous des ajustements de prix si l'article que j'ai acheté est mis en solde plus tard ?
- Les récompenses du programme de fidélité sont-elles limitées dans le temps ?
Détails de l'offre spécifique à l'utilisateur
Le générateur User-specific offer details permet de fournir des informations
offres spécifiques à chaque utilisateur, en fonction des informations fournies par le get_offers_details
webhook.
Offres et détails des offres spéciales
Le générateur Offers and deals details permet de fournir des informations
offres générales et promotions, en fonction des informations fournies par le get_offers_details
webhook.
L'utilisateur peut demander des informations sur des offres d'une catégorie spécifique ou des informations plus détaillées 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 répondre aux questions fréquentes concernant les offres et les promotions.
- 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 de nouvelles offres sont-elles ajoutées à 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 se passe-t-il 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. Pour en savoir plus, consultez la section "Configuration des webhooks".
Configuration du webhook
Pour utiliser ce composant, vous devez configurer les composants inclus webhooks flexibles pour récupérer les informations nécessaires auprès de vos services externes.
Obtenir 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 générales et spécifiques à 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 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 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 indiqué, utilisée pour envoyer les détails de l'offre. | chaîne |
| 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 informations générales sur 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 la section afin d'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 d'agents conversationnels (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 modifiez 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour si nécessaire.
- Cliquez sur Enregistrer.
Obtenir des informations sur le 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 de bon de réduction pour lequel vous souhaitez récupérer 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 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. | 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 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 "Get coupon code details" (Obtenir les détails du code promotionnel) 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:get_coupon_code_details.
- Remplacez l'URL indiquée dans le champ URL du webhook d'agents conversationnels (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 modifiez 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour 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 sur le 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, permettant de l'identifier. | chaîne |
| $flow.confirmation_channel | Canal sur lequel l'utilisateur a sélectionné 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 cette 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 indiquée dans le champ URL du webhook d'agents conversationnels (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 modifiez 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour si nécessaire.
- Cliquez sur Enregistrer.
Envoyer une demande d'assistance
Le webhook prebuilt_components_offers_and_deals:raise_ticket est utilisé par le composant pour envoyer une demande signalant un problème 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, permettant de l'identifier. | chaîne |
| $flow.coupon_code | Code du bon pour lequel l'utilisateur a signalé un problème. | chaîne |
| $flow.offer_id | ID de l'offre pour le code promotionnel fourni. | chaîne |
| $flow.coupon_code_issue | Problème fourni par l'utilisateur concernant le code promotionnel. | chaîne |
Pour configurer le webhook "Générer des demandes d'assistance" pour ce composant, développez la section afin d'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 des agents conversationnels (Dialogflow CX) par le point de terminaison du service avec lequel vous souhaitez vous intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et modifiez 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Votre agent et ses webhooks doivent maintenant être configurés et prêts à être testés.