Apex Bot paruošimas

Paruošimo vadovas

1. Susikurkite paskyrą ir patvirtinkite el. pašto adresą. Jūsų darbo sritis ir asistentas sukuriami automatiškai.
2. Pridėkite žinių. Nurodykite Apex savo svetainės adresą, ir jis perskaitys jūsų puslapius. Tai, ko nėra internete, pridėkite kaip tekstą.
3. Pritaikykite valdiklį skiltyje Valdymo skydelis → Valdiklis: pavadinimas, spalvos, pasisveikinimas, tonas ir modelis.
4. Leiskite savo svetainę skiltyje Diegimas ir saugumas. Valdiklis veikia tik ten nurodytais adresais.
5. Įklijuokite įterpimo kodą į savo svetainę ir ją atidarę išbandykite pokalbį.

Valdymo skydelio Paruošimo sąrašas seka šiuos žingsnius už jus.

Žinių bazė

Apex atsako tik remdamasis jam pateiktu turiniu. Skiltyje Valdymo skydelis → Žinių bazė galite pridėti dviejų rūšių šaltinius:

• Svetainė. Apex perskaito jūsų įvestą puslapį, svetainės žemėlapį ir puslapius tame pačiame domene, į kuriuos jie nukreipia, iki puslapių limito. Jis paiso robots.txt ir praleidžia meniu, poraštes bei slapukų juostas. Kaskart pasikeitus svetainei, sinchronizuokite ją iš naujo.
• Tekstas. Įklijuokite DUK, taisykles ar produktų informaciją, kurios nėra jūsų svetainėje. Kiekvienam tekstui suteikite aiškų pavadinimą – jis rodomas kaip atsakymų, kuriuose tekstas naudojamas, šaltinis.

Kai niekas jūsų žinių bazėje pakankamai neatitinka klausimo, asistentas pasako, kad nežino, užuot spėliojęs, ir, jei įjungėte, pasiūlo perduoti pokalbį jūsų komandai. Kaip tiksliai turinys turi atitikti klausimą, nustato skilties Asmenybė nustatymas Atsakymo užtikrintumas.

Pritaikymas

Kiekvienas nustatymas valdiklio studijoje turi tiesioginę peržiūrą. Svarbiausi iš jų:

Pakeitimai veikiančiame valdiklyje atsiranda maždaug per minutę po išsaugojimo.

Valdiklio diegimas

Nukopijuokite įterpimo kodą iš Valdymo skydelis → Valdiklis → Diegimas ir saugumas. Jame jau įrašytas jūsų svetainės raktas, o jis atrodo taip:

<script src="https://api.apexbot.eu/widget.js" data-site-key="apex_pk_…" async></script>

Įklijuokite jį prieš pat uždarančiąją </body> žymę kiekviename puslapyje, kuriame turi būti rodomas pokalbis. Tada skiltyje Leidžiamos svetainės pridėkite kiekvieną lankytojų naudojamą adresą, pavyzdžiui, https://example.com ir https://www.example.com.

Svetainės raktas sąmoningai yra viešas: jis veikia tik jūsų leistose svetainėse. Jei juo piktnaudžiaujama, pakeiskite jį tame pačiame ekrane ir atnaujinkite kodo fragmentą savo svetainėje.

Platformos

WordPress

Naudokite antraštės ir poraštės kodo įskiepį (pavyzdžiui, WPCode) ir pridėkite fragmentą į visos svetainės poraštę arba įklijuokite jį į temos footer.php prieš </body>.

Shopify

Online Store → Themes → Edit code, atidarykite layout/theme.liquid ir įklijuokite fragmentą prieš </body>.

Webflow, Wix ir Squarespace

Pridėkite jį kaip visos svetainės pasirinktinį kodą poraštėje: Site settings → Custom code (Webflow), Settings → Custom code (Wix) arba Settings → Advanced → Code injection (Squarespace).

React, Next.js ir kitos vieno puslapio programos

Įkelkite scenarijų vieną kartą, pavyzdžiui, pagrindiniame išdėstyme. Valdiklis pats išsaugo pokalbį keičiantis puslapiams kliento pusėje.

JavaScript API

Jei norite, prieš įkeliant scenarijų nustatykite window.Apex ir konkrečiame puslapyje pakeiskite kelis nustatymus:

<script>
  // Neprivalomi nustatymai, nuskaitomi įkeliant valdiklį
  window.Apex = {
    lang: "auto",                 // "auto", "tr", "en", "lt", "lv" arba "et"
    greeting: "Sveiki! Klauskite bet ko apie mūsų parduotuvę.",
    suggestions: ["Pristatymo terminai", "Grąžinimo taisyklės"],
    theme: { primary: "#312c85", position: "bottom-right" },
  };
</script>

Įkėlus valdiklį, window.Apex leidžia jį valdyti jūsų pačių kodu. Iškvietimai, atlikti prieš įkeliant, įtraukiami į eilę ir vykdomi iš eilės.

Apex.open()                          // atidaro pokalbį
Apex.close()                         // uždaro jį
Apex.toggle()                        // atidaro arba uždaro
Apex.send("Kur mano užsakymas?")     // atidaro ir užduoda klausimą
Apex.identify({ name: "Ada", email: "ada@example.com" })

Apex.on("message", (m) => console.log(m.text, m.sources))
Apex.on("open", () => analytics.track("chat_opened"))

Privatumo valdymas

• Pokalbiai automatiškai ištrinami praėjus saugojimo laikotarpiui, kurį nustatote skiltyje Diegimas ir saugumas (pagal numatytuosius nustatymus – 30 dienų).
• Lankytojai bet kada gali pradėti naują pokalbį – tada senasis ištrinamas iš jų naršyklės. Bet kurį išsaugotą pokalbį galite ištrinti puslapyje „Pokalbiai“.
• El. pašto adresai, telefono ir kortelių numeriai mūsų žurnaluose užmaskuojami.
• Pridėkite privatumo politikos nuorodą skiltyje Žinutės, kad ji būtų rodoma valdiklio poraštėje.

Trikčių šalinimas

Paleidimo mygtukas nerodomas

• Patikrinkite, ar tikslus puslapio adresas (įskaitant www ir https) nurodytas skiltyje Leidžiamos svetainės. Jei ne, naršyklės konsolėje rodomas pranešimas [Apex] Widget disabled: origin_not_allowed.
• Patikrinkite, ar puslapis nepatenka į kurį nors kelią skiltyje Elgsena → Slėpti šiuose puslapiuose.
• Įsitikinkite, kad fragmento src nukreipia į https://api.apexbot.eu/widget.js, o svetainės raktas sutampa su raktu jūsų valdymo skydelyje. Pakeitus raktą, senas fragmentas nustoja veikti.

Jis per dažnai sako „nežinau“

• Patikrinkite Žinių bazę: svetainės šaltinis, kurio nepavyko perskaityti arba kuriame rasta mažai puslapių, parodo priežastį.
• Pridėkite trūkstamą informaciją kaip tekstinį šaltinį.
• Mažoms žinių bazėms nustatymą Asmenybė → Atsakymo užtikrintumas pakeiskite į Lankstus.

Atsakymai nebeateina

Galbūt baigėsi dienos žetonų biudžetas, nustatytas skiltyje Diegimas ir saugumas; tokiu atveju iki vidurnakčio pagal UTC pokalbis siūlo perdavimą žmogui. Taip pat galite patikrinti sistemos būsenos puslapį.