L'annulation de la commande composant prédéfini vérifie le niveau d'authentification d'un utilisateur. Une fois l'utilisateur authentifié, le composant fournit des informations sur ses commandes les plus récentes ou passées. La l'utilisateur peut choisir d'annuler l'intégralité d'une commande ou des articles spécifiques commande. Ce composant utilise la classe Authentification pour la vente au détail un composant prédéfini pour authentifier les utilisateurs. Le composant utilise également des générateurs pour la synthèse post-appel.
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 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.
Annuler un seul produit d'une commande récente
L'utilisateur final a déjà été authentifié. L'agent confirme les articles de la commande la plus récente qui doivent être annulés. L'agent vérifie la méthode d'origine de paiement et confirme les détails de l'annulation à l'utilisateur.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Appelez-vous au sujet de votre dernière commande portant le numéro se terminant par 12978 et contenant 5 bouteilles d'eau et 1 t-shirt passée le 09/11/2023 à 20h ? | |
| oui | |
| Nous avons trouvé des produits éligibles dans votre commande. Veuillez nous indiquer le produit que vous souhaitez annuler. Produit 1: bouteille d'eau Google, produit 2: t-shirt Google. Veuillez énoncer ou saisir le numéro de l'article que vous souhaitez sélectionner, ou dire "Suivant" pour afficher plus de produits. |
|
| suivant | |
| Nous n'avons trouvé aucun autre élément dans nos dossiers. Veuillez choisir dans la liste partagée. Produit 1 : gourde Google, Produit 2 : t-shirt Google. Veuillez indiquer le numéro du produit que vous souhaitez sélectionner ou dire "suivant" pour afficher d'autres produits. |
|
| 1 | |
| Me confirmez-vous que vous souhaitez annuler la commande de la bouteille d'eau Google ? Est-ce correct ? | |
| oui | |
| La quantité disponible du produit que vous avez sélectionné est de cinq. Veuillez indiquer le nombre de produits que vous souhaitez annuler. | |
| 4 | |
| Veuillez préciser le motif de l'annulation. Vous pouvez dire quelque chose comme: J'ai changé d'avis, je n'en ai plus besoin, je souhaite acheter un autre article, la livraison est retardée, l'achat a été effectué par erreur, je veux changer de mode de paiement, ou dites d'autres personnes. | |
| Je souhaite acheter un autre article | |
| Merci de nous en avoir informés. Voulez-vous annuler un autre produit ? |
|
| non | |
| Pour les achats effectués avec votre portefeuille, les remboursements sont crédités sur le compte de portefeuille ou de crédit Google Store. Le remboursement apparaîtra sur votre compte dans un délai de trois à cinq jours ouvrés. Notez que les frais de port et de gestion ne seront pas inclus dans le montant remboursé. |
Annuler la commande complète
L'utilisateur final a déjà été authentifié. L'agent confirme que l'utilisateur souhaite annuler une commande spécifique, puis recueille le motif de l'annulation. L'agent vérifie le mode de paiement d'origine et confirme les détails de la résiliation avec l'utilisateur.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Appelez-vous au sujet de votre dernière commande portant le numéro se terminant par 12345 et contenant 1 chemise passée le 10/11/2023 à 18h ? | |
| non | |
| Souhaitez-vous annuler une autre commande ? | |
| oui | |
| Pourriez-vous nous communiquer les cinq derniers chiffres de l\'ID de commande que vous souhaitez suivre ? | |
| 12346 | |
| Les cinq derniers chiffres de l'ID de commande que nous avons obtenu sont 12346, c'est bien ça ? | |
| oui | |
| Parfait, nous avons récupéré l'ID de commande. Voulez-vous annuler la commande entière ? |
|
| oui | |
| Veuillez indiquer le motif de l'annulation. Vous pouvez dire, par exemple, "J'ai changé d'avis", "Je n'en ai plus besoin", "Je souhaite acheter un autre article", "La livraison a été retardée", "J'ai acheté par erreur", "Je souhaite modifier le mode de paiement", etc. | |
| plus utiles | |
| Merci de nous en avoir informés. Votre demande d'annulation a été générée. |
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] | Annuler la commande |
| Type d'entité | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_cancel_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_cancel_order:post_cancellation_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. 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, permettant d'identifier l'utilisateur | chaîne |
| $session.params.all_recent_order_id | (Facultatif) Ce paramètre liste les ID de commande associés à l'utilisateur authentifié, triés par date de passation de la commande dans l'ordre décroissant. Le premier élément du tableau représente la commande la plus récente. Si un utilisateur n'a pas de commande, la valeur de ce paramètre est null. |
Liste (chaîne) |
| $session.params.email | (Facultatif) Adresse e-mail associée au compte. | chaîne |
| $session.params.user_first_name | (Facultatif) Prénom de l'utilisateur, utilisé pour l'accueillir et confirmer la propriété du compte. | 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_another_account_counter | Indique le nombre de nouvelles tentatives autorisées lorsque vous choisissez de continuer avec un autre compte. La valeur par défaut est 2. |
entier |
| $flow.max_retry_order_number | Spécifie le nombre de tentatives autorisées lorsque vous indiquez les cinq derniers chiffres d'un numéro de commande. La valeur par défaut est 2. |
entier |
| $flow.max_retry_another_order | Spécifie le nombre de tentatives autorisées lorsque vous sélectionnez une autre commande lorsque l'ID de commande est introuvable ou que la commande ne peut pas être annulée. La valeur par défaut est 2. |
entier |
| $flow.max_retry_select_order_number | Spécifie le nombre de tentatives autorisées lorsque vous fournissez le numéro de commande complet dans le cas où plusieurs commandes partagent les cinq derniers chiffres. La valeur par défaut est 2. |
entier |
| $flow.max_product_display_counter | Indique le nombre maximal de produits à présenter en une seule fois. La valeur par défaut est 2. |
entier |
| $flow.max_product_display | Spécifie le nombre maximal de produits à présenter pendant toute la conversation. La valeur par défaut est 9. |
entier |
| $flow.max_retry_product_number_counter | Indique le nombre maximal de nouvelles tentatives autorisées lorsque vous sélectionnez un produit à annuler. La valeur par défaut est 2. |
entier |
| $flow.max_product_cancel_confirm_counter | Spécifie le nombre maximal de nouvelles tentatives autorisées lors de la confirmation du produit sélectionné. La valeur par défaut est 2. |
entier |
| $flow.max_retry_select_quantity | Indique le nombre maximal de nouvelles tentatives autorisées lorsque vous sélectionnez la quantité de produit à annuler. La valeur par défaut est 2. |
entier |
| $flow.order_product_cancel_reason_others | Spécifie la valeur de l'entité prebuilt_components_product_cancel_reason indiquant que l'utilisateur a sélectionné le motif de résiliation "Autre". La valeur par défaut est "others". |
chaîne |
| $flow.max_retry_cancel_reason | Spécifie le nombre de tentatives autorisées pour confirmer le motif de l'annulation. La valeur par défaut est 2. |
entier |
| $flow.order_payment_mode_COD | Spécifie la valeur du champ order_payment_mode renvoyée par le webhook get_order_details, qui indique un mode de paiement en espèces à la livraison. La valeur par défaut est "COD". |
chaîne |
| $flow.order_payment_mode_store_credit | Spécifie la valeur du champ order_payment_mode renvoyée par le webhook get_order_details, qui indique un mode de paiement en crédit Google Store. La valeur par défaut est "store_credit". |
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.
- Dans la section Pages, cliquez sur "Page d'accueil".
- 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 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 le code pays, permettant de l'identifier. | chaîne |
| all_recent_order_id | Ce paramètre liste les ID de commande associés à l'utilisateur authentifié, triés par date de commande par ordre décroissant. Le premier élément du tableau représente la commande la plus récente. Si un utilisateur n'a pas de commande, la valeur de ce paramètre est null. |
Liste (chaîne) |
| Adresse e-mail associée au compte. | chaîne | |
| user_first_name | Prénom de l'utilisateur permettant d'accueillir et de confirmer que vous êtes le propriétaire du compte. | chaîne |
| transfer_reason | Ce paramètre indique la raison pour laquelle le flux s'est arrêté 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 entrée. 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 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.
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.
Authentification
Si vous n'avez pas encore configuré les services externes requis pour vous devrez les configurer pour activer l'authentification utilisateurs pour ce composant. Consultez Configurer le webhook d'authentification pour le commerce. pour obtenir des instructions détaillées.
Obtenir les détails des commandes
Le webhook prebuilt_components_cancel_order:get_order_details est utilisé
par le composant pour récupérer les détails d'une commande donnée.
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.order_id | ID de commande pour lequel vous souhaitez récupérer les détails. | chaîne |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour que le composant puisse les utiliser.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| date_de_commande | Date de la commande, au format YYYY-MM-DD. |
chaîne |
| order_time | Heure de la commande, au format HH:MM. |
chaîne |
| order_product_count | Nombre de produits uniques dans une commande. | entier |
| order_payment_mode | Indique le mode de paiement utilisé lors de la commande. | chaîne |
| cancelable_product_id | Liste des ID des produits pouvant être annulés dans la commande. | Liste (chaîne) |
| cancelable_product_name | Liste des noms des produits annulables de la commande. | Liste (chaîne) |
| cancelable_product_brand_name | Liste des noms de marques des produits résiliables de la commande. | Liste (chaîne) |
| cancelable_product_quantity | Liste des quantités des produits résiliables de la commande. | Liste (chaîne) |
Pour configurer le webhook "Obtenir les détails de la commande" 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_cancel_order:get_order_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 afin de définir le format de requête approprié pour votre webhook.
- Vérifiez et mettez à jour la configuration des réponses pour extraire des champs spécifiques du flux de webhook de réponse. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour si nécessaire.
- Cliquez sur Enregistrer.
Obtenir les détails d'une commande en double
Le webhook prebuilt_components_retail_services:get_duplicate_order_details est utilisé
par le composant pour récupérer des informations détaillées afin de distinguer
commandes lorsque plusieurs numéros de commande ont les cinq derniers chiffres.
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.duplicate_order_id | Liste contenant les cinq derniers chiffres des numéros de commande partagés entre une ou plusieurs commandes pour l'utilisateur. | Liste (chaîne) |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour que le composant puisse les utiliser.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| all_order_date | Liste des dates de commande pour les commandes en double avec les cinq derniers chiffres spécifiés au format YYYY-MM-DD. Chaque élément de ce tableau correspond au même élément du tableau all_order_time. |
Liste (chaîne) |
| all_order_time | Liste des heures de commande pour les commandes en double dont les cinq derniers chiffres sont spécifiés au format HH:MM. Chaque élément de ce tableau correspond au même élément du tableau all_order_date. |
Liste (chaîne) |
Pour configurer le webhook "Obtenir les détails de la commande en double" 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_retail_services:get_duplicate_order_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 afin de définir le format de requête approprié pour votre webhook.
- Vérifiez et mettez à jour la configuration des réponses pour extraire des champs spécifiques du flux de webhook de réponse. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Vérifiez les paramètres d'authentification et mettez-les à jour si nécessaire.
- Cliquez sur Enregistrer.
Détails de l'annulation du post
Le webhook prebuilt_components_cancel_order:post_cancellation_details est utilisé
par le composant pour envoyer une demande d'annulation.
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, permettant de l'identifier. | chaîne |
| $flow.order_id | ID de commande pour laquelle vous souhaitez envoyer une demande d'assistance. | chaîne |
| $flow.cancel_product_id_list | Liste des ID de produit que l'utilisateur souhaite annuler. | Liste (chaîne) |
| $flow.cancel_product_quantity_list | Liste des quantités de produits que l'utilisateur souhaite annuler, correspondant à chaque élément de $flow.cancel_product_id_list. |
Liste (chaîne) |
| $flow.cancel_reason_list | Liste des motifs d'annulation pour chaque produit annulé, correspondant à chaque élément du fichier $flow.cancel_product_id_list. |
Liste (chaîne) |
| $flow.order_refund_mode | Mode de paiement du remboursement. Les valeurs valides sont définies par l'entité prebuilt_components_cancel_mode_of_refund. |
chaîne |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour que le composant puisse les utiliser.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| order_cancellation_ticket_id | ID de la demande d'annulation. | chaîne |
Pour configurer le webhook "Informations sur l'annulation du post" 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_cancel_order:post_cancellation_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 afin de définir le format de requête approprié pour votre webhook.
- Vérifiez et mettez à jour la configuration des réponses pour extraire des champs spécifiques du flux de webhook de réponse. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs 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.