Liigu põhisisu juurde
ChattyBox Logo

Vidina seadistamine ja kohandamine

Lisage oma veebisaidile AI-toega vestlusvidin vähem kui 5 minutiga.

Kiirseadistus​

Chatboti käivitamine on lihtne. Kopeerige oma juhtpaneelilt vaid lühike koodilõik.

1. samm: hankige manustamiskood​

  1. Avage juhtpaneel ja valige projekt.
  2. Minge vahekaardile Manusta.
  3. Valige kasutatav API-võti või looge uus.
  4. Kopeerige loodud koodilõik.

2. samm: lisage see veebisaidile​

Kleepige koodilõik vahetult enne sulgevat </body> märgendit igale lehele, kus vestlusvidin peab ilmuma.

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-locale="et"
  data-api-url="https://adorable-woodpecker-629.convex.site/chat"
  async
></script>

:::tip Nõuanne See on kõik. Värve ja seadeid ei pea koodis muutma; kõik hallatakse juhtpaneelilt. :::

Visuaalne kohandamine​

ChattyBox sisaldab sisseehitatud visuaalset redaktorit. Saate vidina välimuse oma kaubamärgiga sobitada ilma koodi muutmata.

Juhtpaneeli seaded​

  1. Aktsentvärv - Valige kaubamärgi põhivärv käivitaja, esiletõstude ja kasutajasõnumite jaoks.
  2. Asukoht - Määrake, kus vidin ekraanil kuvatakse.
  3. Päise pealkiri - Määrake vestlusakna ülaosas kuvatav pealkiri.
  4. Tervitussõnum - Kohandage esimest sõnumit, mida külastajad näevad.
märkus

Juhtpaneelis tehtud muudatused rakenduvad kohe. Manustamiskoodi ei ole vaja saidil uuendada.

Täpsemad valikud​

Juhtpaneeli seaded ja skripti atribuudid​

Enamikku vidina käitumisest tuleks hallata juhtpaneelilt, et lihtsate muudatuste jaoks ei peaks veebisaiti uuesti avaldama.

Kasutage juhtpaneeli värvide, asukoha, ikooni, päise, tervitussõnumi, vaikekeele, avalike võtmete, scrapingu ja analüütika jaoks.

Kui projekt kasutab avalike võtmete päritolupiiranguid, hoidke need kooskõlas domeenidega, kuhu vidin on paigaldatud.

Kasutage skripti atribuute ainult väärtuste jaoks, mida vidin vajab lehe laadimisel:

  • data-api-key tuvastab avaliku vidinavõtme.
  • data-api-url ütleb vidinale, kuhu päringud saata.
  • data-locale võib sundida selle lehe liidese keele.

Kui vidin pärast paigaldamist ei ilmu, vaadake tõrkeotsingut.

Vidina peitmine kindlatel lehtedel​

Valitud lehtedel saab vidina peita CSS-iga:

.chattybox-widget {
  display: none;
}

Kohandatud integratsioonid​

Kas vajate standardvidinast täpsemat lahendust?

Võtke meiega ühendust aadressil [email protected] ja aitame valida sobiva integratsiooniviisi.

Mitmekeelne tugi​

ChattyBoxi vidin kohandub automaatselt külastajate keeleeelistustega ja pakub lokaliseeritud kasutuskogemust.

Ametlikult toetatud keeled​

Vidina liides, sealhulgas nupud, sildid ja süsteemisõnumid, on ametlikult toetatud 14 keeles:

KeelKoodVidina liidesAI-vastuste kvaliteet
IngliseenTäielik tugiSuurepärane
PrantsusefrTäielik tugiKõrge
SaksadeTäielik tugiKõrge
HispaaniaesTäielik tugiKõrge
ItaaliaitTäielik tugiKõrge
HollandinlTäielik tugiKõrge
PortugaliptTäielik tugiKõrge
PoolaplTäielik tugiKõrge
RootsisvTäielik tugiKõrge
IndoneesiaidTäielik tugiKeskmine
EestietTäielik tugiKeskmine
SoomefiTäielik tugiKeskmine
WalesicyTäielik tugiKeskmine
TšehhicsTäielik tugiKeskmine

:::note Laiendatud keeletugi Kuigi vidina liides toetab ametlikult 14 keelt, suudab aluseks olev AI mõista ja vastata 100+ keeles. Väljaspool ametlikku loendit ei saa me siiski tagada sama kõrget kvaliteeti. :::

Kuidas keeletuvastus töötab​

Vidin kasutab astmelist tuvastussüsteemi:

  1. Atribuut data-locale - Kõrgeim prioriteet. Määrake see koodis, et sundida kindel keel.
  2. Lehe <html lang> atribuut - Vidin kontrollib lehe deklareeritud keelt.
  3. Brauseri keel (navigator.language) - Kasutab külastaja eelistusi.
  4. Vaikevaru - Inglise keel, kui keelt ei tuvastata.

Keele käsitsi määramine​

Vidina keele sundimiseks sõltumata brauserist lisage data-locale:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-locale="et"
  data-api-url="https://adorable-woodpecker-629.convex.site/chat"
  async
></script>

:::tip Kasutusjuht See on kasulik, kui mitmekeelsel saidil on igal keelel oma URL, näiteks /de/ või /fr/. Määrake data-locale vastavalt lehe keelele. :::

Keele seaded juhtpaneelis​

Rakenduse juhtpaneelis saab vidina keele-eelistusi seadistada projekti kaupa:

  • Automaatne tuvastus (soovitatav) - Vastab külastaja brauseri keelele.
  • Fikseeritud keel - Sunnib vidinat alati kasutama kindlat keelt.
  • Luba skripti ülekirjutus - Lubab või keelab data-locale kasutamise.

Need seaded on juhtpaneelis → Projekt → Manusta → Vidina keel.

Sisu keele sobitamine​

Parima mitmekeelse kogemuse jaoks peaks chatbot vastama kasutaja küsimusega samas keeles. Selleks:

  1. Scrape'ige kõik dokumentatsiooni keeleversioonid failiga sitemap.xml.
  2. Scraper märgib sisu automaatselt õige keelega.
  3. RAG-süsteem hangib päringu põhjal sobiva keeleversiooni.

Seadistus juhtpaneelis: scrapingu seadistamisel kasutage sitemap.xml URL-i, näiteks https://yourdocs.com/sitemap.xml, et kõik keeleversioonid leitaks ja indekseeritaks.

Tõrkeotsing​

Vidin näitab endiselt inglise keelt​

  • Tühjendage brauseri vahemälu - widget.js võib olla vahemälus. Tehke täielik värskendus (Ctrl+F5 / Cmd+Shift+R).
  • Kontrollige data-locale - Veenduge, et atribuudis on toetatud keelekood.
  • Kontrollige brauseri keelt - Veenduge, et eelistatud keel on õige.
  • Kontrollige HTML lang väärtust - Leht peaks kasutama <html lang="et"> või sobivat koodi.

Allikad on vales keeles​

  • Scrape'ige sisu uuesti - Veenduge, et kõik keeleversioonid on indekseeritud.
  • Kasutage sitemap.xml faili - Nii leiab scraper URL-id nagu /de/ ja /fr/.
  • Kontrollige küsimuse keelt - AI proovib vastuse keele küsimusega sobitada.

Puuduvad tõlked​

  • Kontrollige toetatud keeli - Garanteeritud UI-tõlked on ainult ülaltoodud 14 keeles.

Head tavad​

  1. Määrake lehtedel <html lang> - See aitab ligipääsetavust ja vidina tuvastust.
  2. Testige arenduses data-locale abil - Kontrollige, et iga keel kuvatakse õigesti.
  3. Scrape'ige kõik keeleversioonid - Kasutage täielikuks mitmekeelseks indekseerimiseks sitemap.xml faili.
  4. Jälgige keelte jaotust - Vaadake analüütikast, milliseid keeli külastajad enim kasutavad.