Jaa

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

  • Artikkeli

Muuttujat tallentavat asiakkaidesi vastaukset asiakaspalvelija 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ä asiakaspalvelija 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 asiakaspalvelija.

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

Kun kirjoitat asiakaspalvelija-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ä.

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 työstät uutta agenttia 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ä asiakaspalvelija aloittaa keskustelun jollakin kontekstilla, voit alustaa yleisen muuttujan ulkoisella lähteellä. Oletetaan, että sivustosi edellyttää käyttäjien kirjautuvan sisään. Koska asiakaspalvelija 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ä 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 agentin 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 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ä, jossa store kutsutaan juuri sen yläpuolella, missä styleOptions kutsutaan (sinun on korvattava BOT_ID omalla tunnuksellasi):

    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ö