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 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="https://app.chattybox.ai"
  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'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.