Partager via

Utiliser des variables pour transporter du contenu d’une rubrique à une autre

  • Article

Les variables stockent les réponses de vos clients aux questions de votre agent. Par exemple, vous pouvez enregistrer le nom d’un client dans une variable appelée UserName. Le agent peut alors s’adresser au client par son nom pendant que la conversation se poursuit.

Par défaut, la valeur d’une variable ne peut être utilisée que dans la rubrique où la variable est créée. Cependant, il est possible de réutiliser la même valeur dans toutes les rubriques. Par exemple, dans une rubrique de « Bienvenue », le bot demande le nom et l’adresse e-mail du client. Dans la prise de rendez-vous rubrique, vous souhaitez que le agent se souvienne de ce que le client a saisi et ne le redemande pas.

Une façon de réutiliser une variable consiste à transmettre la variable entre les rubriques. L’autre façon consiste à donner à la variable une portée globale, et c’est ce que couvre cet article. Les variables globales sont appelées ainsi car elles sont disponibles dans toutes les rubriques de l’ensemble du agent.

Les variables agent s’appliquent pendant une seule session utilisateur. Vous spécifiez les variables qui doivent être traitées comme des variables agent pour les distinguer des variables de niveau rubrique.

Créer une variable globale

Vous créez une variable globale en changeant la portée d’une variable de rubrique.

  1. Créez une variable ou utilisez le volet Variables pour ouvrir une variable existante.

  2. Sur le volet Propriétés de la variable, sélectionnez Global (n’importe quelle rubrique peut y accéder).

    Le nom de la variable reçoit le préfixe Global., pour la différencier des variables de niveau rubrique. Par exemple, la variable UserName est affichée sous le nom Global.UserName.

    Capture d’écran montrant le volet Propriétés des variables, avec les Paramètres globaux mis en évidence.

  3. Enregistrez la rubrique.

    Le nom d’une variable globale doit être unique dans toutes les rubriques. En cas de conflit, vous devrez renommer la variable avant d’enregistrer votre rubrique.

Utiliser des variables globales

Lorsque vous rédigez un message agent dans un nœud Message ou un nœud Question, #glsr_cfighdz cliquez sur l’icône {x} pour afficher les variables disponibles pour rubrique. Les variables globales s’affichent dans l’onglet Personnalisé, ainsi que les variables de rubrique. Les variables sont répertoriées dans l’ordre alphabétique.

Capture d’écran montrant une sélection de variable globale.

Rechercher toutes les rubriques qui utilisent une variable globale

Vous pouvez voir où une variable globale est définie et quelles autres rubriques l’utilisent. Cela peut être utile si vous travaillez sur un nouveau agent, ou si vous avez plusieurs variables et des branches rubrique complexes.

  1. Sélectionnez une variable globale dans le canevas de création ou ouvrez le volet Variables et sélectionnez une variable globale.

  2. Dans le volet Propriétés de la variable, dans la section Référence, sélectionnez l’un des rubriques où la variable est utilisée pour accéder directement à cette rubrique et ce nœud.

    Capture d’écran montrant la liste des sujets utilisés par une variable dans le volet des propriétés des variables.

Cycle de vie des variables globales

Par défaut, la valeur d’une variable globale persiste jusqu’à la fin de la session. Le nœud Effacer les valeurs de variable réinitialise les valeurs des variables globales et est utilisé dans la rubrique système Réinitialiser la conversation. Cette rubrique peut être déclenchée par la redirection ou lorsque l’utilisateur saisit une phrase de déclenchement telle que « Recommencer ». Dans ce cas, toutes les variables globales sont redéfinies.

Définir la valeur d’une variable globale à partir de sources externes

Si vous souhaitez vous assurer que le agent démarre une conversation avec un certain contexte, vous pouvez initialiser une variable globale avec une source externe. Supposons que votre site nécessite que les utilisateurs se connectent. Étant donné que votre agent connaît déjà le nom d’un utilisateur, il peut saluer les clients par leur nom avant qu’ils ne commencent à taper leur première question.

  1. Sélectionnez une variable globale.

  2. Dans le volet Propriétés de la variable, sélectionnez Les sources peuvent définir des valeurs.

Définir des variables globales dans un agent intégré

Si vous intégrez votre agent dans une page Web simple, vous pouvez ajouter des variables et leurs définitions à l’URL de agent. ... Ou bien, si vous souhaitez un peu plus de contrôle, vous pouvez utiliser un bloc de code <script> pour appeler et utiliser les variables par programmation.

Le nom de la variable dans la chaîne de requête de l’URL doit correspondre au nom de la variable globale sans le préfixe Global.. Par exemple, une variable globale Global.UserName serait appelée UserName dans la requête.

Les exemples qui suivent offrent une déclaration simple pour les variables. Dans un scénario de production, vous pouvez transmettre en tant que paramètre de requête ou définition de variable une autre variable qui a déjà stocké le nom de l’utilisateur (par exemple, si vous avez le nom d’utilisateur d’un script de connexion).

Ajoutez les variables et leurs définitions à l’URL de agent en tant que paramètres de chaîne de requête au format botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Par exemple :

Le nom du paramètre est insensible à la casse. username=Renata fonctionnera également dans cet exemple.

Ajouter des variables globales à un canevas personnalisé

Vous pouvez également ajouter la variable à un canevas personnalisé.

  1. Dans la section de la page où vous avez votre agent, définissez les variables comme suit, en remplaçant <script> le nom de la variable sans le variableName1 préfixe et Global. la définition. variableDefinition1 Séparez plusieurs variables par des virgules (,).

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

  2. Dans votre <script> section, appelez le store lorsque vous intégrez votre agent, comme dans l’exemple suivant où store est appelé juste au-dessus de l’endroit où styleOptions est appelé (vous devrez remplacer le BOT_ID par l’ID de votre agent) :

    const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));

Contenu associé