Lorsque les clients demandent où en est leur commande (en anglais « Where IS My Order ? » > WISMO), vous pouvez construire un parcours simple, efficace et personnalisable de manière autonome.

Ce guide vous montrera comment créer un parcours WISMO à l’aide de notre éditeur de workflows, en interrogeant votre API de suivi de colis et en affichant dynamiquement les informations de suivi.

Ce guide nécessite une connaissance minimale de la consommation d’API.

1. Avant de commencer : familiarisez-vous avec l’éditeur de workflow

Notre éditeur de workflow est la base pour créer des parcours WISMO.

Commencez par consulter ces articles :

2. Créez la connexion API

Allez dans la section Connexion API (AI Copilot > Workflows, puis sélectionnez « Connexion API » dans la liste déroulante)
Créez une nouvelle Connexion API en cliquant sur le bouton + Créer une connexion en haut à droite
Configurez la Connexion API comme suit :

Informations

Nom : PLUGIN:WISMO/XXXX (XXXX étant le nom de votre outil si vous le souhaitez)
Définir les entrées :
- orderNumber (type=String)

URL de l’API

Méthode : sélectionnez la bonne méthode pour appeler votre API (cela peut être GET ou POST)
Définir l’URL : saisissez l’URL de votre point de terminaison personnalisé

Corps de la requête

{
  "orderNumber": {orderNumber}
}

Payload de réponse attendu

iAdvize a besoin d’une liste de valeurs pour pouvoir ensuite générer un carrousel dynamique.

Nous n’avons pas de fonction de concaténation avancée native nous permettant de pouvoir récupérer et mettre en forme les informations contenues dans un payload complexe

C’est la raison pour laquelle nous demandons un payload formaté sur le principe suivant :


  {
  "isOrderFound": true,
  "shipments": [
    {
      "image": "https://cdn.seb.com/img/status/in_transit.jpg",
      "title": "Colis en transit",
      "description": "Transporteur : Colissimo\nArticles :\n• Grille-pain inox x1\n• Bouilloire rapide 1.7L x1",
      "linkName": "Suivre ce colis",
      "linkURL": "https://www.laposte.fr/outils/suivre-vos-envois?code=8R12345678901"
    },
    {
      "image": "https://cdn.seb.com/img/status/preparing.jpg",
      "title": "Colis en préparation",
      "description": "Transporteur : Chronopost\nArticles :\n• Blender 1.5L x1\n• Balance de cuisine digitale x1",
      "linkName": "Suivre ce colis",
      "linkURL": "https://www.chronopost.fr/tracking?code=XY987654321"
    }
  ]
}

Extraire les données

A partir de ce payload, vous pouvez configurer les sorties comme suit, mais notez que les valeurs mentionnées ici ne sont que des exemples de ce qui est possible. Vous êtes libre de les nommer autrement.

Chemin JSON	Variable de sortie
$.isOrderFound	isOrderFound

Cette valeur vous permettra de contrôler l’affichage d’un message selon que la commande ait été trouvée ou non.

JSON path	Output variable
$.shipments[*].image	carouselImage
$.shipments[*].title	carouselTitle
$.shipments[*].description	carouselDescription
$.shipments[*].linkName	carouselLinkName
$.shipments[*].linkURL	carouselLinkURL

En utilisant la syntaxe JSON Path $.myCollection[*].subProperty, vous pouvez extraire une liste de chaque sous-propriété. Vous pouvez ensuite utiliser cette liste pour afficher les éléments dans un carrousel au sein du workflow.

3. Créer un Workflow dédié pour gérer cette fonctionnalité

Allez dans la section Workflow (AI Copilot > Workflows)
Créez un nouveau Workflow en cliquant sur le bouton + Créer en haut à droite
Renseignez les informations d’identité de votre Workflow en lui donnant un Nom (ex. : XXXX Suivi de commande) et un Nom affiché. Vous pouvez également personnaliser l’apparence de votre Workflow (couleur, icône, etc.).
Cliquez sur l’onglet Scénario en haut de l’interface
Voici un exemple d’étapes que vous pouvez créer pour permettre à votre Workflow de répondre aux questions de suivi de commande :

ÉTAPE A : Carte de Connexion API

Cette carte collectera les informations du visiteur, puis les enverra à notre intégration iAdvize x XXXX pour récupérer les informations de suivi de commande.

Type de carte : sélectionnez “Connexion API” dans la liste déroulante
Type de connexion
- Sélectionnez une connexion API : choisissez celle que vous avez créée précédemment “PLUGIN:WISMO/XXXX”
- Choisissez la version : sélectionnez la dernière version (le plus grand numéro)
Entrées
- Question : Écrivez la question qui sera affichée aux visiteurs, les invitant à entrer leur numéro de commande (et leur e-mail si vous l’avez aussi configuré dans la Connexion API à l’étape précédente).
  Ex. : Quel est votre numéro de commande ?
- Ne pas poser cette question si le bot connaît déjà la réponse : décochez cette case
Étape suivante après réponse
- Définir l’action : sélectionnez Continuer vers l’étape
- Choisir ou créer une étape : sélectionnez l’élément qui invite à créer une nouvelle étape (cela doit être + Créer étape B)
Alternative en cas d’échec de la requête API :
À ce stade, vous pouvez simplement choisir dans Définir l’action : Terminer la conversation. Vous pourrez améliorer ce scénario plus tard en affichant un message informant l’utilisateur qu’une erreur s’est produite.

ÉTAPE B : Vérifier si la commande a été trouvée

Cette étape vous permet de vérifier si la commande a été trouvée et, par exemple, d’afficher un message si ce n’est pas le cas.

Avant de configurer cette étape, cliquez d’abord sur “+ Ajouter une étape” (cela devrait créer une nouvelle étape nommée “C”)

Type de carte : sélectionnez “Conditions”
Si
- Cliquez sur “Ajouter une règle de condition”, puis :
  - Nom de la condition : vous pouvez la nommer “Vérifier si la commande a été trouvée”
  - Définir les conditions :
    - Dans la ligne de condition :
      - Conservez “Variable” dans le premier menu déroulant
      - Sélectionnez la variable “isOrderFound” dans le second
      - Conservez “est égal à” dans le troisième
      - Saisissez “true” dans le champ texte
  - Action sur le choix
    - Action : sélectionnez “Continuer vers l’étape”
    - Choix de votre action : E (le nom de l’étape que vous venez de créer avant cette carte)

Sinon
- Action : sélectionnez « Continuer vers l’étape »
- Choix de votre action : sélectionnez l’élément qui invite à créer une nouvelle étape (cela doit être + Créer étape D)

ÉTAPE C : Message commande non trouvée

Dans cette étape, vous informerez le visiteur que sa commande n’a pas été trouvée. Vous pouvez aussi l’inviter à réessayer.

Type de carte : sélectionnez Choix multiple
Dans le champ texte, vous pouvez entrer le message suivant :

Nous n’avons pas trouvé votre commande, il est possible que votre numéro soit invalide. Souhaitez-vous réessayer ?
Étape suivante
- Ajoutez deux choix :
  - oui avec l’action “Continuer vers l’étape” et sélectionnez l’étape A
  - non avec l’action “Terminer la conversation”

ÉTAPE D : Afficher les informations de suivi au visiteur

Dans cette étape, vous allez pouvoir afficher toutes les informations de suivi de colis.

Type de carte : sélectionnez “Message enrichi”
Dans le champ texte, vous pouvez entrer le message suivant : “Voici les informations de votre commande :”
Cliquez sur la deuxième icône “Vignette ou carrousel”
Dans la nouvelle fenêtre, cliquez sur l’option “Dynamique”
Dans le :
- Champ image : cliquez sur l’icône dans le champ de texte, puis sélectionnez la variable carouselImage
- Champ Titre vignette : cliquez sur l’icône dans le champ de texte, puis sélectionnez carouselTitle
- Champ Description : cliquez sur l’icône dans le champ de texte, puis sélectionnez carouselDescription
- Champ URL du lien : cliquez sur l’icône dans le champ de texte, puis sélectionnez carouselLinkURL
- Champ Texte affiché : cliquez sur l’icône dans le champ de texte, puis sélectionnez carouselLinkName
Cliquez sur le bouton Valider en haut à droite, puis cliquez sur la flèche en haut à gauche

Étape suivante
- Définir l’action : sélectionnez “Terminer la conversation” (vous pourrez l’améliorer plus tard)

4. Configurez votre Copilot pour déléguer ce comportement personnalisé à votre Workflow dédié

Rendez votre Workflow accessible depuis votre Copilot

Allez dans la section “Routage” en cliquant sur Engagement > Routage
Cliquez sur le bouton (+) en haut à droite

Donnez un nom à votre nouvelle règle de routage, ex. : XXXX Suivi de commande

En bas de la fenêtre, cliquez sur le bouton “+ Ajouter des groupes de routage”, puis cliquez sur le bouton Ajouter

Cliquez sur le bouton Enregistrer

Connectez le Copilot for Shoppers à votre Workflow de suivi de commande

Allez dans la section “Copilot for Shoppers” en cliquant sur AI Copilot
Modifiez votre Copilot existant en cliquant sur l’icône en forme de crayon
Dans la section Comportements personnalisés, cliquez sur “Ajouter un comportement personnalisé” et remplissez les champs suivants :
- Nom du comportement : Suivi de commande
- [1] Besoin exprimé par les visiteurs : vous pouvez commencer par rédiger une intention liée au statut de commande. L’assistant iAdvize vous aidera à améliorer la détection si vous cliquez sur le bouton Améliorer.
  Ex. :
  
  Cette intention concerne les clients cherchant des informations sur l’emplacement actuel de leur commande. Ils peuvent vouloir savoir si leur commande a été traitée, expédiée ou livrée. Ils peuvent aussi chercher des détails spécifiques sur la localisation de leur colis, notamment en cas de retard ou d’impatience. Cette intention est fréquente lorsque les clients suivent leur commande et souhaitent obtenir des mises à jour sur son avancement.
- [2] Réaction du Copilot
  - Sélectionnez un comportement : choisissez l’option Transférer
  - Sélectionnez une règle de routage : sélectionnez la règle que nous avons créée précédemment : “Distribuer vers XXXX Suivi de commande”
  - Cliquez sur le bouton Valider
  - Ensuite, cliquez sur le bouton Publier et fermer en haut à droite