Composant prédéfini de commande d'échange

Le composant prédéfini de l'ordre d'échange 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 d'échanger plusieurs articles dans une commande et sélectionner des options telles que les modes de remboursement et de livraison. Ce composant utilise le composant prédéfini d'authentification Retail pour authentifier les utilisateurs. Il utilise également des générateurs pour la synthèse 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 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é à 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.

Échange en magasin pour un article défectueux

L'utilisateur final a déjà été authentifié. L'agent confirme les articles de la commande la plus récente à échanger et recueille le motif de cet échange. L'utilisateur choisit d'échanger les articles dans un magasin, et l'agent fournit la 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 vers les canaux enregistrés de l'utilisateur.

Entrée utilisateur Réponse de l'agent
Vous appelez-vous au sujet de votre dernier numéro de commande se terminant par 12375 qui contient 2 lampes, 2 Pixels et 10 autres produits passés le 10/11/2023 ?
oui
Nous avons trouvé des produits éligibles dans votre commande. Veuillez nous indiquer le produit que vous souhaitez échanger. Produit 1: lampe Google, Produit 2: Google Pixel, Produit 3: ampoule LED Google.

Veuillez énoncer ou saisir le numéro de l'article que vous souhaitez sélectionner. Sinon, dites à côté pour afficher plus de produits.
1
Me confirmez-vous que vous souhaitez échanger la lampe Google ? Est-ce correct ?
oui
Nous pouvons voir que la quantité disponible du produit que vous avez sélectionné est de deux. Veuillez indiquer la quantité de produits que vous souhaitez échanger.
Deux
Veuillez indiquer le motif de l'échange. Vous pouvez dire, par exemple, "Article défectueux ou non fonctionnel", Problème de taille ou de compatibilité, problème de commande incomplète, problème de style, couleur incorrecte ou autre mention de la part d'autres utilisateurs.
Article défectueux
Merci de nous en avoir informés.

Pour terminer, comment souhaitez-vous échanger le produit ? Dites par exemple : "Échanger dans un magasin" ou "Programmer le retrait".
Je souhaite échanger dans un magasin
Cherchons un magasin près de chez vous.
L'agent collecte le code postal à l'aide du composant prédéfini Collecte des codes postaux
Voici la liste des lieux situés à proximité 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, California 92612, États-Unis.

Dites ou saisissez "à côté" ou saisissez le nom d'un autre magasin.
Le premier magasin
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 billet à l'adresse e-mail et au numéro de téléphone que vous avez enregistrés. Veuillez l'imprimer et le joindre à votre colis et déposer l'échange dans un délai de 30 jours. Après réception de l'article dans notre entrepôt, votre échange (le cas échéant) apparaît dans votre compte dans un délai de trois à cinq jours ouvrés. Remarque: Le montant du remboursement ne comprendra pas les frais de port et de manutention.

Le produit de votre échange a une valeur plus élevée. La différence de prix est de 20$. Vous recevrez bientôt le lien de paiement sur votre numéro de mobile enregistré. Pour effectuer l'échange, veuillez effectuer le paiement sous 24 heures.

Voulez-vous échanger une autre commande ?
non, c'est ça
Merci de votre appel.

Remboursement de la différence de prix

L'utilisateur final a déjà été authentifié. L'agent recueille le numéro de commande et le produit à échanger, puis renseigne le motif de l'échange. L'utilisateur choisit d'échanger les articles contre une taille différente et planifie un retrait. L'agent détermine que le prix de l'article échangé est inférieur à celui du nouvel article et confirme auprès de l'utilisateur le mode de paiement à utiliser pour le remboursement.

Entrée utilisateur Réponse de l'agent
Vous appelez-vous au sujet de votre dernier numéro de commande se terminant par 12345 contenant deux lampes placées le 10/11/2023 ?
Non
Voulez-vous passer une autre commande ?
Oui
Pourriez-vous fournir les cinq derniers chiffres de l'ID de la commande que vous souhaitez échanger ?
12346
Les cinq derniers chiffres de l'ID de commande que nous avons reçus sont 12346. C'est bien cela ?
Oui
Parfait, nous avons terminé de récupérer l'ID de commande.

Nous avons trouvé des produits éligibles dans votre commande. Veuillez nous indiquer le produit que vous souhaitez échanger. Produit 1: bouteille d'eau Google ; Produit 2: T-shirt Google.

Veuillez dire ou saisir le numéro de l'article que vous souhaitez sélectionner. Sinon, dites à côté pour afficher plus de produits.
Deux
Pour vérifier que vous êtes intéressé, vous souhaitez échanger le T-shirt Google contre une somme d'argent. Est-ce correct ?
Oui
Veuillez indiquer le motif de l'échange. Vous pouvez dire, par exemple, "Article défectueux ou non fonctionnel", Problème de taille ou de compatibilité, problème de commande incomplète, problème de style, couleur incorrecte ou autre mention de la part d'autres utilisateurs.
Problème de taille ou de compatibilité
Merci de nous avoir indiqué le motif de cet échange. Pouvez-vous nous indiquer la taille que vous souhaitez échanger ? Les tailles suivantes sont disponibles:
Dites 1 correspond à une taille S
Dites 2 correspond à une taille M.
Dites 3 à une taille L.
Dites 4 à une taille XL.
Dites 5 correspond à une taille deux XL.
1
Pour finir, comment souhaitez-vous échanger le produit ? Dites par exemple : "Échanger dans un magasin" ou "Programmer le retrait".
Programmer le retrait
Parfait. Nous avons envoyé une étiquette de livraison à l'adresse e-mail et au numéro de téléphone que vous avez enregistrés. Imprimez-la et joignez-la au colis. Notre équipe vous contactera d'ici 24 à 48 heures pour planifier l'enlèvement. Après réception de l'article dans notre entrepôt, le remboursement de l'échange apparaît sur votre compte dans un délai de trois à cinq jours ouvrés.

Votre produit échangé est de moins grande valeur et vous pouvez demander un remboursement de 5 €.
Veuillez nous indiquer où vous souhaitez recevoir votre remboursement. Dites, par exemple, "Crédit Google Store" ou "Compte source".
Crédit Google Store
Merci d'avoir confirmé que vous souhaitez que votre remboursement soit remboursé sur Google Wallet.

Souhaitez-vous échanger une autre commande ?
0
Merci de votre appel.

Commande non éligible

L'utilisateur final a déjà été authentifié. L'agent vérifie la commande la plus récente et constate qu'aucun produit ne peut être échangé. L'agent collecte un numéro de commande auprès de l'utilisateur et constate que la commande fournie ne comporte aucun produit éligible.

Entrée utilisateur Réponse de l'agent
Lors de votre dernière commande, nous n'avons trouvé aucun produit pouvant faire l'objet d'un échange.

Souhaitez-vous échanger une autre commande ?
oui
Pourriez-vous fournir les cinq derniers chiffres de l'ID de la commande que vous souhaitez échanger ?
23487
Les cinq derniers chiffres de l'ID de commande que nous avons reçus sont 23487. C'est bien cela ?
oui
Parfait, nous avons terminé de récupérer l'ID de commande.
Désolé, aucun produit de votre commande ne peut faire l'objet d'un échange conformément à nos règles. Vous trouverez plus d'informations sur nos conditions d'échange sur notre site Web.

Voulez-vous échanger une autre commande ?
0
Merci de votre appel.

Conventions de nommage

Ce composant prédéfini utilise les conventions d'attribution de noms suivantes:

Sélection Format Exemple
Flow [Nom du composant] État de la commande
Type d'entité prebuilt_components_[component_name]_[entity_type] prebuilt_components_exchange_order_location
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_exchange_order:get_product_exchange_availability

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 dans le flux pour déterminer le comportement du composant. Les paramètres de portée flux doivent être définis sur la page d'accueil du composant. Les paramètres de portée session peuvent être définis par un flux d'appel ou sur la page d'accueil 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 l'indicatif du pays, qui permet 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 placement 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 aucune 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, permettant d'accueillir et de confirmer que vous êtes le propriétaire du compte. chaîne

Ce composant prédéfini permet aux paramètres facultatifs suivants de configurer son comportement, y compris les nouvelles tentatives.

Nom du paramètre Description Format
$flow.max_retry_another_account Spécifie le nombre de tentatives autorisées lorsque vous choisissez de continuer avec un autre compte. La valeur par défaut est 3. 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 Spécifie le nombre de tentatives autorisées lors de la sélection d'une autre commande pour le retour lorsque l'ID est introuvable ou que la commande n'est pas éligible pour l'échange. 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 complet de commande lorsque plusieurs commandes partagent les cinq derniers chiffres. La valeur par défaut est 2. entier
$flow.max_retry_exchange_reason Spécifie le nombre de tentatives autorisées lorsque vous indiquez le motif de l'échange. La valeur par défaut est 3. entier
$flow.max_retry_exchange_reason_counter Spécifie le nombre de tentatives autorisées lors de la confirmation du motif de l'échange. La valeur par défaut est 2. entier
$flow.order_product_exchange_reason_others Spécifie la valeur de l'entité prebuilt_components_exchange_order_reason, indiquant que l'utilisateur a sélectionné le motif d'échange "Autres". La valeur par défaut est "others". chaîne
$flow.max_product_display_counter Spécifie le nombre maximal de produits à présenter en un seul tour. La valeur par défaut est 2. entier
$flow.max_product_display Spécifie le nombre maximal de produits à afficher pendant toute la conversation. La valeur par défaut est 9. entier
$flow.max_product_exchange_confirm Spécifie le nombre maximal de nouvelles tentatives autorisé lors de la confirmation du produit sélectionné. La valeur par défaut est 2. entier
$flow.max_retry_product_number_counter Spécifie le nombre maximal de tentatives autorisées lors de la sélection d'un produit à échanger. La valeur par défaut est 3. entier
$flow.max_retry_select_quantity Spécifie le nombre maximal de tentatives autorisées lorsque vous sélectionnez la quantité de produits à échanger. La valeur par défaut est 2. entier
$flow.max_retry_size_number_counter Spécifie le nombre maximal de tentatives autorisées lorsque vous sélectionnez la taille à échanger. La valeur par défaut est 2. entier
$flow.max_retry_another_zip_code Spécifie le nombre maximal de tentatives autorisées lorsque vous indiquez un code postal. La valeur par défaut est 2. entier
$flow.max_store_display_counter Spécifie le nombre maximal de magasins à afficher en un seul tour. La valeur par défaut est 1. entier
$flow.max_store_display Spécifie le nombre maximal de magasins à afficher sur 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 Indique le nombre de tentatives autorisées lors de la confirmation de la sélection du magasin. La valeur par défaut est 3. entier
$flow.max_available_address_reselection_counter Indique le nombre de tentatives autorisées pour confirmer si l'utilisateur souhaite sélectionner une autre adresse de magasin. 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 à 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é par le webhook get_order_details indiquant un mode de paiement de crédit Google Store. La valeur par défaut est "store_credit". chaîne
$flow.order_refund_mode_source_account Spécifie la valeur de l'entité prebuilt_components_exchange_order_refund_mode, indiquant que l'utilisateur a choisi de rembourser sur son compte source. La valeur par défaut est source_account. chaîne
$flow.order_exchange_location_scheduled_for_pickup Spécifie la valeur de l'entité prebuilt_components_exchange_order_location, indiquant que l'utilisateur a choisi de planifier un retrait sur la place de marché. La valeur par défaut est scheduled_for_pickup. chaîne

Pour configurer les paramètres d'entrée de ce composant, développez les instructions.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Build (Compiler).
  5. Cliquez sur le composant importé dans la section Flux.
  6. Cliquez sur "Page d'accueil" dans la section Pages.
  7. Cliquez sur la route true (vraie) sur la page d'accueil.
  8. Dans la fenêtre "Route", modifiez les valeurs Parameter Presets (Préréglages) 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 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. chaîne
all_recent_order_id Ce paramètre répertorie les ID de commande associés à l'utilisateur authentifié, triés en fonction de la date de la commande (ordre décroissant). Le premier élément du tableau représente la commande la plus récente. Si un utilisateur n'a aucune commande, la valeur de ce paramètre est null. Liste (chaîne)
email Adresse e-mail associée au compte. chaîne
user_first_name Prénom de l'utilisateur, permettant d'accueillir et de confirmer que le compte vous appartient. chaîne
transfer_reason Ce paramètre indique la raison pour laquelle le flux a été interrompu, 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 saisie. 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 Événement intégré webhook.error.

webhook_not_found: une URL de webhook est inaccessible. Consultez É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 les échanges, y compris:

  • Y a-t-il une date limite pour le processus de retour ?
  • Puis-je échanger un cadeau ?
  • 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 webhooks flexibles fournis avec une configuration décrivant vos services externes Dialogflow. Consultez la section "Configurer 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.

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. Pour obtenir des instructions détaillées, consultez Configurer le webhook d'authentification pour la vente au détail.

Obtenir les détails de la commande

Le webhook prebuilt_components_exchange_order:get_order_details permet au composant de récupérer les détails d'une commande spécifiée.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans la requête API.

Nom du paramètre Description Format d'entrée
$flow.order_id ID de commande pour lequel vous souhaitez obtenir des informations. chaîne

Paramètres de réponse de l'API

Les paramètres suivants sont extraits de la réponse de l'API et utilisés par le composant.

Nom du paramètre Description Format de sortie
order_date Date à laquelle la commande a été passée, 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
exchangeable_product_id Liste des ID produit des produits échangeables de la commande. Liste (chaîne)
exchangeable_product_name Liste des noms de produits des produits échangeables de la commande. Liste (chaîne)
exchangeable_product_brand_name Liste des noms de marques pour les produits échangeables de la commande. Liste (chaîne)
exchangeable_product_quantity Liste des quantités des produits échangeables dans la commande. Liste (chaîne)
exchangeable_product_price Liste des prix des produits échangeables de la commande. Liste (chaîne)

Pour configurer le webhook "Obtenir les détails de la commande" pour ce composant, développez les 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_Exchange_order:get_order_details.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir les détails d'une commande en double

Le composant utilise le webhook prebuilt_components_retail_services:get_duplicate_order_details 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.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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 et utilisés par le composant.

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, avec les cinq derniers chiffres 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 "Get duplicate order details" (Obtenir les détails de la commande en double) pour ce composant, développez les 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 indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir la taille d'échange disponible

Le composant utilise le webhook prebuilt_components_exchange_order:get_available_exchange_size pour récupérer les tailles disponibles à l'échange lorsque l'utilisateur souhaite échanger un article en raison de problèmes de taille ou d'ajustement.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans la requête API.

Nom du paramètre Description Format d'entrée
$flow.selected_order_product_id ID du produit que l'utilisateur souhaite échanger. chaîne

Paramètres de réponse de l'API

Les paramètres suivants sont extraits de la réponse de l'API et utilisés par le composant.

Nom du paramètre Description Format de sortie
product_available_sizes Liste des tailles disponibles pour le produit sélectionné. Liste (chaîne)

Pour configurer le webhook d'échange de taille disponible pour ce composant, développez les 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_exchange_order:get_available_exchange_size.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir la disponibilité de l'échange de produits

Le webhook prebuilt_components_exchange_order:get_product_exchange_availability permet de vérifier si le produit, la quantité et la taille facultative sélectionnés par l'utilisateur sont disponibles pour l'échange.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans la requête API.

Nom du paramètre Description Format d'entrée
$flow.order_id ID de commande pour lequel vous souhaitez obtenir des informations. chaîne
$flow.selected_order_product_id ID du produit que l'utilisateur souhaite échanger. chaîne
$flow.order_product_quantity_exchange_count Quantité du produit que l'utilisateur souhaite échanger. entier
$flow.product_selected_size Taille du produit que l'utilisateur souhaite échanger. chaîne

Paramètres de réponse de l'API

Les paramètres suivants sont extraits de la réponse de l'API et utilisés par le composant.

Nom du paramètre Description Format de sortie
product_exchange_availability Indique si le produit, la quantité et la taille sélectionnés peuvent être échangés. boolean
product_exchange_price Indique le prix d'échange d'un seul article du produit et de la taille sélectionnés. Nombre

Pour configurer le webhook "Obtenir la disponibilité de l'échange de produits" pour ce composant, développez les 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_Exchange_order:get_product_Exchange_availability.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Envoyer une demande d'assistance pour une commande incomplète

Le webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket permet au composant de générer une demande lorsque l'utilisateur souhaite échanger un produit dans une commande, car celle-ci est incomplète.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. chaîne
$flow.order_id ID de commande pour lequel envoyer une demande d'assistance. chaîne
$flow.selected_order_product_id ID du produit que l'utilisateur souhaite échanger. chaîne
$flow.order_product_quantity_exchange_count Quantité du produit que l'utilisateur souhaite échanger. entier
$flow.order_product_exchange_reason La raison pour laquelle l'utilisateur souhaite échanger le produit. chaîne

Pour configurer le webhook de demande d'assistance de commande incomplète pour ce composant, développez la section correspondante 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_exchange_order:raise_incomplete_order_ticket.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Obtenir des informations sur le magasin

Le webhook prebuilt_components_exchange_order:get_store_details permet au composant de récupérer la liste des magasins à proximité du code postal fourni par l'utilisateur.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans la requête API.

Nom du paramètre Description Format d'entrée
$flux.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 et utilisés par le composant.

Nom du paramètre Description Format de sortie
store_id Liste des ID de magasins. Liste (chaîne)
store_address Liste des adresses de magasins correspondant à chaque élément de store_id. Liste (chaîne)

Pour configurer le webhook "Obtenir les détails du magasin" pour ce composant, développez les 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_Exchange_order:get_store_details.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Détails de la place de marché

Le webhook prebuilt_components_exchange_order:post_exchange_details est utilisé par le composant pour envoyer un échange.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. chaîne
$flow.order_id ID de commande pour lequel envoyer une demande d'assistance. chaîne
$flow.selected_order_product_id ID du produit que l'utilisateur souhaite échanger. chaîne
$flow.order_product_quantity_exchange_count Quantité du produit que l'utilisateur souhaite échanger. entier
$flow.product_selected_size Taille du produit que l'utilisateur souhaite échanger. chaîne
$flow.order_product_exchange_reason La raison pour laquelle l'utilisateur souhaite échanger le produit. chaîne
$flow.order_Exchange_location Mode sélectionné pour la place de marché. Les valeurs valides sont définies par l'entité prebuilt_components_exchange_order_location. chaîne
$flow.order_exchange_store_id ID du magasin sélectionné par l'utilisateur pour un échange de magasins. chaîne
mode_remboursement_commande $flow.order_refund_mode Le mode de paiement utilisé pour le remboursement, le cas échéant. Les valeurs valides sont définies par l'entité prebuilt_components_exchange_order_refund_mode. Si aucun remboursement n'est requis, cette valeur est de null. chaîne
$flow.total_refund_amount [montant_remboursable] Montant à rembourser, si le prix du produit échangeable est supérieur à celui du produit neuf. Si aucun remboursement n'est requis, cette valeur est de null. entier

Paramètres de réponse de l'API

Les paramètres suivants sont extraits de la réponse de l'API et utilisés par le composant.

Nom du paramètre Description Format de sortie
order_exchange_ticket_id ID de la demande d'échange pour l'échange envoyé. chaîne

Pour configurer le webhook des détails de l'échange de posts pour ce composant, développez les 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_exchange_order:post_Exchange_details.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Envoyer les informations sur le remboursement du COD

Le webhook prebuilt_components_exchange_order:send_COD_refund_information permet au composant d'envoyer à un utilisateur des informations de paiement liées aux places de marché.

Paramètres de requête API

Les paramètres suivants sont fournis par le composant en tant qu'entrées dans 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, qui permet d'identifier l'utilisateur, sans l'indicatif du pays. chaîne
$flow.order_id ID de commande pour lequel envoyer une demande d'assistance. chaîne
$flow.channel Canal spécifique auquel les informations doivent être envoyées. 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 d'envoi d'informations de remboursement COD pour ce composant, développez les 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_Exchange_order:send_COD_refund_information.
  7. Remplacez l'URL indiquée dans le champ URL du webhook Dialogflow 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 mettez à jour le corps de la requête pour qu'il crée le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration des réponses pour extraire des champs spécifiques de la réponse du webhook. Ne modifiez pas les noms des paramètres, car le composant en a besoin pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez les paramètres d'authentification et modifiez-les si nécessaire.
  11. Cliquez sur Enregistrer.

Exhaustivité

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