Neidio i'r prif gynnwys
ChattyBox Logo

Gosod ac addasu’r widget

Ychwanegwch widget sgwrsio wedi’i bweru gan AI at eich gwefan mewn llai na 5 munud.

Gosod cyflym​

Mae rhoi eich chatbot ar-lein yn syml. Copïwch ddarn bach o god o’ch dangosfwrdd.

Cam 1: cael y cod mewnosod​

  1. Agorwch eich dangosfwrdd a dewiswch eich prosiect.
  2. Ewch i’r tab Mewnosod.
  3. Dewiswch yr allwedd API rydych am ei defnyddio neu crëwch un newydd.
  4. Copïwch y darn cod a gynhyrchwyd.

Cam 2: ei ychwanegu at eich gwefan​

Gludwch y darn cod yn union cyn y tag cau </body> ar bob tudalen lle dylai’r widget sgwrsio ymddangos.

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

:::tip Awgrym Dyna’r cyfan. Nid oes angen gosod lliwiau na dewisiadau yn y cod; caiff popeth ei reoli yn y dangosfwrdd. :::

Addasu gweledol​

Mae gan ChattyBox olygydd gweledol adeiledig. Gallwch addasu golwg y widget i gyd-fynd â’ch brand heb newid cod.

Rheolyddion y dangosfwrdd​

  1. Lliw acen - Dewiswch brif liw’r brand ar gyfer y botwm lansio, amlygiadau a negeseuon defnyddwyr.
  2. Safle - Dewiswch ble mae’r widget yn ymddangos ar y sgrin.
  3. Teitl pennyn - Gosodwch y teitl ar frig y ffenestr sgwrsio.
  4. Neges groeso - Addaswch y neges gyntaf y bydd ymwelwyr yn ei gweld.
nodyn

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

Dewisiadau uwch​

Gosodiadau’r dangosfwrdd ac atributau’r sgript​

Dylid rheoli’r rhan fwyaf o ymddygiad y widget o’r dangosfwrdd fel nad oes angen ailgyhoeddi’r wefan ar gyfer newidiadau syml.

Defnyddiwch y dangosfwrdd ar gyfer lliwiau, safle, eicon, teitl, neges groeso, iaith ddiofyn, allweddi cyhoeddus, scraping ac analytics.

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

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

  • data-api-key sy’n adnabod allwedd gyhoeddus y widget.
  • data-api-url sy’n dweud wrth y widget ble i anfon ceisiadau.
  • data-locale sy’n gallu gorfodi iaith y rhyngwyneb ar gyfer y dudalen honno.

Os nad yw’r widget yn ymddangos ar ôl gosod, gweler datrys problemau.

Cuddio’r widget ar dudalennau penodol​

Gallwch guddio’r widget ar dudalennau dethol gyda CSS:

.chattybox-widget {
  display: none;
}

Integreiddiadau personol​

Oes angen gosodiad mwy penodol na’r widget safonol arnoch?

Cysylltwch â ni yn [email protected] a byddwn yn helpu i ddewis yr integreiddiad cywir ar gyfer eich achos defnydd.

Cymorth amlieithog​

Mae widget ChattyBox yn addasu’n awtomatig i ddewisiadau iaith ymwelwyr ac yn darparu profiad wedi’i leoleiddio.

Ieithoedd a gefnogir yn swyddogol​

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

IaithCodRhyngwyneb widgetAnsawdd atebion AI
SaesnegenCymorth llawnRhagorol
FfrangegfrCymorth llawnUchel
AlmaenegdeCymorth llawnUchel
SbaenegesCymorth llawnUchel
EidalegitCymorth llawnUchel
IseldiregnlCymorth llawnUchel
PortiwgalegptCymorth llawnUchel
PwylegplCymorth llawnUchel
SwedegsvCymorth llawnUchel
IndonesegidCymorth llawnCanolig
EstonegetCymorth llawnCanolig
FfinnegfiCymorth llawnCanolig
CymraegcyCymorth llawnCanolig
TsiecegcsCymorth llawnCanolig

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

Sut mae canfod iaith yn gweithio​

Mae’r widget yn defnyddio system ganfod raddol:

  1. Atribut data-locale - Blaenoriaeth uchaf. Gosodwch hwn yn y cod i orfodi iaith benodol.
  2. Atribut <html lang> y dudalen - Mae’r widget yn gwirio iaith ddatganedig y dudalen.
  3. Iaith y porwr (navigator.language) - Defnyddia ddewisiadau’r ymwelydd.
  4. Rhagosodiad wrth gefn - Saesneg os na chaiff iaith ei chanfod.

Gorfodi iaith â llaw​

I osod iaith y widget waeth beth yw gosodiadau’r porwr, ychwanegwch data-locale:

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

:::tip Achos defnydd Mae hyn yn ddefnyddiol os oes gan wefan amlieithog URL ar wahân i bob iaith, fel /de/ neu /fr/. Gosodwch data-locale yn ôl iaith y dudalen i gadw’r profiad yn gyson. :::

Gosodiadau iaith yn y dangosfwrdd​

Mae dangosfwrdd yr ap yn caniatáu i chi ffurfweddu dewisiadau iaith y widget fesul prosiect:

  • Canfod yn awtomatig (argymhellir) - Yn cyd-fynd yn awtomatig ag iaith porwr yr ymwelydd.
  • Iaith sefydlog - Yn gorfodi’r widget i ddefnyddio iaith benodol bob amser.
  • Caniatáu trosysgrifo sgript - Yn galluogi neu’n analluogi trosysgrifo drwy data-locale.

Mae’r gosodiadau hyn yn y dangosfwrdd → Prosiect → Mewnosod → Iaith y widget.

Cyfateb iaith y cynnwys​

I gael y profiad amlieithog gorau, dylai’r chatbot ateb yn yr un iaith â chwestiwn y defnyddiwr. I wneud hynny:

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

Gosod yn y dangosfwrdd: wrth ffurfweddu scraping, defnyddiwch URL sitemap.xml, er enghraifft https://yourdocs.com/sitemap.xml, er mwyn canfod a mynegeio pob fersiwn iaith yn awtomatig.

Datrys problemau​

Mae’r widget yn dal i ddangos Saesneg​

  • Cliriwch storfa’r porwr - Gall widget.js fod wedi’i storio. Gwnewch adnewyddiad caled (Ctrl+F5 / Cmd+Shift+R).
  • Gwiriwch data-locale - Sicrhewch fod yr atribut yn defnyddio cod iaith a gefnogir.
  • Gwiriwch iaith y porwr - Cadarnhewch fod y dewis iaith yn gywir.
  • Gwiriwch HTML lang - Dylai’r dudalen ddefnyddio <html lang="cy"> neu’r cod priodol.

Mae ffynonellau yn yr iaith anghywir​

  • Scrapiwch y cynnwys eto - Sicrhewch fod pob fersiwn iaith wedi’i mynegeio.
  • Defnyddiwch sitemap.xml - Mae hyn yn helpu’r scraper i ddod o hyd i URLau fel /de/ a /fr/.
  • Gwiriwch iaith y cwestiwn - Mae’r AI yn ceisio cyfateb iaith yr ateb i iaith y cwestiwn.

Cyfieithiadau ar goll​

  • Gwiriwch yr ieithoedd a gefnogir - Dim ond y 14 iaith 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 ymddangos yn gywir.
  3. Scrapiwch bob fersiwn iaith - Defnyddiwch sitemap.xml ar gyfer mynegeio amlieithog cyflawn.
  4. Monitrwch ddosbarthiad ieithoedd - Defnyddiwch analytics i weld pa ieithoedd mae ymwelwyr yn eu defnyddio fwyaf.