Le composant prédéfini des offres et des offres spéciales vérifie si l'appelant est un utilisateur enregistré. Si l'utilisateur dispose d'un compte enregistré, le composant peut fournir des informations sur les offres et les offres 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 Collection alphanumérique pour collecter les codes promotionnels. 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 limitations suivantes:
- Ce composant ne chiffre aucune donnée.
Exemples de boîtes de dialogue
Les exemples de boîtes de dialogue suivants illustrent les 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 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 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 | |
| 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, vous devez dépenser au moins 10 € pour bénéficier de 15% de remise sur les produits alimentaires. Pour profiter de cette offre, utilisez le code GROCERY500. Elle est valable jusqu'au 28/03/2024. Nous espérons avoir répondu à vos questions. Avez-vous des questions sur les offres ou les promotions ? |
|
| Avez-vous des offres pour les 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 les offres ou les promotions ? |
|
| 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 à l'utilisateur des informations sur son utilisation. L'utilisateur confirme qu'il rencontre un problème avec le code promotionnel, et l'agent crée 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 | |
| Me confirmez-vous que vous recherchez des codes promotionnels ? Est-ce bien cela ? | |
| oui | |
| Nous le regrettons. Pouvez-vous m\'indiquer le code promotionnel que vous utilisez ? | |
| L'agent collecte le code promotionnel à l'aide du composant prédéfini Collection 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, comme le montant d'achat minimal, sont respectées. Ces informations vous sont-elles utiles ? |
|
| non | |
| Veuillez indiquer le problème que vous rencontrez. Vous pouvez dire, par exemple, "Mon code promotionnel ne fonctionne pas" ou "Mon code promotionnel ne fonctionne pas dans ma région". | |
| 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 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:
| Caractéristique | Format | Exemple |
|---|---|---|
| Flux | [Component Name] | 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 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 de portée de flux doivent être définis sur la page de démarrage du composant. Les paramètres de portée de 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 l'identifier. | chaîne |
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 | Indique le nombre de nouvelles tentatives autorisées lorsque l'utilisateur choisit s'il souhaite recevoir des 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 | Indique le nombre de tentatives autorisées lorsque l'utilisateur indique le problème rencontré 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é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 cette 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 Flux.
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vraie) sur la page de démarrage.
- 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 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 code pays, utilisé pour l'identifier. | chaîne |
| 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 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 la section Événements intégrés de non-correspondance.webhook_error: une erreur de webhook s'est produite. Voir Événement intégré webhook.error. webhook_not_found: une URL de webhook était inaccessible. Voir É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 répondre aux questions fréquentes concernant les remises, les soldes, 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 pour 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écifiques à l'utilisateur
Le générateur User-specific offer details permet de fournir des informations 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 informations sur les offres et les offres générales en fonction des informations fournies par le webhook get_offers_details.
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
Le générateur Offers and deals FAQ permet de gérer les questions fréquentes liées aux offres et aux promotions.
- Existe-t-il des offres spéciales pour les nouveaux clients ?
- Comment être informé des prochaines offres ?
- Des offres sont-elles 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 pour 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. Pour en savoir plus, 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 à partir 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 dans le compte fourni, 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 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"}. |
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 "Get offers details" (Obtenir les détails des offres) 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_offers_details.
- 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 obtenir 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 des champs renvoyées.
- Examinez et modifiez les paramètres Authentification 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 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 obtenir 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 des champs renvoyées.
- Examinez et modifiez les paramètres 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 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 code pays, utilisé pour l'identifier. | chaîne |
| $flow.confirmation_channel | Canal sur 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 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 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 obtenir 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 des champs renvoyées.
- Examinez et modifiez les paramètres Authentification 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 code pays, utilisé pour l'identifier. | chaîne |
| $flow.coupon_code | Code du bon de réduction 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 indiqué par l'utilisateur concernant le code promotionnel. | chaîne |
Pour configurer le webhook "Raise ticket" (Envoyer une demande) 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 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 obtenir 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 des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Votre agent et ses webhooks devraient maintenant être configurés et prêts à être testés.