Composant prédéfini sur les fraudes et les litiges dans le commerce

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

  1. 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é.
  2. 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.
  3. 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.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Compilation.
  5. Cliquez sur le composant importé dans la section Flows (Flux).
  6. Cliquez sur la page de démarrage dans la section Pages.
  7. Cliquez sur la route true (vrai) sur la page d'accueil.
  8. Dans la fenêtre "Route", modifiez les valeurs des préréglages des paramètres si nécessaire.
  9. Cliquez sur Enregistrer.

Paramètres de sortie

Les paramètres de sortie sont des paramètres de session qui restent actifs après la 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)
e-mail 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 :

  1. Importez le composant prédéfini.
  2. 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.

  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_fraud_and_dispute_order:get_order_details.
  7. 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.
  8. Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez et modifiez les paramètres d'authentification 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 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.

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Sélectionnez l'onglet Gérer.
  5. Cliquez sur Webhooks.
  6. Sélectionnez le webhook prebuilt_components_retail_services:get_duplicate_order_details.
  7. Remplacez l'URL dans le champ URL du webhook 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.
  8. Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez et modifiez les paramètres d'authentification si nécessaire.
  11. 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.

  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_fraud_and_dispute_order:post_reporting_details.
  7. 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.
  8. Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez et modifiez les paramètres d'authentification si nécessaire.
  11. 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.

  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_fraud_and_dispute_order:send_message.
  7. 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.
  8. Examinez et mettez à jour le corps de la requête pour créer le format de requête approprié pour votre webhook.
  9. Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs de champ renvoyées.
  10. Vérifiez et modifiez les paramètres d'authentification si nécessaire.
  11. Cliquez sur Enregistrer.

Terminé

Le composant et ses webhooks sont maintenant configurés et prêts à être testés.