Jaa

Muuttujien käyttäminen siirrettäessä sisältöä aiheiden välillä

  • Artikkeli

Muuttujat tallentavat asiakkaiden avustajan esittämiin kysymyksiin antamat vastakset. Voit esimerkiksi tallentaa asiakkaan nimen muuttujaan UserName. Tämän jälkeen avustaja 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. Tapahtuman varaaminen -aiheessa avustajan tulee muistaa, mitä tietoja asiakas on syöttänyt, jotta niitä ei tarvitse 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 yleisiksi muuttujiksi, koska niitä voi käyttää avustajan kaikissa aiheissa.

Avustajan muuttujat pätevät yksittäisen käyttäjäistunnon ajan. Määrität, mitä muuttujia käsitellään avustajan 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 -ruudun 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.

    Näyttökuvassa Muuttujan ominaisuudet -ruutu Yleinen-asetus korostettuna

  3. Tallenna aihe.

    Yleisen muuttujan nimen on oltava yksilöllinen kaikissa aiheissa. Ristiriitatapauksessa muuttuja on nimettävä uudelleen ennen aiheen tallentamista.

Käytä yleisiä muuttujia

Valitse Viesti- tai Kysymys-solmussa avustajan viestiä luodessasi {x}-kuvake, jotta näet aiheen käytettävissä olevat muuttujat. Yleiset muuttujat näkyvät Mukautettu-välilehdessä muiden aihemuuttujien lisäksi. Muuttujat luetellaan aakkosjärjestyksessä.

Näyttökuvassa yleisen muuttujan valinta

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ä voi olla hyötyä, jos olet käsittelemässä uutta avustajaa tai sinulla on useita muuttujia sekä monitasoista aiheiden haarautumista.

  1. Valitse yleinen muuttuja sisällön tuotantoalustasta tai avaa Muuttujat-ruutu ja valitse yleinen muuttuja.

  2. Valitse Viite-osan Muuttujan ominaisuudet -ruudussa mikä tahansa aihe, jossa muuttujaa käytetään, siirtyäksesi suoraan kyseiseen aiheeseen ja solmuun.

    Näyttökuvassa muuttujan käyttämien aiheiden luettelo Muuttujan ominaisuudet -ruudussa

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än aiheen voi käynnistää joko uudelleenohjaamalla tai kun käyttäjä määrittää 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ä avustaja käynnistää keskustelun tietyn kontekstin kanssa, voit käynnistää yleisen muuttujan, jolla on ulkoinen lähde. Oletetaan, että sivustosi edellyttää käyttäjien kirjautuvan sisään. Koska avustaja tietää jo käyttäjän nimen, se voi tervehtiä asiakkaita nimellä jo ennen kuin he kirjoittavat ensimmäisen kysymyksen.

  1. Valitse yleinen muuttuja.

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

Yleisten muuttujien määrittäminen upotetussa avustajassa

Jos avustaja upotetaan yksinkertaiseen verkkosivuun, voit liittää muuttujat ja niiden määritykset avustajan 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ä muuttujista tehdään yksinkertainen ilmoitus. 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 avustajan URL-osoitteeseen kyselymerkkijonoparametreina muodossa botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Esimerkki:

Kirjainkoolla ei ole merkitystä parametrin nimessä. username=Renata 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 avustaja 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 avustajan upottamisen yhteydessä, kuten seuraavassa esimerkissä, jossa store kutsutaan juuri sen yläpuolella, missä styleOptions kutsutaan (sinun on korvattava BOT_ID avustajan 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ö