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. Asiakaspalvelija voi sitten puhutella asiakasta nimeltä 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-aihe 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.

Asiakaspalvelija muuttujat ovat käytössä yhden käyttäjäistunnon aikana. Määrität, mitä muuttujia käsitellään asiakaspalvelija-muuttujina, jotta ne erottuvat aihetason muuttujista.

Luo yleinen muuttuja

Luot yleisen muuttujan muuttamalla aihemuuttujan vaikutusalueen.

  1. Luo muuttuja tai avaa aiemmin luotu muuttuja Muuttujat-ruudussa .

  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, jos haluat tarkastella aihe käytettävissä olevia muuttujia. 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öskentelet uuden asiakaspalvelija parissa tai jos sinulla on useita muuttujia ja monimutkaisia aihe 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 kontekstissa, 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.

Aseta globaalit muuttujat upotetussa asiakaspalvelija

Jos upotat asiakaspalvelija yksinkertaiselle verkkosivulle, voit liittää muuttujia ja niiden määritelmiä asiakaspalvelija:n 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 asiakaspalvelija:n 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> sivun osiossa, jossa sinulla on asiakaspalvelija, seuraavasti korvaamalla variableName1 muuttujan nimi ilman Global. etuliitettä ja variableDefinition1 määritelmä. 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. Soita osiossasi <script> , kun upotat asiakaspalvelija, kuten seuraavassa esimerkissä, jossa store kutsutaan juuri sen yläpuolella, missä store kutsutaan (sinun on korvattava # styleOptions asiakaspalvelija-tunnuksellasi): BOT_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));

Liittyvä sisältö