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 d'une commande et sélectionner des options, y compris les méthodes de remboursement et de livraison. 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 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.
É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 l'échange. L'utilisateur choisit d'échanger 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 commande la plus récente, qui se termine par 12375 et comprend deux lampes, deux Pixel et 10 autres produits, passée 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: Lampe LED Google. Veuillez indiquer le numéro de produit de l'article que vous souhaitez sélectionner ou dire "Suivant" pour afficher d'autres produits. |
|
| 1 | |
| Me confirmez-vous que vous souhaitez échanger la lampe Google ? Est-ce correct ? | |
| oui | |
| 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, "L'article est défectueux ou ne fonctionne pas", "Problème de taille ou d'ajustement", "Problème de commande incomplète", "Problème de style", "Couleur incorrecte" ou autre. | |
| Article défectueux | |
| Merci de nous en avoir informé. Pour terminer, comment souhaitez-vous procéder à l'échange ? Vous pouvez dire, par exemple, "Échanger en magasin" ou "Planifier un retrait". |
|
| Je souhaite échanger un article en magasin | |
| Trouvons un magasin à proximité. | |
| L'agent collecte le code postal à l'aide du composant prédéfini Collecte du code postal. | |
| Voici la liste des établissements à 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. Veuillez indiquer le numéro de l'adresse que vous souhaitez sélectionner ou dire "suivant" pour afficher d'autres adresses de magasins. |
|
| 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 demande à votre numéro de téléphone et à votre adresse e-mail enregistrés. Veuillez l'imprimer, le joindre à votre colis et déposer votre échange dans un délai de 30 jours. Une fois l'article réceptionné dans nos entrepôts, il faudra trois à cinq jours ouvrés pour que votre échange, le cas échéant, apparaisse dans votre compte. Remarque: Le montant du remboursement n'inclut pas les frais de port et de traitement. Votre produit d'échange est plus cher. La différence de prix est de 20$. Vous recevrez bientôt le lien de paiement sur votre numéro de téléphone mobile enregistré. Veuillez effectuer le paiement sous 24 heures pour effectuer l'échange. Souhaitez-vous échanger une autre commande ? |
|
| non, c'est tout | |
| 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, le produit à échanger et le motif de l'échange. L'utilisateur choisit d'échanger les articles pour une taille différente et planifie un retrait. L'agent constate que l'article échangé est moins cher que le nouvel article et confirme avec l'utilisateur le mode de paiement pour le remboursement.
| 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 deux lampes passée le 10/11/2023 ? | |
| Non | |
| Souhaitez-vous échanger une autre commande ? | |
| Oui | |
| Pourriez-vous nous communiquer les cinq derniers chiffres de l\'ID de 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 récupéré 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 indiquer ou saisir le numéro de produit de l'article que vous souhaitez sélectionner, ou dire "Suivant" pour afficher d'autres produits. |
|
| Deux | |
| Me confirmez-vous que vous souhaitez échanger le t-shirt Google ? Est-ce correct ? | |
| Oui | |
| Veuillez indiquer le motif de l'échange. Vous pouvez dire, par exemple, "L'article est défectueux ou ne fonctionne pas", "Problème de taille ou d'ajustement", "Problème de commande incomplète", "Problème de style", "Couleur incorrecte" ou autre. | |
| Problème de taille ou de compatibilité | |
| Merci de nous avoir indiqué le motif de l'échange. Pouvez-vous nous indiquer la taille que vous souhaitez échanger ? Les tailles suivantes sont disponibles: Indiquez 1 pour la taille S. Indiquez 2 pour la taille M. Indiquez 3 pour la taille L. Indiquez 4 pour la taille XL. Indiquez 5 pour la taille XXL. |
|
| 1 | |
| Pour terminer, comment souhaitez-vous échanger le produit ? Vous pouvez dire, par exemple, "Échanger en magasin" ou "Planifier un retrait". | |
| Programmer le retrait | |
| Parfait. Nous avons envoyé une étiquette de livraison à votre adresse e-mail et à votre numéro de téléphone enregistrés. Veuillez l'imprimer et le joindre à votre colis. Notre équipe vous contactera dans un délai de 24 à 48 heures pour planifier le retrait. Une fois l'article reçu à notre entrepôt, le remboursement de votre échange apparaîtra dans votre compte sous trois à cinq jours ouvrés. Votre produit échangé est moins cher et vous pouvez recevoir un remboursement de 5$. Veuillez nous indiquer où vous souhaitez recevoir votre remboursement. Vous pouvez par exemple dire "crédit Google Store" ou "compte source". |
|
| Crédit Google Store | |
| Merci d'avoir confirmé que vous souhaitez que votre remboursement soit crédité sur votre portefeuille. Souhaitez-vous échanger une autre commande ? |
|
| non | |
| 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 n'est éligible à l'échange. L'agent demande un numéro de commande à l'utilisateur et constate qu'aucun produit éligible n'est associé à la commande fournie.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Aucun produit de votre dernière commande n'est éligible à l'échange. Souhaitez-vous échanger une autre commande ? |
|
| oui | |
| Pourriez-vous nous communiquer les cinq derniers chiffres de l\'ID de 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 collecter l'ID de commande. | |
| Malheureusement, aucun produit de votre commande n'est éligible à un échange conformément à nos règles. Pour en savoir plus sur nos conditions d'échange, consultez notre site Web. Souhaitez-vous échanger une autre commande ? |
|
| non | |
| 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] | É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 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 |
| $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) 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 | Indique le nombre de nouvelles 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 indiquez 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 à 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 de commande complet dans le cas où 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 la raison 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é la raison d'échange "Autre". La valeur par défaut est "others". |
chaîne |
| $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_product_exchange_confirm | Indique 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_product_number_counter | Indique 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 | Indique le nombre maximal de nouvelles tentatives autorisées lors de la sélection de la quantité de produit à échanger. La valeur par défaut est 2. |
entier |
| $flow.max_retry_size_number_counter | Spécifie le nombre maximal de nouvelles tentatives autorisées lors de la sélection de la taille à échanger. 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.max_store_display_counter | Indique le nombre maximal de magasins à présenter dans un seul virage. La valeur par défaut est 1. |
entier |
| $flow.max_store_display | Spécifie le nombre maximal de magasins à présenter pendant toute la conversation. La valeur par défaut est 10. |
entier |
| $flow.max_retry_store_number_counter | Spécifie le nombre maximal de nouvelles 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 3. |
entier |
| $flow.max_available_address_reselection_counter | Indique le nombre de nouvelles 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ée par le webhook get_order_details, qui indique un mode de paiement contre remboursement. 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_exchange_order_refund_mode 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_exchange_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'un retrait pour l'échange. 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.
- 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 |
| 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) |
| 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 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.
Questions fréquentes
Le générateur FAQ permet de répondre aux questions fréquentes sur les retours et les échanges, y compris:
- 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:
- 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.
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 la section Configurer le webhook d'authentification pour les marchands.
Obtenir les détails des commandes
Le webhook prebuilt_components_exchange_order:get_order_details est utilisé par le composant pour récupérer les détails de la commande pour une commande spécifiée.
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.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 être utilisés par le composant.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| order_date | 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 |
| exchangeable_product_id | Liste des ID des produits échangeables dans la commande. | Liste (chaîne) |
| exchangeable_product_name | Liste des noms des produits échangeables dans la commande. | Liste (chaîne) |
| exchangeable_product_brand_name | Liste des noms de marques des 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 dans la commande. | Liste (chaîne) |
Pour configurer le webhook "Get order details" (Obtenir les détails de la commande) 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_exchange_order:get_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 pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- 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 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 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 être 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 dans le 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 dans le tableau all_order_date. |
Liste (chaîne) |
Pour configurer le webhook "Get duplicate order details" (Obtenir les détails des commandes en double) 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_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 pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Obtenir la taille d'échange disponible
Le webhook prebuilt_components_exchange_order:get_available_exchange_size est utilisé par le composant pour récupérer les tailles disponibles à échanger lorsque l'utilisateur souhaite échanger un article en raison de problèmes de taille ou d'ajustement.
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.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 pour être 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 "Get available exchange size" (Obtenir la taille d'échange disponible) 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_exchange_order:get_available_exchange_size.
- 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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Obtenir la disponibilité d'un échange de produits
Le webhook prebuilt_components_exchange_order:get_product_exchange_availability est utilisé par le composant pour vérifier si le produit, la quantité et la taille facultative sélectionnés par l'utilisateur sont disponibles à l'échange.
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.order_id | ID de commande pour lequel vous souhaitez récupérer les détails. | 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 pour être 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 sont disponibles pour l'échange. | booléen |
| 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 "Get product exchange availability" (Obtenir la disponibilité des échanges de produits) 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_exchange_order:get_product_exchange_availability.
- 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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Créer une demande de commande incomplète
Le webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket est utilisé par le composant pour créer une demande lorsque l'utilisateur souhaite échanger un produit dans une commande en raison de son incomplétude.
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.order_id | ID de commande pour laquelle vous souhaitez 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 | Motif pour lequel l'utilisateur souhaite échanger le produit. | chaîne |
Pour configurer le webhook "Raise incomplete order ticket" (Signaler une demande d'assistance incomplète) 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_exchange_order:raise_incomplete_order_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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Obtenir les détails d'un magasin
Le webhook prebuilt_components_exchange_order:get_store_details est utilisé par le composant pour récupérer la liste des magasins à proximité du code postal fourni 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 être 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 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.
- 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_exchange_order:get_store_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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Détails de l'échange de posts
Le webhook prebuilt_components_exchange_order:post_exchange_details est utilisé par le composant pour envoyer un échange.
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.order_id | ID de commande pour laquelle vous souhaitez 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 | Motif pour lequel l'utilisateur souhaite échanger le produit. | chaîne |
| $flow.order_exchange_location | Mode sélectionné pour l'échange. 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 en magasin. | chaîne |
| $flow.order_refund_mode | Mode de paiement 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 null. |
chaîne |
| $flow.total_refund_amount | Montant à rembourser si le prix du produit éligible à l'échange est supérieur à celui du nouveau produit. Si aucun remboursement n'est requis, cette valeur est null. |
entier |
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 |
|---|---|---|
| order_exchange_ticket_id | ID de la demande d'échange envoyée. | chaîne |
Pour configurer le webhook Post exchange details de ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook prebuilt_components_exchange_order:post_exchange_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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Envoyer des informations de remboursement pour les paiements en espèces
Le webhook prebuilt_components_exchange_order:send_COD_refund_information est utilisé par le composant pour envoyer des informations de paiement liées à l'échange à un 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.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 de remboursement en espèces" 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_exchange_order:send_COD_refund_information.
- 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 créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs 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.