Hostitud vidina kohandamine

Kohandage valmis kasutajaliidest, mida laaditakse aadressilt https://chattybox.ai/widget.js. Raamistike ja platvormide ametlikud paigaldusnäited leiate paigaldusjuhenditest.

Enne kohandamist

Looge projekt, indekseerige selle sisu ja kontrollige tüüpilisi vastuseid Test Chat-is, enne kui hakkate esitlusele aega kulutama. Täielikku järjekorda kirjeldab Alustamise leht.

Hostitud vidina seadistamine

1. Avage juhtpaneel ja valige oma projekt.
2. Avage vahekaart Embed.
3. Vaadake vidina välimus ja keelekäitumine eelvaates üle ning salvestage need.

Vahekaart Embed juhib esitlust ja loob paigalduskoodi, kuid avalikke võtmeid hallatakse eraldi. Kui olete valmis paigaldama:

1. Avage Public Keys ja looge brauserivõti.
2. Piirake selle lubatud origin’id soovitud veebisaidi domeenidega.
3. Naaske jaotisse Embed, valige võti ja kopeerige loodud koodilõik.
4. Järgige oma platvormi paigaldusjuhendeid.

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

nõuanne

Juhtpaneelil salvestatud vidina esitluse muudatused rakenduvad ilma teie saidil oleva koodilõigu asendamiseta.

---

Visuaalne kohandamine

ChattyBox sisaldab täielikult integreeritud visuaalset redaktorit. Saate vidina välimuse ja tunnetuse oma brändiga täpselt sobitada ilma koodi muutmata.

Juhtpaneeli juhtelemendid

1. Accent Color - Valige oma brändi põhivärv. See mõjutab avajat, olulisi esiletõsteid ja kasutaja sõnumeid.

2. Position - Valige, kus vidin ekraanil kuvatakse.

3. Header Title - Määrake vestlusakna ülaosas kuvatav pealkiri.

4. Welcome Message - Kohandage esimest sõnumit, mida külastajad vestluse avamisel näevad.

märkus

Juhtpaneelil tehtud muudatused rakenduvad kohe. Veebisaidil olevat manustamiskoodi pole vaja uuendada.

Täpsemad valikud

Juhtpaneeli seaded ja skriptiatribuudid

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

Kasutage juhtpaneeli värvide, asukoha, ikooni, pealkirja, tervitussõnumi, vaikekeele, avalike võtmete haldamise, kraapimise ja Analyticsi jaoks.

Kui teie projekt kasutab avaliku võtme origin’ide piiranguid, hoidke piirangud sünkroonis domeenidega, kuhu vidin on paigaldatud.

Kasutage skriptiatribuute ainult väärtuste jaoks, mida vidin vajab lehe laadimise ajal:

• data-api-key tuvastab avaliku vidinavõtme.
• data-api-url ütleb vidinale, kuhu päringud saata. Tootmises on see juhtpaneelilt pärit stabiilne https://...convex.site/chat URL.
• data-locale sunnib soovi korral selle lehe vidina kasutajaliidese kindlat keelt kasutama.

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

Platvormipõhiste näidete jaoks alustage Docusauruse, MkDocsi, VitePressi, WordPressi või GitBooki juhendist.

Vidina peitmine kindlatel lehtedel

Kui peate vidina valitud lehtedel peitma, saate seda teha CSS-i abil:

.chattybox-widget {
  display: none;
}

Kohandatud integratsioonid

Kas vajate hostitud vidinast kohandatumat lahendust? Looge oma kasutajaliides JavaScripti SDK abil või kirjutage arhitektuurialase abi saamiseks aadressil support@chattybox.ai.

Mitmekeelne tugi

ChattyBoxi vidin kohandub automaatselt külastajate keele-eelistustega ja pakub kasutajatele üle kogu maailma lokaliseeritud kasutuskogemust.

Ametlikult toetatud keeled

Vidina kasutajaliidest (nupud, sildid ja süsteemisõnumid) toetatakse ametlikult 14 keeles:

Keel	Kood	Vidina kasutajaliides	AI-vastuste kvaliteet
Inglise	en	Täielik tugi	Suurepärane
Prantsuse	fr	Täielik tugi	Kõrge
Saksa	de	Täielik tugi	Kõrge
Hispaania	es	Täielik tugi	Kõrge
Itaalia	it	Täielik tugi	Kõrge
Hollandi	nl	Täielik tugi	Kõrge
Portugali	pt	Täielik tugi	Kõrge
Poola	pl	Täielik tugi	Kõrge
Rootsi	sv	Täielik tugi	Kõrge
Indoneesia	id	Täielik tugi	Keskmine
Eesti	et	Täielik tugi	Keskmine
Soome	fi	Täielik tugi	Keskmine
Kõmri	cy	Täielik tugi	Keskmine
Tšehhi	cs	Täielik tugi	Keskmine

:::note Laiendatud keeletugi Kuigi vidina kasutajaliidest toetatakse ametlikult 14 keeles, mõistab aluseks olev AI üle 100 keele ja suudab neis vastata. Väljaspool ametlikult toetatud loendit olevate keelte puhul ei saa me siiski tagada vastuste kõrget kvaliteeti. :::

Kuidas keele tuvastamine töötab

Vidin kasutab ahelas toimivat tuvastussüsteemi:

1. Atribuut data-locale - Kõrgeim prioriteet. Lisage see manustamiskoodile kindla keele sundimiseks.
2. Lehe atribuut <html lang> - Vidin kontrollib lehel deklareeritud keelt.
3. Brauseri keel (navigator.language) - Kasutab külastaja brauseri-eelistusi.
4. Vaikimisi varukeel - Inglise keel, kui keelt ei tuvastata.

Keele käsitsi ülekirjutamine

Vidina kuvamiseks kindlas keeles brauseri seadetest sõltumata lisage atribuut data-locale:

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

:::tip Kasutusjuht See on eriti kasulik mitmekeelse veebisaidi puhul, kus igal keeleversioonil on oma URL (nt /de/, /fr/). Ühtlase kasutuskogemuse tagamiseks seadke data-locale vastama iga lehe keelele. :::

Juhtpaneeli keeleseaded

Rakenduse juhtpaneel võimaldab projekti kaupa vidina keele-eelistusi seadistada:

• Auto-detect (soovitatav) - Sobitab vidina keele automaatselt külastaja brauseri keelega
• Fixed Language - Sunnib vidina alati kindlas keeles kuvama
• Allow Script Override - Lubab või keelab atribuudi data-locale ülekirjutuse

Need seaded leiate juhtpaneelist → Projekt → vahekaart Embed → jaotis Widget Language.

Sisu keele sobitamine

Parima mitmekeelse kogemuse jaoks peaks vestlusrobot vastama kasutaja küsimusega samas keeles. Selleks tehke järgmist:

1. Kraapige dokumentatsiooni kõik keeleversioonid faili sitemap.xml abil.
2. Kraapija märgendab sisu keele automaatselt.
3. RAG-süsteem hangib päringu põhjal sobiva keeleversiooni.

Seadistamine rakenduse juhtpaneelil: kasutage kraapimise seadistamisel oma sitemap.xml URL-i (nt https://yourdocs.com/sitemap.xml), et kõik sisu keeleversioonid automaatselt avastada ja indekseerida.

Tõrkeotsing

Vidin näitab endiselt inglise keelt

• Sundvärskendus diagnostikana - Laadige leht uuesti klahvidega Ctrl+F5 või Cmd+Shift+R ja kontrollige brauseri võrgupaneelil vidina- ja tõlkepäringuid
• Kontrollige data-locale-i - Veenduge, et atribuut on õigesti määratud toetatud keelekoodile
• Kontrollige brauseri keelt - Veenduge, et brauseri eelistatud keel on õigesti seadistatud
• Kontrollige lehe HTML-i lang-atribuuti - Veenduge, et lehel on <html lang="de"> (või sobiv kood)

Allikad on vales keeles

• Kraapige sisu uuesti - Veenduge, et kõik keeleversioonid on indekseeritud
• Kasutage sitemap.xml-i - See tagab, et kraapija leiab kõik URL-id /de/, /fr/ jne
• Kontrollige päringu keelt - AI proovib vastuse keelt päringu keelega sobitada

Tõlked puuduvad

• Kontrollige toetatud keeli - Ainult ülal loetletud 14 keele kasutajaliidese tõlked on garanteeritud

Head tavad

1. Määrake lehtedel <html lang> - See aitab nii juurdepääsetavuse kui ka vidina tuvastamisega
2. Testige arenduse ajal data-locale-iga - Kontrollige, et iga keel renderdub õigesti
3. Kraapige kõik keeleversioonid - Kasutage täielikuks mitmekeelseks indekseerimiseks sitemap.xml-i
4. Jälgige keelte jaotust - Vaadake Analyticsist, milliseid keeli külastajad kõige rohkem kasutavad