Le composant prédéfini sur l'état de la commande vérifie le niveau d'authentification d'un client, puis fournit des informations sur les commandes les plus récentes ou passées de l'utilisateur à un client authentifié. Ce composant utilise le composant prédéfini Authentification dans le commerce 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 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.
Commande récente
L'utilisateur final appelle depuis un numéro non enregistré. L'agent authentifie l'utilisateur, puis fournit 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 le commerce. | |
| 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 colis qui seront livrés d'ici le 15/01/2024. Souhaitez-vous en savoir plus sur ces colis ? |
|
| Oui | |
| Le colis 1 contenant un jean, une ceinture et deux autres articles est en cours de livraison et sera livré d'ici le 12/01/2024. Le colis 2 contenant une lampe, une chemise et six 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 pour suivre l'état de toutes vos livraisons. 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 constate 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 |
|---|---|
| D\'accord, Amber. Appelez-vous au sujet de votre dernière commande pour Amber Doe contenant une lampe, une chemise et deux autres articles passée le 10/11/2023 à 18h ? | |
| Non | |
| Pourriez-vous nous communiquer les cinq derniers chiffres de l\'ID de commande que vous souhaitez suivre ? | |
| 12355 | |
| Les cinq derniers chiffres de l'ID de commande que nous avons reçus sont 12355. C'est bien cela ? | |
| 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 les cinq mêmes 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". |
|
| Commande 1 | |
| Votre commande comporte deux colis qui seront livrés d'ici le 15/01/2024. Souhaitez-vous en savoir plus sur ces colis ? |
|
| Oui | |
| Le colis 1 contenant des jeans est en cours de livraison et sera livré d'ici le 15/01/2024. Le colis 2 contenant une lampe, une chemise et un autre article est 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. 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 le saluer et confirmer qu'il est le propriétaire 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_delivered | Spécifie la valeur renvoyée par le webhook pour indiquer 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 pour indiquer l'état de la 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 pour indiquer un état de commande partiellement retournée. La valeur par défaut est "partially returned". |
chaîne |
| $flow.max_retry_alternate_profile | Indique le nombre de tentatives autorisées lorsque vous demandez l'état de la commande à partir d'un numéro de téléphone non enregistré ou d'un autre profil. 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 (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 |
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_order_status: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_time | Heure de la commande, 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 d'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 cette commande. | 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 colis. | 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 des produits de chaque envoi de la commande. | Liste (chaîne) |
| order_estimated_delivery_date | Liste des dates de livraison estimées pour chaque colis 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 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 obtenir 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 de paramètre, car ils sont requis par le composant pour accéder aux 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 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. |
booléen |
| 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. |
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 l'intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et modifiez le corps de la requête pour obtenir 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 de paramètre, car ils sont requis par le composant pour accéder aux 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 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 lequel envoyer les informations. | chaîne |
Pour configurer le webhook d'envoi de SMS 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: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 pour obtenir 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 de paramètre, car ils sont requis par le composant pour accéder aux 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 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_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 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 obtenir 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 de paramètre, car ils sont requis par le composant pour accéder aux 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.