Jaa

Muuttujien käyttäminen uudelleen aiheissa

  • Artikkeli

Muuttujat tallentavat asiakkaidesi vastaukset agentin kysymyksiin. Voit esimerkiksi tallentaa asiakkaan nimen muuttujaan UserName. Tämän jälkeen agentti voi kutsua asiakasta nimellä keskustelun jatkuessa.

Oletusarvoisesti muuttujan arvoa voi käyttää vain siinä aiheessa, jossa muuttuja luodaan. Samaa arvoa voi kuitenkin käyttää uudelleen eri aiheissa. Esimerkiksi Tervetuloa-aihe kysyy asiakkaan nimeä ja sähköpostiosoitetta. Ajanvaraus-ohjeaiheessa haluat, että agentti muistaa, mitä asiakas on syöttänyt, eikä kysy uudelleen.

Muuttujaa voi käyttää uudelleen siten, että muuttujaa siirretään aiheiden välillä. Toinen tapa on tehdä muuttujasta yleinen, ja sitä tässä artikkelissa käsitellään. Yleisiä muuttujia kutsutaan sellaisiksi, koska ne ovat käytettävissä kaikissa aiheissa koko agentissa.

Yleiset muuttujat pätevät yksittäisen käyttäjäistunnon ajan. Määrität, mitkä muuttujat ovat yleisiä muuttujina, jotta ne eroavaisivat aihetason muuttujista.

Luo yleinen muuttuja

Luot yleisen muuttujan muuttamalla aihemuuttujan vaikutusalueen.

  1. Luo muuttuja tai käytä Muuttujat-ruutua avataksesi aiemmin luodun muuttujan.

  2. Valitse Muuttujan ominaisuudet -paneelin kohdassa Yleinen (minkä tahansa aiheen käytettävissä).

    Muuttujan nimelle annetaan etuliitemerkkijono Global., joka erottaa sen aihetason muuttujista. Esimerkiksi muuttuja UserName näkyy muodossa Global.UserName.

  3. Tallenna aihe.

    Yleisen muuttujan nimen on oltava yksilöllinen kaikissa aiheissa.

Käytä yleisiä muuttujia

Kun kirjoitat viestiä Viesti- tai Kysymys-solmussa, valitse {x}-kuvake nähdäksesi aiheen käytettävissä olevat muuttujat. Yleiset muuttujat näkyvät Mukautettu-välilehdessä muiden aihemuuttujien lisäksi. Muuttujat luetellaan aakkosjärjestyksessä.

Kaikkien aiheiden etsiminen yleisen muuttujan avulla

Näet, missä yleinen muuttuja on määritetty ja mitkä muut aiheet käyttävät sitä. Tästä ominaisuudesta voi olla hyötyä, jos työstät uutta agenttia tai sinulla on useita muuttujia sekä monitasoista aiheiden haarautumista.

  1. Valitse haluamasi yleinen muuttuja tuotantoalustasta tai Muuttujat-ruudusta.

  2. Valitse Muuttujan ominaisuudet -paneelin Viite-osasta Näytä kaikki viittaukset.

  3. Siirry Muu-välilehteen ja valitse aihe, jossa muuttujan avulla siirrytään suoraan aiheeseen ja solmuun.

Yleisten muuttujien elinkaari

Yleisen muuttujan arvo säilyy oletusarvon mukaan istunnon loppuun asti. Poista muuttujan arvot -solmu palauttaa globaalien muuttujien arvot ja sitä käytetään Keskustelun palauttaminen -järjestelmäaiheessa. Tämä aihe voidaan käynnistää joko uudelleenohjaamalla tai kun käyttäjä kirjoittaa käynnistinlauseen, kuten "Aloita alusta". Tällöin kaikki yleiset muuttujat nollataan.

Yleisen muuttujan arvon määrittäminen ulkoisista lähteistä

Jos haluat varmistaa, että agentti aloittaa keskustelun jollakin kontekstilla, voit alustaa yleisen muuttujan ulkoisella lähteellä. Oletetaan, että sivustosi edellyttää käyttäjien kirjautuvan sisään. Koska agentti tietää jo käyttäjän nimen, se voi tervehtiä asiakkaita nimeltä ennen kuin he alkavat kirjoittaa ensimmäistä kysymystään.

  1. Valitse yleinen muuttuja.

  2. Valitse Muuttujan ominaisuudet -ruudussa Ulkoiset lähteet voivat määrittää arvoja.

Yleisten muuttujien määrittäminen upotetussa agentissa

Jos agentti upotetaan yksinkertaiseen verkkosivuun, voit liittää muuttujat ja niiden määritykset agentin URL-osoitteeseen. Jos haluat hieman enemmän hallintaa, voit kutsua ja käyttää muuttujia ohjelmallisesti <script> -koodilohkon avulla.

URL-osoitteen kyselymerkkijonon muuttujan nimen on vastattava yleisen muuttujan nimeä ilman Global.-etuliitettä. Esimerkiksi yleiseen muuttujaan Global.UserName viitataan kyselyssä nimellä UserName.

Seuraavissa esimerkeissä käytetään muuttujien perusmäärittelyä. Tuotantoskenaariossa saattaisit välittää kyselyparametriksi tai muuttujan määritelmäksi toisen muuttujan, joka on jo tallentanut käyttäjän nimen (jos sinulla esimerkiksi on käyttäjän nimi sisäänkirjautumisskriptistä).

Liitä muuttujat ja niiden määritelmät agentin URL-osoitteeseen kyselymerkkijonoparametreina muodossa botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Esimerkki:

Kirjainkoolla ei ole merkitystä parametrin nimessä. username=Ana toimii myös tässä esimerkissä.

Yleisen muuttujan lisääminen mukautettuun pohjaan

Voit myös lisätä muuttujan mukautettuun pohjaan.

  1. Määritä muuttujat <script>-osassa sillä sivulla, jolla agentti sijaitsee, seuraavasti korvaten arvon variableName1 muuttujan nimellä ilman Global.-etuliitettä ja käytä määritelmänä arvoa variableDefinition1. Käytä useiden muuttujien erottimena pilkkuja (,).

       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. Kutsu <script>-osassa store-kohdetta, kun upotat agenttisi, kuten seuraavassa esimerkissä, joka store kutsutaan juuri ennen kuin styleOptions kutsutaan (sinun on korvattava BOT_ID agenttisi tunnuksella):

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

Liittyvä sisältö