L'état de la commande composant prédéfini vérifie le niveau d'authentification du client, puis fournit des informations les commandes les plus récentes ou passées d'un client authentifié. Ce composant utilise le Authentification pour la vente au détail un composant prédéfini pour authentifier les utilisateurs. Le composant utilise également des générateurs pour la synthèse post-appel.
Limites
En plus des limites courantes des composants prédéfinis, ce composant prédéfini présente les limites suivantes:
- Ce composant ne chiffre aucune donnée.
Exemples de boîtes de dialogue
Les exemples de boîtes de dialogue suivants illustrent les scénarios courants gérés par ce composant prédéfini. Les exemples de boîte de dialogue illustrent ce comportement lorsque le composant est appelée à l'aide de la téléphonie, ce qui déclenche l'intent d'accueil par défaut et le premier de l'agent au début de la conversation.
Commande récente
les appels d'utilisateurs finaux à partir d'un numéro non enregistré ; l'agent authentifie l'utilisateur, fournit ensuite des informations détaillées sur les envois de la commande. L'utilisateur confirme qu'il souhaite recevoir un SMS contenant des informations supplémentaires sur son numéro de téléphone enregistré.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| L'agent authentifie l'utilisateur à l'aide du composant prédéfini Authentification pour les marchands. | |
| D\'accord, John. Appelez-vous au sujet de votre dernière commande pour John Doe contenant une lampe, une chemise et 10 autres articles passée le 10/11/2023 à 18h ? | |
| Oui | |
| Votre commande comporte deux envois qui seront livrés d'ici le 15/01/2024. Voulez-vous en savoir plus sur ces livraisons ? |
|
| Oui | |
| Le premier colis qui contient un jean, une ceinture et deux autres articles est en cours d'acheminement et sera livré d'ici le 12/01/2024. Le colis 2 contenant la lampe, la chemise et 6 autres articles a été livré le 12/11/2023. Souhaitez-vous recevoir un SMS contenant plus d'informations sur vos articles ? |
|
| Oui | |
| Nous vous avons envoyé un SMS contenant un lien vous permettant de suivre l'état de tous vos envois. Merci de nous avoir contactés. |
Commandes en double
L'utilisateur final a déjà été authentifié. L'utilisateur demande des informations sur une commande et fournit les cinq derniers chiffres de la commande. L'agent identifie que plusieurs commandes passées par cet utilisateur partagent les cinq derniers chiffres. Il confirme donc la commande dont l'utilisateur souhaite connaître l'état et lui fournit l'état de la commande.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| OK, Amber. Appelez-vous au sujet de votre dernière commande d'Amber Doe contenant une lampe, une chemise et deux autres articles, passée le 10/11/2023 à 18h ? | |
| Non | |
| Pourriez-vous indiquer les cinq derniers chiffres de l'ID de commande dont vous souhaitez effectuer le suivi ? | |
| 12355 | |
| Les cinq derniers chiffres de l'ID de commande que nous avons obtenu sont 12355, c'est bien ça ? | |
| Oui, c'est exact | |
| Parfait. Nous avons terminé de collecter l'ID de commande. | |
| D'après nos informations, nous avons trouvé deux commandes se terminant par le même numéro à cinq chiffres : 12355. Quelle commande recherchez-vous ? La commande numéro 1 passée le 10/11/2023 à 18h00 ou la commande numéro 2 passée le 9/11/2023 à 20h00 ? Pour sélectionner la commande numéro 1, dites "1", pour sélectionner la commande numéro 2, dites "2". Sinon, dites "Non". |
|
| Commander une | |
| Votre commande comporte deux envois qui seront livrés d'ici le 15/01/2024. Voulez-vous en savoir plus sur ces livraisons ? |
|
| Oui | |
| Le colis 1 contenant des jeans est en cours d'acheminement et sera livré d'ici le 15/01/2024. Le colis 2 contenant la lampe, la chemise et 1 autre article a été annulé. Souhaitez-vous recevoir un SMS contenant plus d'informations sur vos articles ? |
|
| Non, c'est tout | |
| Merci de nous avoir contactés. |
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 |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_order_status:get_order_details |
Paramètres d'entrée
Les paramètres d'entrée sont des paramètres utilisés pour configurer certains comportements du composant. Ces paramètres seront utilisés par une ou plusieurs conditions dans la pour déterminer le comportement du composant. Les paramètres à l'échelle du flux doivent être défini sur la page d'accueil 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, permettant d'identifier l'utilisateur | chaîne |
| $session.params.all_recent_order_id | (Facultatif) Ce paramètre liste les ID de commande associés à l'utilisateur authentifié, triés par date de 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) 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 |
| $flow.max_shipment | Indique le nombre d'envois affichés à l'utilisateur à la fois. La valeur par défaut est 2. |
entier |
| $flow.tracking_status_deliveryed | Spécifie la valeur renvoyée par le webhook indiquant l'état de la commande livrée. La valeur par défaut est "delivered". |
chaîne |
| $flow.tracking_status_cancelled | Spécifie la valeur renvoyée par le webhook pour indiquer l'état d'une commande annulée. La valeur par défaut est "cancelled". |
chaîne |
| $flow.tracking_status_returned | Spécifie la valeur renvoyée par le webhook indiquant l'état d'une commande retournée. La valeur par défaut est "returned". |
chaîne |
| $flow.tracking_status_partially_returned | Spécifie la valeur renvoyée par le webhook, qui indique un état de commande partiellement renvoyé. La valeur par défaut est "partially returned". |
chaîne |
| $flow.max_retry_alternate_profile | Spécifie le nombre de tentatives autorisées lorsque vous demandez l'état d'une commande à partir d'un numéro de téléphone non enregistré ou d'un profil alternatif. La valeur par défaut est 3. |
entier |
| $flow.max_retry_order_number | Spécifie le nombre de tentatives autorisées lorsque vous fournissez un numéro de commande. La valeur par défaut est 3. |
entier |
| $flow.max_retry_another_order_id | Indique le nombre de nouvelles tentatives autorisées après avoir fourni un numéro de commande non valide. La valeur par défaut est 3. |
entier |
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 dans la page d'accueil.
- Dans la fenêtre "Route", modifiez les valeurs Parameter Presets (Préréglages du paramètre) 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 fermeture. le composant. Ces paramètres contiennent des informations importantes collectées par le composant. Ce composant prédéfini fournit des valeurs pour la sortie suivante : paramètres:
| 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 commande par 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 de l'arrêt du flux, s'il n'a pas réussi. 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 les événements intégrés sans entrée.max_no_match: la conversation a atteint le nombre maximal de tentatives pour les événements sans correspondance. Consultez les événements intégrés sans correspondance.webhook_error: une erreur de webhook s'est produite. Consultez l'événement intégré webhook.error. webhook_not_found : une URL de webhook était inaccessible. Consultez l'événement intégré webhook.error.not-found. |
chaîne |
Configuration de base
Pour configurer ce composant prédéfini:
- Importez le composant prédéfini.
- Configurez les attributs webhooks flexibles avec décrivant vos services externes, consultez la section configuration.
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_order_status:get_order_details est utilisé
par le composant pour récupérer les détails d'une commande donnée.
Paramètres de requête 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 dont 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 que le composant puisse les utiliser.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| date_de_commande | Date à laquelle la commande a été passée, au format YYYY-MM-DD. |
chaîne |
| order_time | Heure à laquelle la commande a été passée, au format HH:MM. |
chaîne |
| order_status | Indique l'état de la commande. Exemples de valeurs : "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". |
chaîne |
| order_product_name | Liste des noms des produits de la commande. | Liste (chaîne) |
| order_product_quantity | Nombre total de produits commandés pour chaque produit dans une commande. | entier |
| order_product_count | Nombre de produits uniques dans une commande. | entier |
| order_status_notification | Indique si les notifications sont activées pour cet ordre. | booléen |
| return_eligibility_date | Liste des dates jusqu'à lesquelles chaque produit de la commande peut être retourné, au format YYYY-MM-DD. |
Liste (chaîne) |
| order_customer_billing_name | Prénom du client pour la facturation de la commande. | chaîne |
| order_latest_delivery_date | Dernière date de livraison de toutes les dates de livraison estimées pour les expéditions de la commande, au format YYYY-MM-DD. |
chaîne |
| order_shipment_multiple | Indique si la commande contient plusieurs livraisons. | booléen |
| order_shipment_count | Nombre de livraisons de la commande. | entier |
| order_shipment_product_count | Nombre total de produits dans chaque envoi de la commande. | Liste (entier) |
| order_shipment_product_name | Liste des noms de produits de chaque livraison de la commande. | Liste (chaîne) |
| order_estimated_delivery_date | Liste des dates de livraison estimées pour chaque envoi de la commande, au format YYYY-MM-DD. |
Liste (chaîne) |
| order_shipment_status | Liste indiquant l'état de chaque envoi de la commande. Exemples de valeurs : "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". |
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_order_status:get_order_details.
- Remplacez l'URL indiquée dans le champ URL du webhook d'agents conversationnels (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 modifiez le corps de la requête afin de définir 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Obtenir des commandes en double
Le webhook prebuilt_components_retail_services:get_duplicate_order 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 pour l'utilisateur. | Liste (chaîne) |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour que le composant puisse les utiliser.
| 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. |
booléen |
| 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 dans le tableau all_order_date. |
Nombre |
Pour configurer le webhook "Get duplicate orders" (Obtenir les commandes en double) 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_retail_services:get_duplicate_order.
- 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 afin de définir 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Envoyer un SMS
Le webhook prebuilt_components_order_status:send_sms est utilisé par le composant pour envoyer les détails de la commande au numéro de téléphone spécifié par SMS.
Paramètres de requête 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 le code pays, permettant de l'identifier. | chaîne |
| $flow.order_id | ID de commande pour lequel envoyer les informations. | chaîne |
Pour configurer le webhook d'envoi de SMS pour ce composant, développez la section afin d'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_order_status:send_sms.
- 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 afin de définir 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 le composant en a besoin pour accéder les valeurs de champ renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Activer les notifications
Le webhook prebuilt_components_order_status:enable_notification est utilisé par le composant pour activer les notifications pour le numéro de téléphone enregistré d'un utilisateur.
Paramètres de requête 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 le code pays, permettant de l'identifier. | chaîne |
| $flow.order_notification | Indique si les notifications doivent être activées pour l'utilisateur. | booléen |
Pour configurer le webhook "Enable notifications" (Activer les notifications) 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_order_status:enable_notification.
- Remplacez l'URL indiquée dans le champ URL du webhook d'agents conversationnels (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 modifiez le corps de la requête afin de définir 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 le composant en a besoin pour accéder les valeurs de champ 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.