Vianetsintä
Käytä tätä sivua, kun widget on asennettu, mutta se ei toimi odotetulla tavalla.
Widget ei näy
Tarkista ensin selainkonsoli. ChattyBox raportoi, että sieltä puuttuvat pakolliset attribuutit.
Yleisiä syitä:
- Komentosarja ei ole käytössä sivun lähteessä.
- Skripti lisättiin väärään malliin, asetteluun, tunnisteenhallintasäilöön tai CMS-koodialueeseen.
- Skripti on suostumussäännön tai tagihallintatriggerin takana, joka ei käynnistynyt.
- Loaderin liittävä sovelluskomponentti ei suoritu tällä reitillä tai loader poistetaan asiakaspuolen navigoinnin aikana.
- Käyttöönotettu määritys sisältää
widget.enabled: false. - Sisällön suojauskäytäntö estää
https://chattybox.ai/widget.js. - CSS tai muu widget on päällekkäinen käynnistysohjelman kanssa.
Pienin korjaus:
- Avaa käyttöön otettu julkinen sivu incognito-ikkunassa.
- Hae sivun lähdettä kohteelle
chattybox.ai/widget.js. - Varmista, että komentosarja näkyy kerran ja sisältää
data-api-keyjadata-api-url. - Siirrä komentosarja yleiseen alatunnisteeseen, sovelluksen asetteluun, Docusaurus-juureen tai GTM Kaikki sivut -triggeriin, jos se puuttuu.
Puuttuu data-api-url
Widget poistuu aikaisin, kun data-api-url puuttuu.
Käytä koko katkelmaa hallintapaneelista tai lisää vaadittu määrite:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Jos hallintapaneelissasi näkyy eri API-URL-osoite, käytä hallintapaneelin arvoa esimerkkiarvon sijaan.
Yleinen 401 Invalid API key
Turvallisuussyistä widget-API palauttaa saman yleisen 401 Invalid API key -vastauksen tuntemattomasta, vanhentuneesta tai origin-rajoituksen hylkäämästä avaimesta. Älä päättele vastausviestistä tarkkaa syytä.
Yleisiä syitä:
- Julkinen widgetin avain kopioitiin väärin.
- Avain on poistettu, vanhentunut tai luotu toista projektia varten.
- Avaimen valinnainen origin-rajoitus on käytössä eikä nykyistä sivuston originia ole mukana.
Korjaukset:
- Avaa projekti ChattyBox -hallintapaneelissa.
- Kopioi uusi katkelma Upotus-välilehdeltä.
- Tarkista Public Keys > Edit origins vain, jos Restrict this key to specific origins on käytössä. Lisää sivua palveleva tarkka origin tai poista valinnainen rajoitus. Scheme, isäntänimi ja portti täsmäävät tarkasti; poluille ei tarvitse omia merkintöjä.
- Ota sivusto käyttöön tai julkaise se uudelleen ja testaa uudelleen incognito-ikkunassa.
Väärä kieli
Luotettava lähteisiin perustuva RAG-chatbot tarvitsee selkeän lähdesisällön jokaista vastausta varten.
Widget valitsee käyttöliittymän kielen tässä järjestyksessä:
data-localewidget-komentosarjassa, vain jos Allow Script Override on käytössä.- Fixed-tilassa määritetty oletuskieli.
- Auto-detect-tilassa sivun
<html lang>, sitten vierailijan selainkieli ja lopuksi määritetty oletuskieli.
Korjaukset:
- Poista virheellinen
data-locale-arvo tai poista scriptiohitus käytöstä, jos sivun pitäisi tunnistaa kieli automaattisesti. - Aseta
<html lang="de">,<html lang="fr">tai vastaava kielikoodi lokalisoiduille sivuille. - Lisää
data-locale="de"vain, kun scriptiohitus on sallittu ja sivulla on pyydettävä tiettyä widgetin käyttöliittymän kieltä. - Kaavi kaikki kieliversiot uudelleen, jos vastaukset viittaavat tai hakevat sisältöä väärällä kielellä.
Ei lainauksia tai heikkoja vastauksia
ChattyBox vastaa indeksoidusta sisällöstä. Puuttuvat lähdeviitteet tai heikot vastaukset tarkoittavat yleensä sitä, että tarvittavaa lähdesisältöä ei ole haettu tai se ei vastaa selkeästi kysymykseen. Varavastauksella voi olla tyhjät lähteet.
Korjaukset:
- Esitä sama kysymys kojelaudan testichatissa ja vertaa lainattuja sivuja.
- Varmista, että lähdesivu on julkinen ja sisällytetty indeksointiin.
- Lisää selkeät otsikot, esimerkit, usein kysytyt kysymykset ja suora vastausteksti lähdesivulle.
- Älä luota kuvakaappauksiin, videoihin, piilotettuihin haitareihin tai iframe-sisältöön ainoana lähteenä.
- Haravoi päivitetty sivu uudelleen jäähdytysajan sallimana, odota embedding-työtä ja testaa sitten uudelleen.
- Tee jokaisesta kysymyksestä omavarainen: tallennettu keskusteluhistoria ei tällä hetkellä välity mallin promptiin.
Sivut eivät kaavi tai sisältö vanhentunut
Yleisiä syitä:
- Sivu puuttuu lähetetystä sivustokartasta.
- Manuaalinen URL-tila ei sisältänyt sivua.
- Sivu estää tavallisen HTTP-haun, vaatii todennusta, palauttaa CAPTCHA-/virhesivun, uudelleenohjaa estettyyn kohteeseen tai se on jätetty lähdesuodatuksella pois.
- Sivun sisältö muuttui viimeisimmän kopion jälkeen.
- Sisältö hahmonnetaan siten, että indeksointirobotti ei voi poimia hyödyllistä tekstiä.
Korjaukset:
- Varmista, että sivu avautuu julkisesti yksityisessä selainikkunassa.
- Käytä sivustokarttatilaa laajaa kattavuutta varten, crawl-tilaa linkkilöytöön tai manuaalisia URL-osoitteita kuratoidulle joukolle.
- Lähetä ensisijainen URL-osoite seuranta-URL-osoitteen, uudelleenohjaus-URL-osoitteen tai sisäänkirjautumisen URL-osoitteen sijaan.
- Haravoi uudelleen sisällön muutosten julkaisemisen jälkeen: vähintään seitsemän päivää viimeisen työn luomisesta Free-paketissa tai 24 tuntia maksullisissa paketeissa, myös epäonnistuneen työn jälkeen.
- Vertaa työn tallennettuja/valittuja määriä ja Content-listaa tarkoitettuihin URL-osoitteisiin. Completed voi sisältää ohitettuja tai epäonnistuneita URL-osoitteita; Completed with warnings koskee erityisesti osittain säilytettyä tekstiä.
Edelleen jumissa
Kerää nämä tiedot ennen kuin otat yhteyttä tukeen:
- Julkisen sivun URL-osoite, jossa widgetin pitäisi näkyä.
- Kuvakaappaus tai kopio mistä tahansa selainkonsolin virheestä.
- Käytetäänkö sivulla tavallista HTML, Next.js, Docusaurus, WordPress, CMS tai Google Tag Manager.
- Sisältääkö katkelma
data-api-keyjadata-api-url. - Yksi testikysymys, jonka pitäisi toimia, ja lähdesivu, joka vastaa siihen.