Addasu’r Widget Lletyol

Addaswch y rhyngwyneb parod a lwythir gan https://chattybox.ai/widget.js. Am enghreifftiau gosod fframweithiau a llwyfannau canonaidd, gweler Canllawiau Gosod.

Cyn Addasu

Crëwch y prosiect, mynegeiwch ei gynnwys, a gwiriwch atebion cynrychioliadol yn Test Chat cyn treulio amser ar gyflwyniad. Gweler Dechrau Arni am y dilyniant cyflawn.

Ffurfweddu’r Widget Lletyol

1. Ewch i’ch Dangosfwrdd a dewiswch eich prosiect.
2. Ewch i’r tab Embed.
3. Rhagolygwch a chadwch olwg ac ymddygiad iaith y widget.

Mae’r tab Embed yn rheoli’r cyflwyniad ac yn cynhyrchu cod gosod, ond caiff allweddi cyhoeddus eu rheoli ar wahân. Pan fyddwch yn barod i osod:

1. Agorwch Public Keys a chrëwch allwedd porwr.
2. Cyfyngwch ei tharddiadau a ganiateir i barthau’r wefan a fwriadwyd.
3. Dychwelwch i Embed, dewiswch yr allwedd, a chopïwch y pyt a gynhyrchwyd.
4. Dilynwch Ganllawiau Gosod ar gyfer eich platfform.

<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>

awgrym

Mae newidiadau i gyflwyniad y widget a gedwir yn y dangosfwrdd yn berthnasol heb ddisodli’r pyt ar eich gwefan.

---

Addasu Gweledol

Mae ChattyBox yn cynnwys golygydd gweledol cwbl integredig. Gallwch newid golwg a theimlad eich widget i gyd-fynd yn berffaith â’ch brand heb gyffwrdd ag unrhyw god.

Rheolyddion y Dangosfwrdd

1. Accent Color - Dewiswch brif liw eich brand. Mae hyn yn effeithio ar y lansiwr, prif uchafbwyntiau a negeseuon defnyddwyr.

2. Position - Dewiswch ble mae’r widget yn ymddangos ar y sgrin.

3. Header Title - Gosodwch y teitl sy’n ymddangos ar frig y ffenestr sgwrsio.

4. Welcome Message - Addaswch y neges gyntaf y mae ymwelwyr yn ei gweld pan fyddant yn agor y sgwrs.

nodyn

Caiff newidiadau a wneir yn y dangosfwrdd eu cymhwyso ar unwaith. Nid oes angen diweddaru’r cod mewnosod ar eich gwefan.

Dewisiadau Uwch

Gosodiadau’r Dangosfwrdd yn erbyn Priodoleddau Sgript

Dylid rheoli’r rhan fwyaf o ymddygiad y widget o’r dangosfwrdd fel nad oes angen ail-ddefnyddio eich gwefan ar gyfer newidiadau syml.

Defnyddiwch y dangosfwrdd ar gyfer lliwiau, safle, eicon, teitl pennyn, neges groeso, ieithoedd diofyn, rheoli allweddi cyhoeddus, sgrapio a dadansoddeg.

Os yw eich prosiect yn defnyddio cyfyngiadau tarddiad allweddi cyhoeddus, cadwch y cyfyngiadau hynny’n gyson â’r parthau lle mae’r widget wedi’i osod.

Defnyddiwch briodoleddau sgript dim ond ar gyfer gwerthoedd sydd eu hangen ar y widget wrth lwytho’r dudalen:

• Mae data-api-key yn nodi allwedd widget gyhoeddus.
• Mae data-api-url yn dweud wrth y widget ble i anfon ceisiadau. Wrth gynhyrchu, URL sefydlog https://...convex.site/chat o’ch dangosfwrdd yw hwn.
• Mae data-locale yn gallu gorfodi iaith UI benodol y widget ar gyfer y dudalen honno.

Os nad yw’r widget yn ymddangos ar ôl ei osod, gweler Datrys Problemau.

Am enghreifftiau penodol i blatfform, dechreuwch gyda Docusaurus, MkDocs, VitePress, WordPress, neu GitBook.

Cuddio’r Widget ar Dudalenau Penodol

Os oes angen cuddio’r widget ar dudalennau dethol, gallwch wneud hynny gyda CSS:

.chattybox-widget {
  display: none;
}

Integreiddiadau Personol

Angen gosodiad mwy pwrpasol na’r widget lletyol? Adeiladwch eich rhyngwyneb eich hun gyda’r SDK JavaScript, neu cysylltwch â support@chattybox.ai am help pensaernïol.

Cymorth Amlieithog

Mae widget ChattyBox yn addasu’n awtomatig i ddewisiadau iaith eich ymwelwyr, gan ddarparu profiad wedi’i leoleiddio i ddefnyddwyr ledled y byd.

Ieithoedd a Gefnogir yn Swyddogol

Mae rhyngwyneb y widget (botymau, labeli a negeseuon system) yn cael ei gefnogi’n swyddogol mewn 14 iaith:

Iaith	Cod	UI Widget	Ansawdd Atebion AI
Saesneg	en	Cymorth Llawn	Rhagorol
Ffrangeg	fr	Cymorth Llawn	Uchel
Almaeneg	de	Cymorth Llawn	Uchel
Sbaeneg	es	Cymorth Llawn	Uchel
Eidaleg	it	Cymorth Llawn	Uchel
Iseldireg	nl	Cymorth Llawn	Uchel
Portiwgaleg	pt	Cymorth Llawn	Uchel
Pwyleg	pl	Cymorth Llawn	Uchel
Swedeg	sv	Cymorth Llawn	Uchel
Indoneseg	id	Cymorth Llawn	Canolig
Estoneg	et	Cymorth Llawn	Canolig
Ffinneg	fi	Cymorth Llawn	Canolig
Cymraeg	cy	Cymorth Llawn	Canolig
Tsieceg	cs	Cymorth Llawn	Canolig

:::note Cymorth Iaith Estynedig Er ein bod yn cefnogi 14 iaith yn swyddogol ar gyfer rhyngwyneb y widget, gall yr AI sylfaenol ddeall ac ateb mewn 100+ o ieithoedd. Fodd bynnag, ni allwn warantu atebion o ansawdd uchel ar gyfer ieithoedd y tu allan i’n rhestr swyddogol. :::

Sut Mae Canfod Iaith yn Gweithio

Mae’r widget yn defnyddio system ganfod rhaeadrol:

1. Priodoledd data-locale - Blaenoriaeth uchaf. Gosodwch hwn ar eich cod mewnosod i orfodi iaith benodol.
2. Priodoledd <html lang> y dudalen - Mae’r widget yn gwirio iaith ddatganedig eich tudalen.
3. Iaith y porwr (navigator.language) - Yn defnyddio dewisiadau’r ymwelydd.
4. Diofyn wrth gefn - Saesneg os na chaiff iaith ei chanfod.

Diystyru Iaith â Llaw

I orfodi’r widget i ddangos mewn iaith benodol waeth beth fo gosodiadau’r porwr, ychwanegwch y briodoledd 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 Achos Defnydd Mae hyn yn arbennig o ddefnyddiol os oes gan wefan amlieithog URL ei hun ar gyfer pob fersiwn iaith (e.e. /de/, /fr/). Gosodwch data-locale i gyd-fynd ag iaith pob tudalen er mwyn cael profiad cyson. :::

Gosodiadau Iaith y Dangosfwrdd

Mae dangosfwrdd yr ap yn gadael i chi ffurfweddu dewisiadau iaith y widget fesul prosiect:

• Auto-detect (Argymhellir) - Yn cyd-fynd yn awtomatig ag iaith porwr yr ymwelydd
• Fixed Language - Yn gorfodi’r widget i ddangos mewn iaith benodol bob amser
• Allow Script Override - Yn galluogi/analluogi diystyru’r briodoledd data-locale

Gwelwch y gosodiadau hyn yn eich Dangosfwrdd → Prosiect → tab Embed → adran Widget Language.

Cyfateb Iaith y Cynnwys

I gael y profiad amlieithog gorau, dylai eich chatbot ddychwelyd atebion yn yr un iaith â chwestiwn y defnyddiwr. I gyflawni hyn:

1. Sgrapiwch bob fersiwn iaith o’ch dogfennaeth gan ddefnyddio’r ffeil sitemap.xml
2. Bydd y scraper yn tagio cynnwys gyda’i iaith yn awtomatig
3. Mae’r system RAG yn adalw’r fersiwn iaith briodol ar sail yr ymholiad

Gosod yn Nangosfwrdd yr Ap: Wrth ffurfweddu sgrapio, defnyddiwch URL eich sitemap.xml (e.e. https://yourdocs.com/sitemap.xml) i ddarganfod a mynegeio pob fersiwn iaith o’ch cynnwys yn awtomatig.

Datrys Problemau

Mae’r Widget yn Dal i Ddangos Saesneg

• Adnewyddiad caled fel diagnosis - Ail-lwythwch gyda Ctrl+F5 neu Cmd+Shift+R, yna gwiriwch banel rhwydwaith y porwr am geisiadau widget a chyfieithiadau
• Gwiriwch data-locale - Gwiriwch fod y briodoledd wedi’i gosod yn gywir gyda chod iaith a gefnogir
• Gwiriwch iaith y porwr - Gwiriwch fod dewis iaith eich porwr wedi’i osod yn gywir
• Gwiriwch HTML lang y dudalen - Sicrhewch fod gan eich tudalen <html lang="de"> (neu’r cod priodol)

Mae Ffynonellau yn yr Iaith Anghywir

• Ail-sgrapiwch eich cynnwys - Sicrhewch fod pob fersiwn iaith wedi’i mynegeio
• Defnyddiwch sitemap.xml - Mae hyn yn sicrhau bod y scraper yn dod o hyd i bob URL /de/, /fr/, ac ati
• Gwiriwch iaith yr ymholiad - Mae’r AI yn ceisio paru iaith yr ateb ag iaith yr ymholiad

Cyfieithiadau ar Goll

• Gwiriwch ieithoedd a gefnogir - Dim ond y 14 iaith a restrir uchod sydd â chyfieithiadau UI gwarantedig

Arferion Gorau

1. Gosodwch <html lang> ar eich tudalennau - Mae hyn yn helpu hygyrchedd a chanfod iaith y widget
2. Profwch gyda data-locale wrth ddatblygu - Gwiriwch fod pob iaith yn rendro’n gywir
3. Sgrapiwch bob fersiwn iaith - Defnyddiwch sitemap.xml ar gyfer mynegeio amlieithog cynhwysfawr
4. Monitrwch ddosbarthiad ieithoedd - Gwiriwch ddadansoddeg i weld pa ieithoedd mae eich ymwelwyr yn eu defnyddio fwyaf