Le composant prédéfini de fraude et de litige dans le commerce permet à un utilisateur de s'authentifier. Une fois l'utilisateur authentifié, le composant fournit des informations sur ses commandes les plus récentes ou passées, et lui permet d'envoyer une contestation concernant une commande ou un produit. Ce composant utilise le composant prédéfini Retail authentication (Authentification Retail) pour permettre à l'utilisateur de s'authentifier. Le composant utilise également des générateurs pour le résumé post-appel.
Limites
En plus des limites communes des composants prédéfinis, ce composant prédéfini présente les limites suivantes :
- Ce composant ne chiffre aucune donnée.
Exemples de dialogues
Les exemples de boîtes de dialogue suivants illustrent des scénarios courants gérés par ce composant prédéfini. Ils illustrent ce qui se passe lorsque la téléphonie lance le composant, ce qui déclenche l'intent de bienvenue par défaut et la première réponse de l'agent au début de la conversation.
Contestation pour un produit individuel
- Si l'utilisateur n'a pas été authentifié précédemment, l'agent collecte des informations sur ses commandes précédentes pour vérifier son identité.
- Après l'authentification, l'agent collecte des informations sur la contestation, y compris le motif de la contestation et le produit spécifique que l'utilisateur souhaite contester.
- L'agent envoie la contestation et fournit le numéro de confirmation.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bonjour, John. Pour valider votre identité, nous aurons besoin de l'ID de commande, de la date de la transaction et du montant avant de déposer votre demande de contestation ou de fraude. | |
| Pourriez-vous me fournir les cinq derniers chiffres de votre ID de commande ? | |
| 12345 | |
| Les cinq derniers chiffres de l'ID de commande que nous avons reçu sont 12345. Est-ce correct ? | |
| oui | |
| Nous avons bien enregistré l'ID de commande. Veuillez indiquer la date de la commande. Veuillez indiquer le mois, le jour, puis l'année de votre commande. |
|
| 2023-10-12 | |
| Votre commande date du 12 octobre 2023, c'est bien ça ? | |
| oui | |
| Nous avons bien enregistré la date de votre commande. Veuillez nous indiquer le montant de votre commande en dollars. Par exemple, si le montant de votre transaction est de 100,30 €, dites "100". |
|
| 97 | |
| D'accord. Le montant de votre commande est de 97 $. Est-ce bien cela ? | |
| oui | |
| Veuillez préciser la nature de la fraude ou du litige que vous souhaitez signaler. Vous pouvez dire, par exemple : paiements ou facturation, produit, retours et remboursement, sécurité des données ou confidentialité, livraison ou expédition, emballage, ou "autre". | |
| produit | |
| Merci de nous avoir prévenus. Pour confirmer, le motif de la fraude ou de la contestation est le produit. Est-ce correct ? | |
| oui | |
| Veuillez nous indiquer si le problème sélectionné concerne une commande entière, un produit individuel ou autre chose. | |
| produit | |
| Appelez-vous au sujet de votre commande la plus récente, dont le numéro se termine par 12345, contenant 2 lampes, 1 chemise et 1 autre produit, passée le 10/11/2023 à 18h00 ? | |
| oui | |
| Nous avons trouvé des produits dans votre commande. Veuillez nous indiquer le produit que vous souhaitez signaler. Produit 1 : lampe Google, Produit 2 : t-shirt Google, Produit 3 : jean Google. Veuillez dire ou saisir le numéro du produit que vous souhaitez sélectionner, ou dites "suivant" pour afficher d'autres produits. |
|
| 3 | |
| Pour confirmer, vous souhaitez signaler un cas de fraude ou de litige concernant les jeans Google. Est-ce correct ? | |
| oui | |
| En quelques mots, veuillez nous expliquer en détail la raison de cette fraude ou de cette contestation. | |
| mauvaise qualité | |
| Pour confirmer, le motif de fraude ou de contestation fourni est de mauvaise qualité. Est-ce correct ? | |
| oui | |
| Merci pour votre confirmation. Nous avons envoyé un ticket à notre équipe chargée des fraudes ou des litiges. Il devrait vous recontacter rapidement. Votre numéro de demande est le 6595513. Voulez-vous que je répète le numéro de confirmation ? |
|
| oui | |
| Votre numéro de ticket est le 6595513. Souhaitez-vous que nous vous envoyions un message de confirmation contenant le numéro de ticket ? |
|
| oui | |
| Souhaitez-vous recevoir votre message de confirmation par téléphone ou par e-mail ? | |
| téléphone | |
| Juste pour confirmer, souhaitez-vous recevoir le message de confirmation sur votre téléphone ? Veuillez dire "Oui" ou "Non". | |
| oui | |
| Merci. Un message de confirmation a été envoyé à votre téléphone enregistré. Cela peut prendre un certain temps. Voulez-vous signaler une fraude ou contester une autre commande ? |
|
| non | |
| Merci de nous avoir appelés. Notre équipe assurera le suivi de votre demande. |
Conventions d'attribution de noms
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes :
| Fonctionnalité | Format | Exemple |
|---|---|---|
| Flow | [Component Name] | Fraude et contestation |
| Type d'entité | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_dispute_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_fraud_and_dispute_order:get_security_answers |
Paramètres d'entrée
Les paramètres d'entrée configurent certains comportements du composant. Une ou plusieurs conditions du flux utilisent ces paramètres pour déterminer le comportement du composant. Vous devez définir des paramètres limités au flux sur la page de démarrage du composant, comme décrit ci-dessous. Vous pouvez définir des paramètres de portée session à l'aide d'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 identifier l'utilisateur. | string |
| $session.params.all_recent_order_id | (Facultatif) Liste des ID de commande associés à l'utilisateur authentifié, triés par date de commande dans l'ordre décroissant. Le premier élément du tableau représente la commande la plus récente. Si l'utilisateur authentifié n'a pas de commande, la valeur de ce paramètre est null. |
Liste (chaîne) |
| $session.params.email | (Facultatif) L'adresse e-mail enregistrée avec le compte. | string |
| $session.params.user_first_name | (Facultatif) Prénom de l'utilisateur, utilisé pour l'accueillir et confirmer qu'il est bien le propriétaire du compte. | string |
Ce composant prédéfini vous permet d'utiliser les paramètres facultatifs suivants pour configurer le comportement du composant, y compris les nouvelles tentatives :
| Nom du paramètre | Description | Format |
|---|---|---|
| $flow.max_retry_another_account_counter | Spécifie le nombre de tentatives autorisées lorsque l'utilisateur choisit de continuer avec un autre compte. La valeur par défaut est 2. |
entier |
| $flow.max_retry_telephone_number | Spécifie le nombre de tentatives autorisées lors de la saisie d'un numéro de téléphone enregistré. La valeur par défaut est 2. |
entier |
| $flow.max_retry_order_number | Spécifie le nombre de tentatives autorisées pour fournir les cinq derniers chiffres d'un numéro de commande. La valeur par défaut est 2. |
entier |
| $flow.max_retry_another_order | Spécifie le nombre de tentatives autorisées lors de la sélection d'une autre commande à retourner si l'ID de commande est introuvable 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 l'utilisateur fournit le numéro de commande complet dans les cas où plusieurs commandes partagent les cinq mêmes derniers chiffres. La valeur par défaut est 2. |
entier |
| $flow.max_product_display_counter | Spécifie 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 au cours de l'ensemble de 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_report_confirm | Spécifie le nombre maximal de tentatives autorisées lors de la confirmation du produit sélectionné. La valeur par défaut est 2. |
entier |
| $flow.max_retry_dispute_reason | Spécifie le nombre de tentatives autorisées lors de la confirmation du motif de la contestation. La valeur par défaut est 2. |
entier |
Pour configurer les paramètres d'entrée 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 Compilation.
- Cliquez sur le composant importé dans la section Flows (Flux).
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vrai) sur la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs des préréglages des 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 le code pays, utilisé pour identifier l'utilisateur. | string |
| all_recent_order_id | Liste des ID de commande associés à l'utilisateur authentifié, triés par date de 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) |
| L'adresse e-mail enregistrée avec le compte. | string | |
| user_first_name | Prénom de l'utilisateur, utilisé pour l'accueillir et confirmer qu'il est bien le propriétaire du compte. | string |
| dispute_ticket_id | ID de la demande de contestation envoyée. | string |
| transfer_reason | 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 a demandé un agent humain à un moment donné de la conversation.denial_of_information : l'utilisateur a refusé de partager les informations demandées par le composant.max_no_input : la conversation a atteint le nombre maximal de nouvelles tentatives pour les événements sans entrée. Consultez Événements intégrés sans entrée.max_no_match : la conversation a atteint le nombre maximal de nouvelles tentatives pour les événements sans correspondance. Consultez É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 était inaccessible. Consultez Événement intégré webhook.error.not-found. |
string |
Générateurs
Ce composant utilise des générateurs pour activer des parties spécifiques de la conversation.
Synthèse
Le générateur Summarization crée un résumé après l'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. Consultez Configuration des webhooks.
Configuration du webhook
Pour utiliser ce composant, configurez les webhooks flexibles inclus afin de 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, configurez-les pour permettre l'authentification des utilisateurs pour ce composant. Pour en savoir plus sur la configuration du webhook, consultez Configurer le webhook de validation des informations utilisateur pour configurer le webhook prebuilt_components_retail_authentication:verify_user_details.
Obtenir les détails des commandes
Le composant utilise le webhook prebuilt_components_fraud_and_dispute_order:get_order_details pour récupérer les détails d'une commande spécifiée.
Paramètres de requête API
Le composant fournit les paramètres suivants en tant qu'entrées de la requête API :
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $flow.order_id | ID de la commande pour laquelle récupérer les détails. | string |
Paramètres de réponse de l'API
Le composant récupère les paramètres suivants à partir de la réponse de l'API :
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| order_date | Date à laquelle la commande a été passée, au format YYYY-MM-DD. |
string |
| order_time | Date et heure auxquelles la commande a été passée, au format HH:MM. |
string |
| order_product_count | Nombre de produits uniques dans la commande. | entier |
| order_amount | Montant total de la commande en dollars. | entier |
| order_payment_mode | Indique le mode de paiement utilisé lors de la commande. | string |
| all_product_id | Liste des identifiants produit de tous les produits de la commande. | Liste (chaîne) |
| all_product_name | Liste des noms de tous les produits de la commande. | Liste (chaîne) |
| all_product_brand_name | Liste des noms de marque de tous les produits de la commande. | Liste (chaîne) |
| all_product_quantity | Liste des quantités pour tous les produits de la commande. | Liste (chaîne) |
Pour configurer le webhook "Obtenir les détails de la commande" pour ce composant, développez pour afficher les 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_fraud_and_dispute_order:get_order_details.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour 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 de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- 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 permettant de distinguer les commandes lorsque plusieurs numéros de commande ont les cinq mêmes derniers chiffres.
Paramètres de requête API
Le composant fournit les paramètres suivants 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
Le composant récupère les paramètres suivants à partir de la réponse de l'API :
| 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 "Obtenir les détails d'une commande en double" pour ce composant, développez pour afficher les 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 de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour 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 de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Détails du reporting post-diffusion
Le composant utilise le webhook prebuilt_components_fraud_and_dispute_order:post_reporting_details pour envoyer un ticket de fraude ou de litige.
Paramètres de requête API
Le composant fournit les paramètres suivants 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, utilisé pour identifier l'utilisateur. | string |
| $flow.order_id | ID de commande (Order ID) pour laquelle vous souhaitez envoyer une demande d'assistance. | string |
| $flow.dispute_product_id | ID du produit pour lequel l'utilisateur souhaite déposer une contestation. | string |
| $flow.order_product_dispute_reason | Motifs de contestation pour le produit contesté. Les valeurs valides sont définies par l'entité prebuilt_components_product_dispute_reason. |
string |
| $flow.order_product_dispute_reason_other | Si l'utilisateur a sélectionné "Autres" comme motif de contestation, ce champ contient le motif spécifique fourni par l'utilisateur. | string |
| $flow.order_product_dispute_reason_detail | Motif détaillé de la contestation. | string |
Paramètres de réponse de l'API
Le composant récupère les paramètres suivants à partir de la réponse de l'API :
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| order_product_dispute_ticket_number | ID de la demande de contestation envoyée. | string |
Pour configurer le webhook "Post reporting details" pour ce composant, développez la section afin d'afficher les 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_fraud_and_dispute_order:post_reporting_details.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour 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 de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Envoyer un message
Le composant utilise le webhook prebuilt_components_fraud_and_dispute_order:send_message pour envoyer à l'utilisateur des informations de confirmation concernant la contestation.
Paramètres de requête API
Le composant fournit les paramètres suivants 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, utilisé pour identifier l'utilisateur. | string |
| $flow.order_product_dispute_ticket_number | Numéro de confirmation de la contestation envoyée. | string |
| $flow.confirmation_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 acceptés. |
string |
Pour configurer le webhook "Envoyer un message" 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_fraud_and_dispute_order:send_message.
- Remplacez l'URL dans le champ URL du webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et mettez à jour 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 de champ renvoyées.
- Vérifiez et modifiez les paramètres d'authentification si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Le composant et ses webhooks sont maintenant configurés et prêts à être testés.