Neidio i'r prif gynnwys
ChattyBox Logo

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 yr HTML a ddefnyddiwyd nac yn y DOM byw.
  • 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.
  • Nid yw cydran yr ap sy'n atodi'r loader yn rhedeg ar y llwybr hwnnw.
  • 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 ffynhonnell y dudalen a phanel Elements am chattybox.ai/widget.js; gall loader SDK neu JavaScript ymddangos yn y DOM byw yn unig.
  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.

401 Invalid API key cyffredinol​

Am ddiogelwch, mae endpointau API widget yn dychwelyd yr un 401 Invalid API key ar gyfer allwedd anhysbys, wedi dod i ben neu a wrthodwyd yn ôl tarddiad. Peidiwch â dibynnu ar yr ymateb i nodi'r achos.

Achosion cyffredin:

  • Cafodd allwedd y teclyn cyhoeddus ei chopïo'n anghywir.
  • Cafodd yr allwedd ei dileu, ei dirwyn i ben, mae ei phrosiect/perchennog yn cael ei dileu, neu cafodd ei chopïo o deployment backend gwahanol i'r URL API.
  • Mae cyfyngiad tarddiad dewisol wedi'i alluogi ac nid yw tarddiad y safle presennol wedi'i gynnwys.

Atgyweiriadau:

  1. Agorwch y prosiect yn y dangosfwrdd ChattyBox.
  2. Copïwch snippet ffres o'r tab Embed.
  3. Gwiriwch Public Keys > Edit origins dim ond os yw Restrict this key to specific origins wedi'i alluogi. Ychwanegwch yr union darddiad sy'n gwasanaethu'r dudalen, neu analluogwch y cyfyngiad; mae cynllun, enw gwesteiwr a phorth i gyd yn gorfod cyfateb.
  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 UI yn y drefn hon:

  1. data-locale, dim ond pan fo Allow Script Override wedi'i alluogi.
  2. Yn y modd Fixed, iaith ddiofyn y prosiect.
  3. Yn Auto-detect, <html lang>, yna iaith y porwr, yna'r diofyn.

Atgyweiriadau:

  • Ar gyfer canfod awtomatig, dewiswch Auto-detect a thynnwch data-locale anghywir neu analluogwch y diystyru.
  • 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.
  • Nid yw locale UI yn gorfodi iaith ateb; mynegeiwch a phrofwch bob fersiwn cynnwys.

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, iframes, marcio cudd neu gynnwys JavaScript yn unig fel yr unig ffynhonnell; gwiriwch rybuddion mynegeio rhannol a gwaith embeddings.

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 blocio nôl HTML cyffredin, yn gofyn am fewngofnodi/CAPTCHA, yn ailgyfeirio i darged wedi'i flocio, neu cafodd ei hidlo neu aeth dros gyllideb.
  • Newidiodd cynnwys y dudalen ar ôl y sgrapio diwethaf.
  • Mae'r cynnwys ar gael trwy JavaScript yn unig neu y tu allan i'r gwreiddyn cynnwys semantig a ddewiswyd.

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 y cooldown: 7 diwrnod ar Free neu 24 awr ar gynlluniau taledig, hyd yn oed ar ôl swydd a fethodd.
  5. Cymharwch y cyfrifon a gadwyd/dewiswyd â Content. Nid yw ChattyBox yn gwirio robots.txt; nid yw tynnu URL o'r ffynhonnell yn dileu tudalen wedi'i chadw.

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.

Dewisiadau preifatrwydd

Rydym yn defnyddio offer dadansoddeg a rheoli tagiau dewisol i ddeall sut mae'r wefan yn cael ei defnyddio. Dewiswch a ydych am ganiatáu Ahrefs Web Analytics, PostHog a Google Tag Manager. Mae diffodd dadansoddeg yn ail-lwytho'r dudalen hon fel bod y newid yn cael ei weithredu'n briodol. Nid yw swyddogaethau hanfodol y wefan na monitro gwallau yn cael eu rheoli gan y dewis hwn. Darllenwch ein polisi preifatrwydd.