Dela via

Återanvända variabler i olika ämnen

  • Artikel

Variabler lagrar kundernas svar på frågor från din agent. Du kan till exempel spara en kunds namn i en variabel som heter UserName. Agenten kan sedan adressera kunden vid namn i takt med att konversationen fortsätter.

Som standard kan en variabels värde endast användas i ämne där variabeln skapas. Det går dock att återanvända samma värde i olika ämnen. T.ex. ämnet välkommen frågar efter kundens namn och e-postadress. I ämnet Bokning av avtalad tid vill du att agenten ska komma ihåg vad kunden har angett och inte fråga igen.

Ett sätt att återanvända en variabel är att skicka variabeln mellan ämnen. Det andra sättet är att göra variabeln global i omfattning och det är vad den här artikeln beskriver. Globala variabler kallas det för att de är tillgängliga i alla ämnen i hela agenten.

Globala variabler gäller under en enskild användarsession. Du anger vilka variabler är globala variabler för att särskilja dem från variabler på ämnesnivå.

Skapa en global variabel

Du skapar en global variabel genom att ändra omfattningen av en ämnesvariabel.

  1. Skapa en variabel eller använder fönstret Variabler för att öppna en befintlig variabel.

  2. I panelen Variabelegenskaper, välj Global (alla ämnen kan få åtkomst).

    Variabelnamnet får en viss prefixlängd Global. som skiljer från variabler på ämnesnivå. Till exempel visas variabeln UserName som Global.UserName.

  3. Spara ämnet.

    Namnet på en global variabel måste vara unikt i alla ämnen.

Använd globala variabler

När du skriver ett meddelande i en meddelandenod eller en frågenod väljer du ikonen {x} för att se de variabler som är tillgängliga för ämnet. Globala variabler visas på fliken Anpassad tillsammans med eventuella ämnesvariabler. Variabler anges i alfabetisk ordning.

Söka efter alla ämnen med hjälp av en global variabel

Du hittar var en global variabel definieras och vilka andra ämnen som använder den. Den här funktionen kan vara användbar om du arbetar med en ny agent eller om du har flera variabler och komplex ämnesförgrening.

  1. Välj den önskade globala variabeln på designytan eller i panelen Variabler.

  2. På panelen Variablegenskaper, i avsnittet Referens väljer du Visa alla referenser.

  3. Byt till fliken Annat och välj ett ämne där variabeln används för att gå direkt till det ämnet och noden.

Livscykeln för globala variabler

Som standard bevaras värdet för en global variabel tills sessionen avslutas. Noden Rensa variabelvärden återställer värdena för globala variabler och används i systemet systemämnet Återställ konversation. Det ämnet kan utlösas antingen genom om omdirigerande eller när användaren anger en utlösarfras, till exempel "Start over". I så fall återställs alla globala variabler.

Ange värdet för en global variabel från externa källor

Om du vill vara säker på att agent startar en konversation med viss kontext kan du initiera en global variabel med en extern källa. Anta att användarna måste logga in på webbplatsen. Eftersom din agent redan känner till en användares namn kan den ge kunderna ett namn innan de börjar skriva sin första fråga.

  1. Välj en global variabel.

  2. I rutan Egenskaper för variabel, välj Externa källor kan ställa in värden.

Ange globala variabler i en inbäddad agent

Om du bädda in din agent på en enkel webbsida kan du lägga till variabler och deras definitioner till agent-URL:en. Om du vill ha lite mer kontroll kan du också använda ett <script>-kodblock för att anropa och använda variabler programmässigt.

Variabelnamnet i frågesträngen för URL måste överensstämma med namnet på den globala variabeln, utan Global.-prefixet. En global variabel Global.UserName kallas till exempel för UserName i frågan.

I följande exempel används en grundläggande deklaration för variablerna. I ett produktionsscenario kan du som en sökparameter eller variabeldefinition skicka in en annan variabel som redan har lagrat användarens namn (till exempel om du har användarnamnet från ett inloggningsskript).

Lägg till variablerna och deras definitioner i agent-URL:en som Parametrar för frågesträngar i formatet botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Till exempel:

Parameternamnet är skiftlägesokänsligt. username=Ana fungerar också i det här exemplet.

Lägg till globala variabler i en anpassad arbetsyta

Du kan också lägga till variabeln i en anpassad arbetsyta.

  1. I avsnittet <script> på sidan där du har agenten definierar du variablerna enligt följande och ersätter variableName1 för variabelnamnet utan Global. prefixet och variableDefinition1 för definitionen. Avskilj flera variabler med kommatecken (,).

       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. I avsnittet <script> anropar du store när du bäddar in agenten, som i följande exempel där store kallas precis före där styleOptions kallas (du måste byta ut BOT_ID med agentens ID):

    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));

Relaterat innehåll