Le composant prédéfini "Offres et 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 détails 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 Collection alphanumérique pour collecter les codes promotionnels. Le composant utilise également des générateurs pour le résumé post-appel, les questions fréquentes et les détails de l'offre.
Limites
Outre les 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 boîtes de dialogue illustrent le comportement lorsque le composant est appelé par téléphonie, ce qui déclenche l'intent de bienvenue 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 à l'utilisateur
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 qui lui sont destinées. 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, qui 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 | |
| Voici les offres que nous avons trouvées pour vous : Offre 1 : profitez de 5% de remise sur les vêtements avec le code APPARELS5, valable jusqu'au 28/03/2024. Offre 2 : profitez de 15% de remise sur les produits d'épicerie avec le code GROCERY500, valable jusqu'au 28/03/2024. Nous espérons que ces offres vous intéresseront. Avez-vous des questions sur les offres auxquelles nous pouvons répondre ? |
|
| Existe-t-il un minimum d'achat pour l'offre sur les courses ? | |
| Oui, il y a un minimum d'achat de 10 € pour bénéficier de la remise de 15% sur les produits d'épicerie. Utilisez le code GROCERY500 pour profiter de cette offre, valable jusqu'au 28/03/2024. Nous espérons que ces informations vous seront utiles. Avez-vous des questions sur les offres auxquelles nous pouvons répondre ? |
|
| Avez-vous des offres pour des appareils électroniques ? | |
| Pas de problème ! Voici les détails de l'offre : Offre 1 : profitez de 5% de remise sur les produits électroniques avec le code ELECTRIC5, valable jusqu'au 28/03/2024. Offre 2 : profitez de 15% de remise sur les produits électroniques avec le code ELECTRIC15, valable jusqu'au 28/03/2024. Nous espérons que ces informations vous seront utiles. Avez-vous des questions sur les offres auxquelles nous pouvons répondre ? |
|
| Non, j'ai terminé | |
| Voulez-vous que les détails de l'offre soient envoyés au numéro de mobile ou à l'adresse e-mail que vous avez enregistrés ? | |
| 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 rencontre un problème avec un code promotionnel. L'agent collecte le code promotionnel et fournit à l'utilisateur des détails sur l'utilisation du code promotionnel. 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écessite un montant d'achat minimal de 100 $ et est valable jusqu'au 28/03/2024. Veuillez vous assurer que les conditions telles que le montant d'achat minimal sont remplies. Ces informations vous sont-elles 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 ne fonctionne pas dans votre région. | |
| Le code promotionnel ne fonctionne pas | |
| Pour confirmer, le problème de code promotionnel indiqué 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 | [Component Name] | Offres |
| 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 du flux pour déterminer le comportement du composant. Les paramètres limités au 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'écouter les 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 pour fournir une catégorie d'offres à écouter. 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 avec lequel il 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 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 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é 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é 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é 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 Compilation.
- Cliquez sur le composant importé dans la section Flows (Flux).
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vrai) sur la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs des 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 sortie 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é 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 nouvelles tentatives pour les événements sans entrée. Consultez Événements intégrés no-input.max_no_match : la conversation a atteint le nombre maximal de nouvelles tentatives pour les événements no-match. Consultez É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 était inaccessible. Consultez É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ésumé après l'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 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 obtenir 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 ?
- Y a-t-il une date limite 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 les offres spécifiques à l'utilisateur en fonction des informations fournies par le webhook get_offers_details.
Détails des offres
Le générateur Offers and deals details permet de fournir des détails sur les offres et les promotions générales en fonction des informations fournies par le webhook get_offers_details.
L'utilisateur peut demander des offres dans une catégorie spécifique ou demander plus de détails sur des offres spécifiques.
Questions fréquentes sur les offres
Le générateur Offers and deals FAQ permet de gérer les 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 ?
- Y a-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 paiement ?
- Que faire si j'ai oublié d'appliquer un code de réduction lors du paiement ?
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. Consultez la section "Configuration 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 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 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 seule offre, 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"}. |
List (objet) |
| all_offers | Liste des détails généraux de l'offre. Chaque élément de la liste représente une seule offre, au même format que le champ user_offer. |
List (objet) |
Pour configurer le webhook "Obtenir les détails des offres" pour ce composant, développez la section pour afficher 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 requis par le composant pour accéder aux valeurs de champ renvoyées.
- 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 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 promotionnel 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 d'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 pour afficher 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 requis par le composant pour accéder aux valeurs de champ renvoyées.
- 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 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 d'envoi de 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 requis par le composant pour accéder aux valeurs de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Envoyer une demande
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 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 promotionnel pour lequel l'utilisateur a signalé un problème. | string |
| $flow.offer_id | ID d'offre pour le code promotionnel fourni. | string |
| $flow.coupon_code_issue | Problème indiqué par l'utilisateur concernant le code promotionnel. | string |
Pour configurer le webhook "Créer un ticket" 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 requis par le composant pour accéder aux valeurs de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Votre agent et ses webhooks devraient maintenant être configurés et prêts à être testés.