Composant prédéfini de la fiche de verrouillage

Le composant prédéfini de blocage de carte authentifie l'utilisateur, récupère les cartes enregistrées pour l'utilisateur et lui permet de bloquer une carte temporairement, de bloquer une carte de manière permanente ou de réactiver une carte. Après avoir confirmé qu'une carte est verrouillée, le composant permet à l'utilisateur d'en demander une nouvelle.

Ce composant utilise une version personnalisée du composant prédéfini Authentication (Authentification) pour authentifier les titulaires de carte.

Limites

Outre les 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 dialogues

Les exemples de boîtes de dialogue illustrent des scénarios courants gérés par ce composant prédéfini. Ils illustrent le comportement lorsque l'utilisateur appelle le composant par téléphone, 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.

Utilisateur non authentifié avec plusieurs cartes

  1. L'agent identifie que l'utilisateur n'est pas encore authentifié et collecte des informations pour vérifier qu'il est un titulaire de carte enregistré.
  2. Une fois l'utilisateur authentifié, l'agent récupère les informations sur les cartes enregistrées pour l'utilisateur.
  3. L'utilisateur confirme qu'il souhaite verrouiller temporairement une carte sélectionnée.
  4. L'agent génère la demande de blocage de la carte.
Entrée utilisateur Réponse de l'agent
L'agent authentifie l'utilisateur à l'aide du composant prédéfini Authentication.
Merci, vous avez bien été authentifié.
Veuillez patienter pendant que nous récupérons les informations de votre carte.

Nous avons trouvé plusieurs cartes enregistrées avec votre numéro. Nous avons une carte Visa se terminant par 5555, une carte Visa se terminant par 6666, une carte MasterCard se terminant par 4444 et une carte MasterCard se terminant par 4449.

Veuillez nous indiquer les quatre derniers chiffres de la carte que vous souhaitez bloquer ou réactiver.
4444
Les quatre derniers chiffres du numéro de carte que nous avons sont 4444. Est-ce correct ?
Oui
Voulez-vous verrouiller votre carte temporairement ou définitivement ?
Je veux le verrouiller temporairement
Veuillez nous indiquer pourquoi vous verrouillez votre carte. Vous pouvez choisir parmi des options telles que "Endommagé", "Volé", "Perdu" ou d'autres.
Il a été endommagé
Désolé de l'apprendre. Pour des raisons de sécurité, nous devons valider votre identité. Nous allons donc vous envoyer un code. Préférez-vous recevoir le code par téléphone ou par e-mail ?
Envoyer vers mon téléphone
Avant de continuer, nous allons envoyer un code au numéro de mobile enregistré. Pouvez-vous confirmer votre code pour valider la demande ?
123456
D'accord, votre carte se terminant par 4444 va être temporairement bloquée. Une fois la carte verrouillée, vous ne pourrez plus l'utiliser pour effectuer des transactions en ligne ou sur des terminaux de paiement. Confirmez-vous cette action ?
Oui
Votre carte a bien été verrouillée. Votre numéro de demande est le 9711485. Il a bien été envoyé au numéro de mobile enregistré.

Utilisateur authentifié avec une seule carte

  1. L'agent identifie que l'utilisateur a déjà été authentifié et récupère les informations sur la carte enregistrée pour l'utilisateur.
  2. L'utilisateur choisit de verrouiller définitivement la carte.
  3. L'agent génère la demande de blocage définitif de la carte.
  4. L'agent demande ensuite à l'utilisateur s'il souhaite réémettre une carte pour remplacer celle qui est définitivement bloquée, puis crée une demande de réémission de la carte.
Entrée utilisateur Réponse de l'agent
Veuillez patienter pendant que nous récupérons les informations de votre carte.

Nous avons trouvé votre MasterCard se terminant par 4444. Voulez-vous verrouiller votre carte temporairement ou définitivement ?
Définitivement
Veuillez nous indiquer pourquoi vous verrouillez votre carte. Vous pouvez choisir parmi des options telles que "Endommagé", "Volé", "Perdu" ou d'autres.
Il a été endommagé
Désolé de l'apprendre. Ne vous inquiétez pas, nous allons verrouiller définitivement votre carte. Pouvez-vous confirmer que le numéro de la carte se termine par 4444 ?
Oui
Avant de continuer, nous allons envoyer un code au numéro de mobile enregistré. Pouvez-vous confirmer votre code pour valider la demande ?
123456
D'accord, votre carte se terminant par 4444 va être temporairement bloquée. Une fois la carte verrouillée, vous ne pourrez plus l'utiliser pour effectuer des transactions en ligne ou sur des terminaux de paiement. Confirmez-vous cette action ?
Oui
Votre carte a bien été verrouillée. Votre numéro de demande est le 6108410. Il a bien été envoyé au numéro de mobile enregistré.

Voulez-vous demander une nouvelle carte ?
Oui
Nous livrerons la carte à l'adresse que vous avez enregistrée. Pouvez-vous confirmer que le code postal de votre adresse de livraison est 12345 ?
Bonne réponse
D'accord, veuillez patienter quelques secondes pendant que nous envoyons la demande de réémission d'une nouvelle carte.

La demande de réémission de la nouvelle carte a bien été envoyée. Votre numéro de demande est le 3808109. Il a bien été envoyé au numéro de mobile enregistré.

La carte sera livrée à l'adresse enregistrée sous trois jours ouvrés. Pour utiliser la carte, veuillez suivre les instructions fournies avec celle-ci.

Réactiver la carte

  1. L'agent identifie que l'utilisateur a besoin d'une authentification supplémentaire et lui envoie un mot de passe à usage unique pour vérifier son identité.
  2. L'utilisateur demande à réactiver une carte.
  3. L'agent transfère l'utilisateur vers un agent humain pour continuer.
Entrée utilisateur Réponse de l'agent
Pour des raisons de sécurité, nous devons valider votre identité. Nous allons donc vous envoyer un code. Préférez-vous recevoir le code par téléphone ?
Oui
Nous avons envoyé un code au numéro de téléphone enregistré se terminant par 5041. Cette opération peut prendre quelques secondes. Pouvez-vous confirmer le code ?
123456
Merci, vous avez été validé.

Veuillez patienter pendant que nous récupérons les informations de votre carte.

Nous avons trouvé plusieurs cartes enregistrées avec votre numéro. Nous avons une carte Visa se terminant par 1456, une MasterCard se terminant par 1457, une American Express se terminant par 1345 et une Visa se terminant par 3456.

Veuillez nous indiquer les quatre derniers chiffres de la carte que vous souhaitez bloquer ou réactiver.
1456
Les quatre derniers chiffres du numéro de carte que nous avons sont 1456. Est-ce correct ?
Oui
La carte demandée est déjà verrouillée temporairement. Voulez-vous réactiver la carte ou la bloquer définitivement ?
Réactivez-le
Veuillez patienter pendant que nous transférons votre appel afin de mieux vous aider.

Conventions d'attribution de noms

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

Fonctionnalité Format Exemple
Flow [Component Name] Verrouiller la carte
Type d'entité prebuilt_components_[component_name]_[entity_type] prebuilt_components_lock_card_locked_reason
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_lock_card:lock_card_ticket_number

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. 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.auth_level (Facultatif) Indique le niveau d'authentification de l'appelant. entier
$session.params.auth_level_req Indique le niveau d'authentification requis pour que l'utilisateur puisse accéder aux informations de sa carte. Cette valeur est configurée dans les préréglages des paramètres du fulfillment d'entrée de page sur la page check auth level. La valeur par défaut est 1. entier
$session.params.account_auth_enabled Indique si l'utilisateur doit être authentifié en tant que titulaire du compte, comme décrit dans Types d'authentification. Cette valeur est configurée dans les préréglages des paramètres du fulfillment d'entrée de page sur la page check auth level. La valeur par défaut est false. booléen
$session.params.card_auth_enabled Indique si l'utilisateur doit être authentifié en tant que titulaire de la carte, comme décrit dans Types d'authentification. Cette valeur est configurée dans les préréglages des paramètres du fulfillment d'entrée de page sur la page check auth level. La valeur par défaut est true. booléen
$session.params.phone_number (Facultatif) Numéro de téléphone enregistré du client utilisé pour l'authentification. string
$session.params.card_count (Facultatif) Nombre de cartes de crédit associées à l'utilisateur authentifié. entier
$flow.card_status_active Spécifie la valeur du paramètre renvoyé par le webhook de validation de la carte pour indiquer que la carte sélectionnée est actuellement active. La valeur par défaut est "active". string
$flow.card_status_lock_temp Spécifie la valeur du paramètre renvoyé par le webhook de validation de la carte pour indiquer que la carte sélectionnée est temporairement verrouillée. La valeur par défaut est "inactive". string
$flow.card_status_lock_permanent Spécifie la valeur du paramètre renvoyé par le webhook de validation de la carte pour indiquer que la carte sélectionnée est verrouillée de manière permanente. La valeur par défaut est "blocked". string
$flow.card_status_reactivate Spécifie la valeur du paramètre renvoyé par le webhook de validation de la carte pour indiquer que la carte sélectionnée est réactivée. La valeur par défaut est "reactivate". string
$flow.max_retry_card_number Spécifie le nombre de tentatives autorisées lors de la collecte des quatre derniers chiffres de la carte de crédit. La valeur par défaut est 3. entier
$flow.max_otp_retry_count Spécifie le nombre de tentatives autorisées lors de la collecte du mot de passe à usage unique auprès de l'utilisateur. La valeur par défaut est 3. 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 Build (Créer).
  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 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
auth_level Indique le niveau d'authentification de l'appelant. entier
phone_number Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour identifier l'utilisateur. string
card_count Nombre de cartes associées au numéro de téléphone enregistré de l'utilisateur. entier
last_four_digit_of_card_number Si l'utilisateur ne possède qu'une seule carte, les quatre derniers chiffres du numéro de carte sont renvoyés. Si l'utilisateur possède plusieurs cartes, la valeur de ce paramètre correspond aux quatre derniers chiffres de la carte qu'il a sélectionnée pour la bloquer ou la réémettre. 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

Configuration de base

Pour configurer ce composant prédéfini :

  1. Importez le composant prédéfini.
  2. Configurez les webhooks flexibles fournis avec les paramètres décrivant vos services externes. Pour en savoir plus, consultez la section Configuration du webhook.

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 configuré les services externes requis pour l'authentification, configurez-les pour permettre l'authentification des utilisateurs pour ce composant. Pour en savoir plus, consultez le guide Configurer un webhook d'authentification.

Obtenir les informations de la carte

Le webhook prebuilt_components_account_services:get_card_details permet au composant de récupérer des informations sur les cartes enregistrées par l'utilisateur.

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

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
last_four_digit_of_all_cards Liste contenant les quatre derniers chiffres de chaque carte enregistrée pour l'utilisateur, par exemple ["0000", "1111", "2222"]. Chaque élément de cette liste représente la même carte que l'élément ayant le même index dans card_vendor_all. Liste (chaîne)
card_vendor_all Liste contenant l'émetteur de chaque carte de crédit enregistrée pour l'utilisateur, par exemple ["Visa", "Mastercard", "Discover"]. Chaque élément de cette liste représente la même carte que l'élément ayant le même index dans last_four_digit_of_all_cards. Liste (chaîne)
card_count Nombre de cartes associées à l'utilisateur authentifié. entier

Pour configurer le webhook "Obtenir les détails de la carte" 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_account_services:get_card_details.
  7. Remplacez l'URL du 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.

Valider la carte

Le composant utilise le webhook prebuilt_components_lock_card:validate_card pour récupérer des informations sur une carte spécifique enregistrée dans le compte de l'utilisateur.

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
$session.params.last_four_digit_of_card_number Les quatre derniers chiffres du numéro de carte que l'utilisateur a demandé de verrouiller. 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
zip_code Code postal de l'adresse enregistrée de l'utilisateur. string
card_vendor Émetteur de la carte de crédit sélectionnée. string
card_status Indique l'état actuel de la carte. Par défaut, les valeurs valides sont "active", "temporarily blocked" ou "permanently blocked". Ces états sont spécifiés par les paramètres $flow.card_status_active, $flow.card_status_lock_temp et $flow.card_status_lock_permanent. Consultez la section Paramètres d'entrée. string

Pour configurer le webhook de validation de carte 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_lock_card:validate_card.
  7. Remplacez l'URL du 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.

Verrouiller la carte

Le webhook prebuilt_components_lock_card:lock_card_ticket_number permet au composant de créer une requête pour verrouiller une carte sélectionné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
$session.params.phone_number Numéro de téléphone local de l'utilisateur, sans le code pays, utilisé pour identifier l'utilisateur. string
$session.params.last_four_digit_of_card_number Les quatre derniers chiffres du numéro de carte que l'utilisateur a demandé de verrouiller. string
$flow.lock_type Indique le type de verrouillage à appliquer à la carte de l'utilisateur. Les valeurs valides sont définies par l'entité personnalisée prebuilt_components_lock_card_lock_type_active. Par défaut, "blocked" (verrouillage permanent) et "inactive" (verrouillage temporaire) sont acceptés. string
$flow.lock_reason Indique la raison pour laquelle l'utilisateur a demandé le verrouillage de la carte. Les valeurs valides sont définies par l'entité personnalisée prebuilt_components_lock_card_locked_reason. Par défaut, "damaged", "stolen", "lost" et "others" sont acceptés. 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
ticket_number Numéro de ticket de la demande de blocage de carte créée. entier

Pour configurer le webhook de verrouillage de carte 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_lock_card:lock_card_ticket_number.
  7. Remplacez l'URL du 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.

Réémettre la carte

Le webhook prebuilt_components_lock_card:reissue_card_number permet au composant de créer une requête pour réémettre une carte nouvelle ou mise à niveau.

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
$session.params.last_four_digit_of_card_number Les quatre derniers chiffres du numéro de carte que l'utilisateur a demandé de verrouiller. string
zip_code Code postal de l'adresse enregistrée de l'utilisateur. 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
acknowledgement_number Numéro de ticket de la demande de réémission de carte créée. entier

Pour configurer le webhook de réémission de carte 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_lock_card:reissue_card_number.
  7. Remplacez l'URL du 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 prédéfini "Lock card" et ses webhooks sont maintenant configurés et prêts à être testés.