Dokumentatsioon

Apex Boti seadistamine

Kõik, mida vajate registreerumisest kuni töötava assistendini oma veebisaidil. Enamikul saitidel võtab see alla kümne minuti.

Seadistusjuhend

  1. Looge konto ja kinnitage oma e-posti aadress. Teie tööruum ja assistent luuakse automaatselt.
  2. Lisage teadmisi. Andke Apexile oma veebisaidi aadress ja see loeb teie lehed läbi. Lisage tekstina kõik, mida veebis pole.
  3. Kohandage vidinat jaotises Töölaud → Vidin: nimi, värvid, tervitus, toon ja mudel.
  4. Lubage oma veebisait jaotises Paigaldamine ja turvalisus. Vidin töötab ainult seal loetletud aadressidel.
  5. Kleepige manustamiskood oma saidile ja avage see, et vestlust proovida.

Töölaua Seadistamise kontrollnimekiri jälgib neid samme teie eest.

Teadmusbaas

Apex vastab ainult talle antud sisu põhjal. Jaotises Töölaud → Teadmusbaas saate lisada kahte liiki allikaid:

  • Veebisait. Apex loeb teie sisestatud lehe, saidikaardi ja samas domeenis olevad lehed, millele need viitavad, kuni lehtede piirmäärani. See järgib faili robots.txt ning jätab vahele menüüd, jalused ja küpsiseribad. Sünkroonige see uuesti alati, kui teie sait muutub.
  • Tekst. Kleepige KKK, tingimused või tooteandmed, mida teie veebisaidil pole. Andke igaühele selge pealkiri – seda näidatakse allikana vastustes, mis seda kasutavad.

Kui miski teie teadmusbaasis ei vasta küsimusele piisavalt hästi, ütleb assistent arvamise asemel, et ei tea, ja pakub, kui olete selle sisse lülitanud, vestluse üleandmist teie meeskonnale. Kui täpne peab vaste olema, määrab jaotise Isikupära seade Vastuse kindlus.

Kohandamine

Igal seadel on vidinastuudios reaalajas eelvaade. Kõige olulisemad neist:

JaotisMida see määrab
ÜldineRoboti ja ettevõtte nime, päise alapealkirja, vaikekeele ja liidese keele
VälimusBrändi värvi, teema, avamisnupu ikooni, teksti ja asukoha, akna laiuse, nurkade raadiuse ja fondi
SõnumidTervituse, soovitatud küsimused, vastuse „ma ei tea“, hoiatuse ja privaatsuslingi
KäitumineAutomaatse avamise, kutsemulli, allikad, hinnangud, kui kaua vestlusi meeles peetakse ja millistel lehtedel peita
TI mudelTeenusepakkuja, mudeli, loovuse, vastuse sügavuse, vastuse pikkuse, mälu ja varumudeli
IsikupäraTooni, vastuse pikkuse, emotikonid, teie enda juhised, teemad, millest keelduda, ja vastuse kindluse
Üleandmine ja kontaktidE-posti aadressi, kuhu üleandmised saadetakse, ja valikulise kontaktivormi enne vestlust

Muudatused jõuavad töötavasse vidinasse umbes minuti jooksul pärast salvestamist.

Vidina paigaldamine

Kopeerige manustamiskood jaotisest Töölaud → Vidin → Paigaldamine ja turvalisus. Sinna on juba sisestatud teie saidivõti ja see näeb välja selline:

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

Kleepige see vahetult enne lõpetavat silti </body> igal lehel, kus vestlus peab olema nähtav. Seejärel lisage jaotises Lubatud veebisaidid iga külastajate kasutatav aadress, näiteks https://example.com ja https://www.example.com.

Saidivõti on teadlikult avalik: see töötab ainult teie lubatud veebisaitidel. Kui seda kuritarvitatakse, vahetage see samal ekraanil välja ja uuendage oma saidil koodijuppi.

Platvormid

WordPress

Kasutage päise ja jaluse koodipluginat (näiteks WPCode) ja lisage koodijupp kogu saidi jalusesse või kleepige see oma teema faili footer.php enne silti </body>.

Shopify

Online Store → Themes → Edit code, avage layout/theme.liquid ja kleepige koodijupp enne silti </body>.

Webflow, Wix ja Squarespace

Lisage see kogu saiti hõlmava kohandatud koodina jalusesse: Site settings → Custom code (Webflow), Settings → Custom code (Wix) või Settings → Advanced → Code injection (Squarespace).

React, Next.js ja muud üheleherakendused

Laadige skript üks kord, näiteks juurpaigutuses. Vidin säilitab vestluse kliendipoolsete lehevahetuste ajal ise.

JavaScripti API

Soovi korral määrake enne skripti laadimist window.Apex, et konkreetsel lehel mõnda seadet muuta:

<script>
  // Valikulised seaded, mida loetakse vidina laadimisel
  window.Apex = {
    lang: "auto",                 // "auto", "tr", "en", "lt", "lv" või "et"
    greeting: "Tere! Küsige meie poe kohta mida iganes.",
    suggestions: ["Tarneajad", "Tagastustingimused"],
    theme: { primary: "#312c85", position: "bottom-right" },
  };
</script>

Pärast laadimist võimaldab window.Apex vidinat teie enda koodiga juhtida. Enne laadimist tehtud kutsed pannakse järjekorda ja täidetakse järjest.

Apex.open()                          // avab vestluse
Apex.close()                         // sulgeb selle
Apex.toggle()                        // avab või sulgeb
Apex.send("Kus minu tellimus on?")   // avab ja esitab küsimuse
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"))
SündmusMillal see käivitub
open / closeVestlusaken avatakse või suletakse
messageVastuse voogedastus on lõppenud; saadakse { text, sources }
leadKülastaja esitas kontaktivormi; saadakse { email, name, phone }
handoffKülastaja saatis taotluse „Räägi inimesega“

Privaatsusseaded

  • Vestlused kustutatakse automaatselt pärast säilitusaega, mille määrate jaotises Paigaldamine ja turvalisus (vaikimisi 30 päeva).
  • Külastajad saavad igal ajal alustada uut vestlust, mis kustutab vana nende brauserist. Iga salvestatud vestluse saate kustutada lehel „Vestlused“.
  • E-posti aadressid, telefoni- ja kaardinumbrid maskeeritakse meie logides.
  • Lisage privaatsuspoliitika link jaotises Sõnumid, et see kuvataks vidina jaluses.

Tõrkeotsing

Avamisnuppu ei kuvata

  • Kontrollige, et lehe täpne aadress (koos www ja https osaga) oleks loetletud jaotises Lubatud veebisaidid. Kui pole, kuvab brauseri konsool teate [Apex] Widget disabled: origin_not_allowed.
  • Kontrollige, et leht ei asuks ühelgi jaotises Käitumine → Peida nendel lehtedel loetletud teel.
  • Veenduge, et koodijupi src viitab aadressile https://api.apexbot.eu/widget.js ja saidivõti ühtib teie töölaual olevaga. Pärast võtme vahetamist lakkab vana koodijupp töötamast.

See ütleb liiga sageli „ma ei tea“

  • Vaadake Teadmusbaasi: veebisaidi allikas, mille lugemine ebaõnnestus või kust leiti vähe lehti, näitab põhjust.
  • Lisage puuduv teave tekstiallikana.
  • Väikeste teadmusbaaside puhul seadke Isikupära → Vastuse kindlus väärtusele Leebe.

Vastused lakkasid

Võib-olla on jaotises Paigaldamine ja turvalisus määratud päevane tokenieelarve otsa saanud; sel juhul pakub vestlus kuni UTC keskööni inimesele üleandmist. Võite vaadata ka süsteemi oleku lehte.