Siirry pääsisältöön

Vianetsintä

Käytä tätä sivua, kun widget on asennettu, mutta se ei toimi odotetulla tavalla.

Widget ei näy​

Tarkista ensin selainkonsoli. ChattyBox ilmoittaa siellä puuttuvista pakollisista attribuuteista.

Yleisiä syitä:

  • Skripti puuttuu sekä julkaistusta HTML:stä että aktiivisesta DOM:sta.
  • 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ä.
  • 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:

  1. Avaa käyttöön otettu julkinen sivu incognito-ikkunassa.
  2. Etsi chattybox.ai/widget.js sivun lähdekoodista ja selaimen Elements-paneelista; SDK:n tai JavaScriptin lisäämä loader voi näkyä vain aktiivisessa DOM:ssa.
  3. Varmista, että komentosarja näkyy kerran ja sisältää data-api-key ja data-api-url.
  4. Siirrä komentosarja yleiseen alatunnisteeseen, sovelluksen asetteluun, Docusaurus-juureen tai GTM Kaikki sivut -triggeriin, jos se puuttuu.

Konfiguraation kautta hallituissa projekteissa widget.enabled: false estää hostatun widgetin alustuksen ja saa julkiset POST /chat -pyynnöt palauttamaan 403 Widget is disabled, myös headless-SDK:n pyynnöissä. Muuta asetus konfiguraation käyttöönoton työnkulussa, älä kierrätä julkista avainta. Loader-skriptin poistaminen alustuksen jälkeen ei poista jo renderöityä widgetiä.

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>

Käytä hallintapaneelissa näkyvää API-URL-osoitetta arvauksen sijaan. Tuotannossa sen odotetaan olevan vakaa https://...convex.site/chat-osoite.

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 tai vanhentunut, tai se on kopioitu eri backend-käyttöönotosta kuin mihin API-URL osoittaa.
  • Avaimen projekti tai omistaja on poistumassa.
  • Avaimen valinnainen origin-rajoitus on käytössä eikä nykyistä sivuston originia ole mukana.

Korjaukset:

  1. Avaa projekti ChattyBox -hallintapaneelissa.
  2. Avaa Asenna → Verkkosivuston asennus, anna verkkosivuston URL-osoite ja kopioi soveltuva katkelma, jos sellainen on saatavilla.
  3. Valitse saman sivun kohdassa Avaimet ja verkkotunnukset asennetussa katkelmassa käytetylle avaimelle Muokkaa origin-osoitteita. Jos Rajoita tämä avain tiettyihin origin-osoitteisiin on käytössä, lisää sivua palveleva tarkka origin tai poista valinnainen rajoitus. URL-skeeman, isäntänimen ja portin on täsmättävä: https://example.com, https://preview.example.com ja http://localhost:3000 ovat eri origineja. Poluille ei tarvita omia merkintöjä.
  4. Ota sivusto käyttöön tai julkaise se uudelleen ja testaa uudelleen incognito-ikkunassa.

Toisen chatbotin kelvollinen avain samassa backendissä valitsee tavallisesti kyseisen chatbotin eikä aiheuta 401-virhettä; tarkista projekti, jos vastaukset ovat asiaankuulumattomia. Avainten nimet kuten "production" ja "staging" eivät pakota ympäristöjä. HTTP-rajapinta käyttää Origin-otsaketta, jos se on mukana; vain sen puuttuessa käytetään Referer-otsakkeen originia. Rajoitettu avain hylkää pyynnön, jos näin valittu origin puuttuu, on virheellinen tai ei ole sallittu. Sallittu Referer-origin ei ohita kiellettyä Origin-originia. Origin-rajoitus ei korvaa kävijän tunnistautumista.

Viesti- ja pyyntörajoitukset​

Tarkista Tili ja laskutus osoitteessa /settings/account viestien käytön, paketin ja mahdollisten Pro/Business PAYG -budjettien osalta. Testikeskustelu ja julkinen chat käyttävät omistajan yhteistä viestikiintiötä. Keskustelujen poistaminen tai uuden avaimen luominen ei nollaa kiintiötä.

Kuukausittaisen viestikiintiön virheet ja lyhytaikaiset pyyntörajoitukset ovat eri asioita. Noudata HTTP 429 -vastauksen Retry-After-arvoa, jos se annetaan, äläkä yritä pyyntöä toistuvasti heti uudelleen. Kuukausittaisen viestirajan virheen jälkeen odota kiintiön nollautumista tai muuta pakettia/sallittua PAYG-budjettia. Keskustelut → Historia näyttää keskusteluhistorian, ei pyyntökohtaista virhekonsolia; tarkista HTTP-virheet selaimen Network-paneelista.

Väärä kieli​

Tarkista ensin widgetin kieliasetukset kohdasta Mukauta → Ulkonäkö. Lähdekoodin mukainen hostattu widget valitsee käyttöliittymän kielen tässä järjestyksessä:

  1. Widgetin komentosarjan data-locale, vain jos Salli skriptin ohittaa asetus on käytössä ja arvo on tuettu.
  2. Kiinteä-tilassa määritetty oletuskieli.
  3. Tunnista automaattisesti -tilassa sivun <html lang>, sitten selaimen kieliehdokkaat ja lopuksi määritetty oletuskieli.

Ei-tuetut ehdokkaat ohitetaan. Jos mikään ehdokas ei ole tuettu, viimeinen varakieli on englanti; määritetty oletuskieli on aluksi englanti.

Korjaukset:

  • Automaattista kielivalintaa varten valitse Tunnista automaattisesti ja poista virheellinen data-locale-arvo tai poista komentosarjan ohitukset käytöstä.
  • Aseta <html lang="de">, <html lang="fr"> tai vastaava kielikoodi lokalisoiduille sivuille.
  • Jos haluat pakottaa määritetyn kielen, valitse Kiinteä ja poista Salli skriptin ohittaa asetus käytöstä. Kun ohitukset ovat käytössä, data-locale menee yhä Kiinteä-tilan edelle.
  • Varmista, että asetukset on tallennettu, ja alusta asennettu widget uudelleen, jotta se käyttää dashboardin asetuksia. Lähdekoodin mukainen hostattu widget.js v16 voi päivittää tuotteen omat käyttöliittymätekstit, kun <html lang>- tai loaderin data-locale-muutos vaihtaa ratkaistun kielen. Tarkista käytössä olevan loaderin versio ennen kuin luotat reaaliaikaisiin päivityksiin; hostatun loaderin toiminta on erillinen julkaistusta npm-SDK-versiosta 0.1.4. mountWidget()-kutsulle annettu locale muuttuu data-locale-arvoksi ja noudattaa samoja projektin sääntöjä.
  • Jos widget ei ole käytettävissä, tarkista /widget-config-pyyntö ja julkinen avain. Lähdekoodin mukaisessa hostatussa widget.js v16:ssa epäonnistunut määrityksen haku jättää widgetin pois käytöstä sen sijaan, että se käynnistyisi oletusasetuksilla. Tarkista käytössä olevan loaderin versio ennen kuin luotat tähän toimintaan.
  • Widgetin käyttöliittymän kieli ei pakota vastauskieltä eikä käännä lähdesisältöä. Vastausgeneraattori tunnistaa kielen kysymyksestä. Indeksoi jokainen tarvittava kieliversio, jos vastaukset hakevat vääränkielistä sisältöä. Jos mukautettua assistant.fallbackMessage-viestiä ei ole määritetty config-as-code-asetuksissa, pakotettu puuttuvan sisällön varavastaus käyttää kysymyksestä tunnistettua kieltä, kun se on sopivaa; jos kielentunnistus on epävarma, se käyttää widgetin käyttöliittymän kieltä. Englanti on vasta viimeinen varakieli.

Ei lainauksia tai heikkoja vastauksia​

ChattyBox käyttää haettua lähdesisältöä vastausten generointiin. Puuttuvat lähdeviitteet tai heikot vastaukset voivat johtua puuttuvasta tai sopimattomasta lähdesisällöstä, hakuongelmista tai generointivirheistä; ne eivät yksin kerro syytä. Varavastauksella voi olla tyhjät lähteet.

Lähteisiin perustuva RAG-chatbot hyötyy selkeästä haetusta lähdesisällöstä, mutta lähdeviite ei yksin todista vastauksen oikeellisuutta. Vertaa jokaista tärkeää väitettä sen lähdesivuun.

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, poissuljettuun piilotettuun merkkauskieleen, vain JavaScriptillä tuotettuun sisältöön tai iframe-sisältöön ainoana lähteenä.
  • Haravoi päivitetty sivu uudelleen jäähdytysajan sallimana, odota embedding-työtä ja testaa sitten uudelleen.
  • Tarkista Osittain indeksoitu -varoitukset: sivukohtaisen 512 KiB:n rajan ylittävää tekstiä ei säilytetä. Jaa pitkät lähdesivut pienemmiksi sen sijaan, että rakentaisit saman katkaistun tekstin indeksiä toistuvasti uudelleen.
  • Tee jokaisesta kysymyksestä mahdollisuuksien mukaan selkeä ja itsenäinen. Vastausgeneraattori voi saada enintään 12 viimeksi tallennettua viestiä, joista kukin on enintään 2 000 merkkiä; se ei saa koko keskustelun litterointia.

Persoona lisää sivustokohtaiset ohjeet sisäänrakennettujen lähdesääntöjen rinnalle; se ei voi korvata puuttuvaa indeksoitua sisältöä tai puuttuvan kontekstin tai sisältöaukon varavastausta, kun se aktivoituu. Sisältöaukkojen tunnistin on heuristinen eikä välttämättä havaitse jokaista vastausta, jota lähteet eivät tue. Varavastauksella on erillinen assistant.fallbackMessage-asetus konfiguraatiossa koodina.

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ö renderöidään vain JavaScriptillä tai se sijaitsee valitun semanttisen sisältöelementin ulkopuolella.
  • Valitut URL-osoitteet ylittivät sivukiintiön, kuukausittainen päivitysbudjetti loppui tai include/exclude-sääntö suodatti ne pois.

Korjaukset:

  1. Varmista, että sivu avautuu julkisesti yksityisessä selainikkunassa.
  2. Käytä sivustokarttatilaa laajaa kattavuutta varten tai manuaalisia URL-osoitteita kuratoidulle joukolle.
  3. Lähetä ensisijainen URL-osoite seuranta-URL-osoitteen, uudelleenohjaus-URL-osoitteen tai sisäänkirjautumisen URL-osoitteen sijaan.
  4. 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.
  5. Avaa Tietopohja → Sivut, laajenna Tuontihistoria, kun töitä on olemassa, ja valitse työ kohdasta Keräystyöt. Vertaa sen tallennettujen/valittujen sivujen määriä ja Sivut-listaa aiottuihin URL-osoitteisiin. Valmis voi sisältää ohitettuja tai epäonnistuneita URL-osoitteita; Valmis varoituksin tarkoittaa nimenomaan osittain säilynyttä sivutekstiä, ei kaikkia crawl-virheitä. Käyttöliittymä ei näytä täydellistä URL-kohtaista virheluetteloa.

ChattyBox ei noudata robots.txt-tiedoston crawl-direktiivejä, mutta voi lukea tiedoston sitemap-määritysten löytämiseksi. Älä käsittele robots.txt-tiedostoa käyttöoikeuksien hallintana. Turvallisia HTTP-uudelleenohjauksia seurataan, joten uudelleenohjaus ei yksinään tarkoita virhettä. Älä poista käyttörajoituksia tai julkaise yksityistä sisältöä crawlattavaksi. Crawler ei suorita JavaScriptiä. Jos URL poistetaan sivustolta tai lähdevalinnasta, tallennettua sivua voidaan silti käyttää; poista se myös kohdassa Tietopohja → Sivut ja rajaa se pois tulevista hauista. Rakenna indeksi uudelleen käyttää tallennettua tekstiä eikä hae sivustoa uudelleen. Toiminnolla on paketin mukainen oma cooldown, ja se kuluttaa yhteistä kuukausittaista sivujen päivitysbudjettia.

Asetukset eivät tallennu​

Chatbotin tietojen ja lähdeasetusten muutokset tallentuvat automaattisesti. Tarkista tallennustila ja korjaa validointivirheet tai yritä tallennusta uudelleen epäonnistumisen jälkeen. Dashboard edellyttää tallennettua Website URL -osoitetta myös silloin, kun käytät Manual URLs -tilaa. Löytäminen ja automaattinen tallennus eivät käynnistä tuontia: tarkista valitut sivut ja käynnistä tuonti erikseen.

Jos projekti on Config locked, asetukset on otettava käyttöön CLI-työnkulussa. Lukitusta ei voi perua; Persona-tallennus, scraping-asetukset, Scrape Now, sisällön poistaminen ja indeksin uudelleenrakentaminen hylätään, vaikka ohjaus näkyisi edelleen. Vain brändäysasetus on yhä muokattavissa dashboardissa hostatun widgetin määrityksissä, paketista riippuen. Julkiset widget-avaimet ja deployment-tokenit ovat erillisiä tunnistetietoja.

Jos projekti puuttuu tai käyttö estetään, varmista, että olet kirjautunut omistajana. Widget-avain, deployment-token tai organisaation jäsenyys ei anna hallintapaneelin omistajan käyttöoikeuksia. Keskustelut-osion Analytiikka- ja Vastaamattomia kysymyksiä -näkymät sisältyvät Pro- ja Business-paketteihin; näkymät, jotka eivät ole käytettävissä, näyttävät kehotuksen päivittää pakettia. Historia on käytettävissä kaikissa paketeissa.

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-key ja data-api-url.
  • Yksi testikysymys, jonka pitäisi toimia, ja lähdesivu, joka vastaa siihen.