Neidio i'r prif gynnwys

Datrys problemau

Defnyddiwch y dudalen hon pan fydd y teclyn wedi'i osod ond nid yw'n ymddwyn yn ôl y disgwyl.

Nid yw Widget yn Ymddangos

Gwiriwch y consol porwr yn gyntaf. Mae ChattyBox yn adrodd ar goll priodoleddau gofynnol yno.

Achosion cyffredin:

  • Nid yw'r sgript yn bresennol yn ffynhonnell y dudalen a ddefnyddiwyd.
  • Ychwanegwyd y sgript at y templed anghywir, gosodiad, cynhwysydd rheolwr tag, neu ardal cod CMS.
  • Mae'r sgript y tu ôl i reol gydsynio neu sbardun rheolwr tag nad oedd yn tanio.
  • Mae'r un plisgyn app yn dileu'r sgript yn ystod llywio ochr y cleient.
  • Mae Polisi Diogelwch Cynnwys yn blocio https://chattybox.ai/widget.js.
  • Mae CSS neu declyn arall yn gorgyffwrdd â'r lansiwr.

Atgyweiriad lleiaf:

  1. Agorwch y dudalen gyhoeddus a ddefnyddir mewn ffenestr anhysbys.
  2. Chwiliwch am ffynhonnell y dudalen am chattybox.ai/widget.js.
  3. Cadarnhewch fod y sgript yn ymddangos unwaith ac yn cynnwys data-api-key a data-api-url.
  4. Symudwch y sgript i'r troedyn byd-eang, gosodiad yr ap, Docusaurus root, neu GTM Mae pob Tudalen yn sbarduno os yw ar goll.

Ar goll data-api-url

Mae'r teclyn yn gadael yn gynnar pan fydd data-api-url ar goll.

Defnyddiwch y pyt llawn o'r dangosfwrdd neu ychwanegwch y priodoledd gofynnol:

<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>

Os yw'ch dangosfwrdd yn dangos URL API gwahanol, defnyddiwch werth y dangosfwrdd yn lle'r gwerth enghreifftiol.

Annilys API Gwallau Allwedd neu Tarddiad

Achosion cyffredin:

  • Cafodd allwedd y teclyn cyhoeddus ei chopïo'n anghywir.
  • Cafodd yr allwedd ei dileu, ei dirwyn i ben, neu ei chreu ar gyfer prosiect gwahanol.
  • Gosodwyd allwedd llwyfannu i gynhyrchu neu anfonwyd allwedd gynhyrchu i lwyfannu.
  • Mae'r allwedd wedi caniatáu tarddiad ac nid yw tarddiad presennol y safle wedi'i gynnwys.
  • Mae'r dudalen wedi'i llwytho o http://localhost, URL rhagolwg, neu barth personol nad yw'n cael ei ganiatáu ar gyfer yr allwedd honno.

Atgyweiriadau:

  1. Agorwch y prosiect yn y dangosfwrdd ChattyBox.
  2. Copïwch snippet ffres o'r tab Embed.
  3. Os yw'r gwreiddiau a ganiateir wedi'u ffurfweddu, ychwanegwch yr union darddiad sy'n gwasanaethu'r dudalen, gan gynnwys protocol ac enw gwesteiwr.
  4. Ail-leoli neu ailgyhoeddi'r wefan a phrofi eto mewn ffenestr anhysbys.

Iaith Anghywir

Mae angen cynnwys ffynhonnell clir ar chatbot RAG wedi'i seilio ar ffynonellau dibynadwy ar gyfer pob ateb.

Mae'r teclyn yn dewis iaith yn y drefn hon:

  1. data-locale ar y sgript teclyn.
  2. Gwerth y dudalen <html lang>.
  3. Iaith porwr yr ymwelydd.
  4. Saesneg wrth gefn.

Atgyweiriadau:

  • Tynnwch werth data-locale anghywir os dylai'r dudalen ganfod iaith yn awtomatig.
  • Gosodwch <html lang="de">, <html lang="fr">, neu'r cod iaith cyfatebol ar dudalennau lleoledig.
  • Ychwanegu data-locale="de" dim ond pan fydd yn rhaid i dudalen orfodi iaith UI teclyn penodol.
  • Ail-sgrapio pob fersiwn iaith os yw atebion yn dyfynnu neu'n adalw cynnwys o'r iaith anghywir.

Dim Dyfyniadau nac Atebion Gwan

ChattyBox ateb o gynnwys wedi'i fynegeio. Mae dyfyniadau coll neu atebion gwan fel arfer yn golygu na chafodd y cynnwys ffynhonnell angenrheidiol ei adalw neu nid yw'n ateb y cwestiwn yn glir.

Atgyweiriadau:

  • Gofynnwch yr un cwestiwn yn y sgwrs prawf dangosfwrdd a chymharwch y tudalennau a ddyfynnwyd.
  • Sicrhewch fod y dudalen ffynhonnell yn gyhoeddus ac wedi'i chynnwys yn y cropian.
  • Ychwanegu penawdau clir, enghreifftiau, Cwestiynau Cyffredin, a thestun ateb uniongyrchol i'r dudalen ffynhonnell.
  • Ceisiwch osgoi dibynnu ar sgrinluniau, fideos, acordionau cudd, neu gynnwys iframe fel yr unig ffynhonnell.
  • Ail-crafu'r dudalen wedi'i diweddaru, yna profwch eto.

Tudalennau Heb eu Crafu neu Hen Gynnwys

Achosion cyffredin:

  • Mae'r dudalen ar goll o'r map gwefan a gyflwynwyd.
  • Nid oedd modd URL â llaw yn cynnwys y dudalen.
  • Mae'r dudalen yn ailgyfeirio, yn blocio ymlusgwyr, yn gofyn am ddilysu, neu'n cael ei heithrio gan reolau robotiaid.
  • Newidiodd cynnwys y dudalen ar ôl y sgrapio diwethaf.
  • Mae'r cynnwys wedi'i rendro mewn ffordd na all y crawler echdynnu testun defnyddiol.

Atgyweiriadau:

  1. Cadarnhewch fod y dudalen yn agor yn gyhoeddus mewn ffenestr porwr preifat.
  2. Defnyddiwch y modd map gwefan ar gyfer sylw eang neu URLau â llaw ar gyfer set wedi'i churadu.
  3. Cyflwyno'r URL canonaidd yn hytrach nag URL olrhain, ailgyfeirio URL, neu URL mewngofnodi.
  4. Ail-crafu ar ôl cyhoeddi newidiadau cynnwys.
  5. Gwiriwch y dangosfwrdd am dudalennau sydd wedi methu neu wedi'u hepgor.

Dal yn Sownd

Casglwch y manylion hyn cyn cysylltu â chymorth:

  • URL y dudalen gyhoeddus lle dylai'r teclyn ymddangos.
  • Ciplun neu gopi o unrhyw wall consol porwr.
  • A yw'r dudalen yn defnyddio HTML plaen, Next.js, Docusaurus, WordPress, a CMS, neu Google Tag Manager.
  • A yw'r pyt yn cynnwys data-api-key a data-api-url.
  • Un cwestiwn prawf a ddylai weithio a'r dudalen ffynhonnell sy'n ei ateb.

We use optional analytics and tag-management tools to understand site use. Choose whether to allow PostHog and Google Tag Manager. Turning analytics off reloads this page so the change takes effect cleanly. Essential site functionality and error monitoring are not controlled by this choice. Read our privacy policy.