Apex Bot iestatīšana

Iestatīšanas ceļvedis

1. Izveidojiet kontu un apstipriniet savu e-pasta adresi. Jūsu darbvieta un asistents tiek izveidoti automātiski.
2. Pievienojiet zināšanas. Norādiet Apex savas vietnes adresi, un tas izlasīs jūsu lapas. To, kā nav tiešsaistē, pievienojiet kā tekstu.
3. Pielāgojiet logrīku sadaļā Vadības panelis → Logrīks: nosaukums, krāsas, sveiciens, tonis un modelis.
4. Atļaujiet savu vietni sadaļā Uzstādīšana un drošība. Logrīks darbojas tikai tur norādītajās adresēs.
5. Ielīmējiet iegulšanas kodu savā vietnē un atveriet to, lai izmēģinātu sarunu.

Vadības paneļa Iestatīšanas saraksts seko šiem soļiem jūsu vietā.

Zināšanu bāze

Apex atbild, izmantojot tikai tam sniegto saturu. Sadaļā Vadības panelis → Zināšanu bāze varat pievienot divu veidu avotus:

• Vietne. Apex izlasa jūsu ievadīto lapu, vietnes karti un lapas tajā pašā domēnā, uz kurām tās norāda, līdz lapu limitam. Tas ievēro robots.txt un izlaiž izvēlnes, kājenes un sīkdatņu joslas. Ikreiz, kad vietne mainās, sinhronizējiet to vēlreiz.
• Teksts. Ielīmējiet BUJ, noteikumus vai produktu informāciju, kuras nav jūsu vietnē. Katram tekstam piešķiriet skaidru nosaukumu – tas tiek rādīts kā avots atbildēm, kurās teksts izmantots.

Ja nekas jūsu zināšanu bāzē pietiekami neatbilst jautājumam, asistents pasaka, ka nezina, nevis min, un, ja esat to ieslēguši, piedāvā nodot sarunu jūsu komandai. Cik precīzai jābūt atbilstībai, nosaka sadaļas Personība iestatījums Atbildes pārliecība.

Pielāgošana

Katram iestatījumam logrīka studijā ir tiešais priekšskatījums. Svarīgākie no tiem:

Izmaiņas darbojošajā logrīkā parādās aptuveni minūtes laikā pēc saglabāšanas.

Logrīka uzstādīšana

Nokopējiet iegulšanas kodu no Vadības panelis → Logrīks → Uzstādīšana un drošība. Tajā jau ir ievadīta jūsu vietnes atslēga, un tas izskatās šādi:

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

Ielīmējiet to tieši pirms noslēdzošā </body> taga katrā lapā, kurā jārāda tērzēšana. Pēc tam sadaļā Atļautās vietnes pievienojiet katru apmeklētāju izmantoto adresi, piemēram, https://example.com un https://www.example.com.

Vietnes atslēga apzināti ir publiska: tā darbojas tikai jūsu atļautajās vietnēs. Ja to izmanto ļaunprātīgi, nomainiet to tajā pašā ekrānā un atjauniniet koda fragmentu savā vietnē.

Platformas

WordPress

Izmantojiet galvenes un kājenes koda spraudni (piemēram, WPCode) un pievienojiet fragmentu visas vietnes kājenei vai ielīmējiet to motīva footer.php failā pirms </body>.

Shopify

Online Store → Themes → Edit code, atveriet layout/theme.liquid un ielīmējiet fragmentu pirms </body>.

Webflow, Wix un Squarespace

Pievienojiet to kā visas vietnes pielāgoto kodu kājenē: Site settings → Custom code (Webflow), Settings → Custom code (Wix) vai Settings → Advanced → Code injection (Squarespace).

React, Next.js un citas vienas lapas lietotnes

Ielādējiet skriptu vienreiz, piemēram, saknes izkārtojumā. Logrīks pats saglabā sarunu, mainoties lapām klienta pusē.

JavaScript API

Ja vēlaties, pirms skripta ielādes iestatiet window.Apex, lai konkrētā lapā mainītu dažus iestatījumus:

<script>
  // Neobligāti iestatījumi, kas tiek nolasīti, ielādējot logrīku
  window.Apex = {
    lang: "auto",                 // "auto", "tr", "en", "lt", "lv" vai "et"
    greeting: "Sveiki! Jautājiet jebko par mūsu veikalu.",
    suggestions: ["Piegādes termiņi", "Atgriešanas noteikumi"],
    theme: { primary: "#312c85", position: "bottom-right" },
  };
</script>

Pēc ielādes window.Apex ļauj vadīt logrīku ar jūsu pašu kodu. Izsaukumi, kas veikti pirms ielādes, tiek ievietoti rindā un izpildīti secīgi.

Apex.open()                          // atver tērzēšanu
Apex.close()                         // aizver to
Apex.toggle()                        // atver vai aizver
Apex.send("Kur ir mans pasūtījums?") // atver un uzdod jautājumu
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"))

Privātuma iestatījumi

• Sarunas tiek automātiski dzēstas pēc glabāšanas perioda, ko iestatāt sadaļā Uzstādīšana un drošība (pēc noklusējuma – 30 dienas).
• Apmeklētāji jebkurā laikā var sākt jaunu sarunu, un vecā tiek notīrīta no viņu pārlūka. Jebkuru saglabāto sarunu varat dzēst lapā “Sarunas”.
• E-pasta adreses, tālruņu un karšu numuri mūsu žurnālos tiek maskēti.
• Pievienojiet privātuma politikas saiti sadaļā Ziņas, lai tā tiktu rādīta logrīka kājenē.

Problēmu novēršana

Palaišanas poga netiek rādīta

• Pārbaudiet, vai lapas precīzā adrese (ieskaitot www un https) ir norādīta sadaļā Atļautās vietnes. Ja nav, pārlūka konsolē redzams ziņojums [Apex] Widget disabled: origin_not_allowed.
• Pārbaudiet, vai lapa neatrodas kādā no ceļiem sadaļā Uzvedība → Slēpt šajās lapās.
• Pārliecinieties, ka fragmenta src norāda uz https://api.apexbot.eu/widget.js un vietnes atslēga sakrīt ar atslēgu jūsu vadības panelī. Pēc atslēgas maiņas vecais fragments pārstāj darboties.

Tas pārāk bieži saka “nezinu”

• Pārbaudiet Zināšanu bāzi: vietnes avots, ko neizdevās nolasīt vai kurā atrasts maz lapu, parāda iemeslu.
• Pievienojiet trūkstošo informāciju kā teksta avotu.
• Nelielām zināšanu bāzēm iestatiet Personība → Atbildes pārliecība uz Elastīga.

Atbildes vairs nenāk

Iespējams, ir beidzies dienas tokenu budžets, kas iestatīts sadaļā Uzstādīšana un drošība; tādā gadījumā līdz pusnaktij pēc UTC tērzēšana piedāvā nodošanu cilvēkam. Varat arī pārbaudīt sistēmas statusa lapu.