Retourner et rembourser un composant prédéfini

Le retour et le remboursement 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. L'utilisateur peut ensuite choisir de retourner plusieurs articles d'une commande et sélectionner des options, y compris des méthodes de remboursement et de retour. Ce composant utilise le composant prédéfini Authentification pour le commerce pour authentifier les utilisateurs. Le composant utilise également des générateurs pour le résumé post-appel et les questions fréquentes.

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îte de dialogue illustrent ce comportement lorsque le composant est appelée à l'aide de la téléphonie, ce qui déclenche l'intent d'accueil par défaut et le premier de l'agent au début de la conversation.

Retour en magasin pour un seul produit

L'utilisateur final a déjà été authentifié. L'agent confirme les éléments la commande la plus récente doit être retournée et recueille le motif du retour. L'utilisateur choisit de retourner les articles dans un magasin, et l'agent fournit une liste des magasins les plus proches. L'utilisateur sélectionne un magasin, et l'agent génère une étiquette de livraison qui est envoyée aux canaux enregistrés de l'utilisateur.

Entrée utilisateur Réponse de l'agent
Appelez-vous au sujet de votre dernière commande dont le numéro se termine par 12345 et contient deux lampes passées le 10/11/2023 ?
oui
Pour confirmer, vous souhaitez retourner la lampe Google. Est-ce correct ?
oui
Nous constatons que la quantité disponible du produit que vous avez sélectionné est de 2. Veuillez indiquer la quantité de produits que vous souhaitez retourner.
deux
Veuillez indiquer le motif du retour. Vous pouvez dire quelque chose comme: article défectueux ou ne fonctionne pas, n'est plus nécessaire, problème de taille ou de coupe, mauvais article a été envoyé, article arrivé trop tard, acheté par erreur ou dites d'autres personnes.
autres
Veuillez indiquer le motif de votre retour.
mauvaise qualité
Pour information, le motif du retour est une mauvaise qualité. Est-ce correct ?
oui
Veuillez nous indiquer où vous souhaitez recevoir votre remboursement. Vous pouvez par exemple dire "avoir" ou "compte source".
compte source
Merci d'avoir vérifié que vous souhaitiez que votre remboursement soit effectué sur le mode de paiement d'origine.

Dernière étape, comment souhaitez-vous retourner le produit ? Vous pouvez dire, par exemple, "Retour en magasin", "Déposer à l'adresse" ou "Planifier la récupération".
retour en magasin
Trouvons un magasin près de chez vous.
L'agent collecte le code postal à l'aide du composant prédéfini de collecte des codes postaux
Voici la liste des lieux situés près du code postal que vous avez saisi.
Adresse 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, États-Unis.
Adresse 2: Google California, 19510 Jamboree Road, Irvine, Californie 92612, États-Unis.

Dites ou saisissez "Suivant" pour sélectionner l'adresse pour afficher plus d'adresses de magasins.
1
Pour confirmer, vous avez sélectionné Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, États-Unis. Est-ce bien cela ?
oui
Parfait. Nous avons envoyé une étiquette de livraison et un numéro de ticket au numéro de téléphone et à l'adresse e-mail que vous avez enregistrés. Veuillez l'imprimer, le joindre à votre colis et déposer le colis de retour dans un délai de 30 jours.
Une fois que nous aurons reçu l'article dans notre entrepôt, votre remboursement apparaîtra sur votre compte dans un délai de trois à cinq jours ouvrés. Remarque: Le montant du remboursement ne tient pas compte des frais de port ni de manutention.
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] Renvoyer et Remboursement
Type d'entité prebuilt_components_[component_name]_[entity_type] prebuilt_components_return_refund_mode_of_return
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_return_refund:post_return_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 à 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, 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 en fonction de la 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)
$session.params.email (Facultatif) L'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 fournissez les cinq derniers chiffres d'un numéro de commande. La valeur par défaut est 3. entier
$flow.max_retry_another_order Indique le nombre de nouvelles tentatives autorisées lorsque vous sélectionnez une autre commande à retourner si l'ID de commande n'est pas trouvé ou si la commande n'est pas éligible au retour. 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 Spécifie le nombre maximal de tentatives autorisées lors de la sélection d'un produit à renvoyer. La valeur par défaut est 2. entier
$flow.max_product_return_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_return_reason_counter Spécifie le nombre de tentatives autorisées pour confirmer le motif du retour. La valeur par défaut est 2. entier
$flow.order_product_return_reason_others Spécifie la valeur de l'entité prebuilt_components_return_refund_reason indiquant que l'utilisateur a sélectionné la raison de retour "Autre". La valeur par défaut est "others". chaîne
$flow.max_retry_select_quantity Spécifie le nombre maximal de tentatives autorisées lorsque vous sélectionnez la quantité de produits à renvoyer. La valeur par défaut est 2. entier
$flow.max_store_display_counter Spécifie le nombre maximal de magasins à présenter en un seul tour. La valeur par défaut est 1. entier
$flow.max_store_display Spécifie le nombre maximal de magasins à afficher dans l'ensemble de la conversation. La valeur par défaut est 10. entier
$flow.max_retry_store_number_counter Spécifie le nombre maximal de tentatives autorisées lors de la sélection d'un magasin. La valeur par défaut est 2. entier
$flow.max_retry_store_selection Spécifie le nombre de tentatives autorisées lors de la confirmation de la sélection du magasin. La valeur par défaut est 2. entier
$flow.max_retry_another_zip_code Indique le nombre maximal de nouvelles tentatives autorisées lors de la saisie d'un code postal. La valeur par défaut est 2. entier
$flow.order_payment_mode_COD Spécifie la valeur du champ order_payment_mode renvoyé par le webhook get_order_details indiquant un mode de paiement avec paiement à la livraison (COD). 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
$flow.order_refund_mode_source_account Indique la valeur de l'entité prebuilt_components_return_refund_mode_of_refund indiquant que l'utilisateur a sélectionné le remboursement sur son compte source. La valeur par défaut est source_account. chaîne
$flow.order_return_location_scheduled_for_pickup Spécifie la valeur de l'entité prebuilt_components_exchange_order_location indiquant que l'utilisateur a sélectionné la planification d'une collecte pour le retour. La valeur par défaut est scheduled_for_pickup. chaîne

Pour configurer les paramètres d'entrée de ce composant, développez cette section pour obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Compilation.
  5. Cliquez sur le composant importé dans la section Flux.
  6. Cliquez sur la page de démarrage dans la section Pages.
  7. Cliquez sur la route true dans la page d'accueil.
  8. Dans la fenêtre "Itinéraire", modifiez les valeurs des préréglages de paramètres si nécessaire.
  9. 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 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
all_recent_order_id 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)
e-mail Adresse e-mail associée au compte. chaîne
user_first_name Prénom de l'utilisateur, utilisé pour le saluer et confirmer qu'il est le propriétaire du compte. 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é 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 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. 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.

Questions fréquentes

Le générateur FAQ permet de gérer les questions fréquentes sur les retours. et places de marché, dont:

  • Y a-t-il une date limite pour la procédure de retour ?
  • Puis-je échanger un article offert ?
  • Le prix du produit et le montant du remboursement sont différents. Pourquoi ?

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 :

  1. Importez le composant prédéfini.
  2. Configurez les attributs webhooks flexibles avec décrivant vos services externes, consultez la section configuration.

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 l'authentification, vous devez les configurer pour activer l'authentification des 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_return_refund: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 dont 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_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
returnable_product_id Liste des ID des produits pouvant être retournés dans la commande. Liste (chaîne)
returnable_product_name Liste des noms des produits pouvant être retournés dans la commande. Liste (chaîne)
returnable_product_brand_name Liste des noms de marques des produits pouvant être retournés dans la commande. Liste (chaîne)
returnable_product_quantity Liste des quantités de produits pouvant être retournés dans 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.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_return_refund:get_order_details.
  7. 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.
  8. Examinez et modifiez le corps de la requête afin de définir le format de requête approprié pour votre webhook.
  9. 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.
  10. Examinez et modifiez les paramètres Authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir les détails des commandes 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 les commandes lorsque plusieurs numéros de commande ont les cinq derniers chiffres identiques.

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.duplicate_order_id Liste contenant les cinq derniers chiffres des numéros de commande partagés entre une ou plusieurs commandes de 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 dans le tableau all_order_time. Liste (chaîne)
all_order_time Liste des heures de commande pour les commandes en double avec les cinq derniers chiffres spécifiés au format HH:MM. Chaque élément de ce tableau correspond au même élément dans le 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.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_retail_services:get_duplicate_order_details.
  7. 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.
  8. Examinez et modifiez le corps de la requête afin de définir le format de requête approprié pour votre webhook.
  9. 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.
  10. Examinez et modifiez les paramètres Authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir les détails d'un magasin

Le webhook prebuilt_components_return_refund:get_store_details est utilisé par pour récupérer la liste des magasins situés près du code postal indiqué 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
$flow.zip_code Code postal pour rechercher des magasins à proximité. 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
store_id Liste des ID de magasins. Liste (chaîne)
store_address Liste des adresses des magasins correspondant à chaque élément de store_id. Liste (chaîne)

Pour configurer le webhook "Get store details" (Obtenir les informations sur le magasin) pour ce composant, développez la section pour obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_return_refund:get_store_details.
  7. 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.
  8. Examinez et modifiez le corps de la requête afin de définir le format de requête approprié pour votre webhook.
  9. 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.
  10. Examinez et modifiez les paramètres Authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Publier les détails du retour

Le webhook prebuilt_components_return_refund:post_return_details est utilisé par le composant pour envoyer un retour.

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.order_id ID de commande pour laquelle vous souhaitez envoyer une demande d'assistance. chaîne
$flow.return_product_id_list Liste des ID produit que l'utilisateur souhaite renvoyer. Liste (chaîne)
$flow.return_product_quantity_list Liste des quantités de produits que l'utilisateur souhaite retourner, correspondant à chaque élément de $flow.return_product_id_list. Liste (chaîne)
$flow.return_reason_list Liste des motifs de retour pour chaque produit renvoyé, correspondant à chaque élément de $flow.return_product_id_list. Liste (chaîne)
$flow.order_return_location Mode sélectionné pour le retour. Les valeurs valides sont définies par l'entité prebuilt_components_exchange_order_location. chaîne
$flow.order_return_store_id ID du magasin sélectionné par l'utilisateur pour un retour. chaîne
$flow.order_refund_mode Mode de paiement du remboursement. Les valeurs valides sont définies par l'entité prebuilt_components_return_refund_mode_of_return. Si aucun remboursement n'est requis, cette valeur est null. 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_return_ticket_id ID du billet pour le retour envoyé. chaîne

Pour configurer le webhook Post return details de ce composant, développez cette section pour obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_return_refund:post_return_details.
  7. 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.
  8. Examinez et modifiez le corps de la requête afin de définir le format de requête approprié pour votre webhook.
  9. 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.
  10. Examinez et modifiez les paramètres Authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Envoyer des informations de remboursement pour les paiements en espèces

Le webhook prebuilt_components_return_refund:send_COD_refund_information est utilisé par le composant pour envoyer à un utilisateur des informations de paiement liées aux retours.

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.order_id ID de commande pour laquelle vous souhaitez envoyer une demande d'assistance. chaîne
$flow.channel Canal spécifique auquel envoyer les informations. Les valeurs valides sont définies par l'entité prebuilt_components_channel_email_phone. Par défaut, phone et email sont compatibles. chaîne

Pour configurer le webhook "Envoyer des informations sur le remboursement COD" pour ce composant, développez-le afin d'obtenir des instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_return_refund:send_COD_refund_information.
  7. 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.
  8. Examinez et modifiez le corps de la requête afin de définir le format de requête approprié pour votre webhook.
  9. 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.
  10. Examinez et modifiez les paramètres Authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Terminé

Votre agent et ses webhooks doivent maintenant être configurés et prêts à être testés.