Siirry pääsisältöön

Näin pääset alkuun

Dokumentoidut pakettiin sisältyvien sivujen kiintiöt jaetaan omistajan projektien kesken. Katso pakettien kiintiöt hinnoittelusta sekä tilisi nykyinen käyttö ja käytettävissä oleva kiintiö hallintapaneelin Tili ja laskutus -kohdasta.

Rakenna hyödyllinen chatbot ennen sen lisäämistä sivustollesi. Perusjärjestys on luo → lisää sisältöä → tarkista → testaa → mukauta → integroi.

1. Luo tili ja projekti​

Kirjaudu ChattyBox-hallintapaneeliin, valitse Uusi chatbot ja anna projektille nimi sekä halutessasi Verkkosivuston URL. Projektin luomisen jälkeen avautuu Tietopohja → Tuo ja päivitä. Jos avaat projektin valitsematta välilehteä, oletusnäkymä on Yleiskatsaus. Projektin luonti ei käynnistä tuontia.

Katso ajantasaiset projekti-, sivu- ja käyttörajat hinnoittelusta.

2. Määritä sisältölähde​

Siirry kohtaan Tietopohja → Tuo ja päivitä, yhdistä julkinen verkkosivusto, tarkista löydetyt sivut, säädä suositeltua tai mukautettua valintaa ja käynnistä valittujen sivujen tuonti tai päivitys. Lähdeasetusten muutokset tallentuvat automaattisesti: tarkista tallennuksen tila ja korjaa vahvistusvirheet tai yritä epäonnistunutta tallennusta uudelleen ennen jatkamista. Lähteen lisäasetuksissa on myös erillinen Kerää nyt -toiminto, joka käyttää määritettyä etsintätilaa. Sisällytys-/poissulkusäännöt ja crawl-syvyys ovat käytettävissä asetuksissa koodina, eivät hallintapaneelin säätiminä.

ChattyBox poimii luettavan HTML-sisällön ja jonottaa muuttuneen sisällön indeksoitavaksi. Löytäminen ja automaattinen tallennus eivät itsessään käynnistä tuontia. Palvelu ei renderöi JavaScriptiä eikä noudata robots.txt-tiedostoa; käytä sivuja, joiden indeksointiin sinulla on oikeus, ja valitse käyttöönoton laajuus harkiten. Kesto riippuu löydöistä, sivumäärästä ja indeksointityöstä.

Katso Sisällön lisääminen ja päivittäminen, kun tarvitset ohjeita sivukarttaan, manuaaliseen URL-osoitteeseen, indeksointiin, monikielisyyteen tai uudelleenharavointiin.

3. Tarkista indeksoitu sisältö​

Avaa Tietopohja → Sivut ja vertaa tallennettuja sivuja odotettuihin lähteisiin. Avaa haravointityö tarkistaaksesi määrät ja osittaisen sisällön varoitukset sekä tarkista erillinen embedding-työ ennen vastausten arviointia. Valmistunut haravointi ei takaa, että jokainen pyydetty sivu tai osio indeksoitiin. Katso edistyminen ja osittainen indeksointi.

4. Testaa vastausten laatua​

Avaa Testaa chatbottia ja kysy edustavia kysymyksiä, joita oikeat kävijät tulevat käyttämään. Tarkista, että vastaukset:

  • käyttävät indeksoitua dokumentaatiota tukemattomien oletusten sijaan;
  • linkittävät hyödyllisille lähdesivuille;
  • käsittelevät puuttuvat tiedot tarkoitetulla varakäyttäytymisellä;
  • toimivat tärkeillä kielillä ja terminologialla.

Paranna lähdesisältöä tai lähdevalintaa ja päivitä tietoja, kun paketin jäähdytysaika sallii sen: Free-paketissa enintään kerran viikossa ja maksullisissa paketeissa enintään kerran päivässä. Testaa chatbottia-toiminto käyttää omistajan viestikiintiötä ja tallentaa keskustelut. Testivuorovaikutukset voivat näkyä kohdassa Keskustelut → Analytiikka ja, jos ne tunnistetaan vastaamattomiksi, kohdassa Keskustelut → Vastaamattomia kysymyksiä; laskutus ja aukkojen kirjaaminen riippuvat tuloksesta. Älä asenna chatbottia vain siksi, että ensimmäinen haravointi valmistui.

5. Viimeistele käyttökokemus​

Valitse kohdassa Mukauta → Käyttäytyminen Avulias assistentti, Myyntiedustaja, Tekninen tuki, Sarkastinen botti tai Mukautettu persona ja muokkaa ohjeita. Muutokset tallentuvat automaattisesti; tarkista tallennuksen tila ennen jatkamista. Esiasetuksen muokkaaminen vaihtaa valinnan Mukautettu persona -vaihtoehdoksi. Ohjeet täydentävät ChattyBoxin sisäänrakennettuja lähteisiin perustuvia ja muotoilusääntöjä; haettu sisältö lisätään automaattisesti, joten älä liitä tietopohjaa kehotteeseen.

Persona-teksti ei korvaa pakotettua varavastausta, jota käytetään kontekstin puuttuessa tai sisältöaukon havaitsemisen yhteydessä. Erillinen assistant.fallbackMessage-asetus on käytettävissä asetuksissa koodina, ei Persona-lomakkeessa. Testaa tuetut kysymykset ja varakäyttäytyminen tallennuksen jälkeen.

Jos aiot käyttää hostattua widgetiä, esikatsele sen otsikkoa, tervetuloviestiä, värejä, kuvaketta, sijaintia ja kielikäyttäytymistä kohdassa Mukauta → Ulkonäkö. Muutokset tallentuvat automaattisesti; tarkista tallennuksen tila. Kiinteä-tila ja skriptin ohitukset vaikuttavat widgetin käyttöliittymän kieleen, eivät indeksoitavien sivujen kieleen; katso kieliongelmien vianmääritys. Free sisältää tyylien mukautuksen, mutta ChattyBox-brändäystä ei voi poistaa; Starter ja sitä korkeammat paketit voivat piilottaa sen.

Tee nämä valinnat vasta sisällön testaamisen jälkeen, jotta visuaaliset asetukset eivät peitä haku- tai dokumentaatio-ongelmia.

6. Valitse integraatio​

TavoiteSeuraava vaihe
Liittää ChattyBoxin ylläpidetyn käyttöliittymän sovelluskoodistaJavaScript SDK
Rakentaa ja ylläpitää oma käyttöliittymäHeadless JavaScript SDK
Antaa AI-koodausavustajan integroida npm-pakettiAI-avusteinen integraatio
Hallita projektin asetuksia Gitistä ja CI:stäAsetusten käyttöönotto CLI:llä
Käyttää ylläpidettyä käyttöliittymää ilman npm:ää tai build-vaihettaHostatun widgetin skripti
Lisätä ylläpidetty widget WordPressiin muuttamatta teemaaWordPress-lisäosa
Lisätä ylläpidetty widget Drupal 10- tai 11-sivustolle ComposerillaDrupal-moduuli

Selainintegraatiot tarvitsevat julkisen widget-API-avaimen. Tarkista avaimen origin-asetukset: verkkosivustolle valmisteltu avain voi olla jo rajattu kyseiseen originiin, kun taas ilman rajoituksia luodut avaimet toimivat eri origineissa. Hallitse valinnaisia rajoituksia kohdassa Asenna → Avaimet ja verkkotunnukset valitsemalla Muokkaa origin-osoitteita; lisää tarvitsemasi tuotanto-, esikatselu-, staging- ja localhost-origin-osoitteet. Rajoitetut origin-osoitteet täsmäävät täsmälleen skeeman, isäntänimen ja portin perusteella (esimerkiksi https://example.com ja http://localhost:3000 ovat eri origineja). Valitse avain kohdassa Verkkosivuston asennus ja kopioi luotu koodinpätkä sekä API-URL-osoite.

Julkiset widget-avaimet on tarkoitettu näkymään selainkoodissa. Asetusten käyttöönoton tunnukset ja muut hallintatunnukset ovat yksityisiä, eikä niitä saa koskaan lisätä verkkosivustolle. Origin-rajoitukset ovat valinnaista lisäsuojausta, eivät kävijöiden todennusta.

Voit hakea olemassa olevan julkisen avaimen syöttämällä HTTP(S)-verkkosivusto-URL:n kohdassa Verkkosivuston asennus ja valitsemalla avaimen koodinpätkässä. Valitsin näyttää vanhentumattomat avaimet, joilla ei ole rajoituksia tai jotka ovat sallittuja URL:n originille. Valitse rajoitettu avain syöttämällä sallittu origin; tarkista rajoitukset kohdasta Hallinnoi avaimia ja sallittuja verkkotunnuksia. Jos asennuslomake ei ole käytettävissä, suorita ensin hallintapaneelissa näytetty asennusvaihe. Jos haluat vaihtaa avaimen, luo uusi avain, päivitä ja testaa asennuksesi ja poista sitten vanha avain. Poistaminen pysäyttää heti asennukset, joissa vanha avain on yhä käytössä. Avain kuuluu yhdelle chatbotille; nimeäminen "staging"- tai "production"-avaimeksi ei luo ympäristörajaa.

7. Vahvista ennen julkaisua​

Asenna valittu integraatio ensin esikatselu- tai staging-sivustolle. Testaa ennen laajaa julkaisua käyttöönotetun sivuston origin, reittien välinen navigointi, lähdeviitteet, varakäyttäytyminen, mobiiliasettelu ja selaimen konsoli.

Suorita julkaisun tarkistuslista ja käytä sitten Keskustelut → Historia -näkymää kaikilla paketeilla tai Keskustelut → Analytiikka ja Vastaamattomia kysymyksiä Pro- ja Business-paketeissa dokumentaation parantamiseen oikeiden kysymysten perusteella.

Hallintapaneelin näkymäkartta​

Avaa projekti osoitteessa /chatbot/<projectId>. Välilehdet määräytyvät tab-kyselyparametrin mukaan, eivät erillisten alasivujen mukaan:

Työtilan näkymätab-arvoMitä voit tehdä
YleiskatsausoverviewTarkista käyttöönoton eteneminen ja viimeaikainen toiminta
Tietopohja → Tuo ja päivitäsettingsEtsi, valitse, tuo ja päivitä sivuja; säädä lähdeasetuksia
Tietopohja → SivutcontentTarkastele sivuja ja haravointitöitä, poista sisältöä ja rakenna embeddingit uudelleen
Testaa chatbottiatestEsitä kysymyksiä ja palaa tallennettuihin keskusteluihin
Keskustelut → HistorialogsLue tallennettuja keskusteluja ja poista yksittäisiä keskusteluja tai kaikki keskustelut
Keskustelut → AnalytiikkaanalyticsTarkastele viimeisen 30 päivän vuorovaikutuksia, enintään 5 000 tallennetta; Pro/Business
Keskustelut → Vastaamattomia kysymyksiägapsTarkastele ja ratkaise havaittuja vastaamattomia kysymyksiä; Pro/Business
Mukauta → KäyttäytyminenpromptsValitse tai muokkaa avustajan ohjeita
Mukauta → UlkonäköappearanceEsikatsele ja säädä hostatun widgetin ulkoasua ja kieltä
Asenna → Avaimet ja verkkotunnuksetkeysLuo/poista julkisia widget-avaimia ja muokkaa valinnaisia origin-rajoituksia
Asenna → Verkkosivuston asennusembedValmistele asennus ja kopioi avaimen koodinpätkä
Chatbotin asetuksetmanageHallitse chatbotin tietoja, käyttöönoton tunnuksia ja config lockia tai poista chatbot

Kaikki chatbotit palaa osoitteeseen /dashboard. Tilin yleiskatsaus on osoitteessa /dashboard/overview; Tili ja laskutus osoitteessa /settings/account sisältää profiilin, paketin, viestien käytön, laskutusportaalin ja PAYG-asetukset. /settings ja /settings/billing ohjautuvat sinne. /settings/keys sisältää projektivalitsimen julkisten avainten luontiin ja poistoon; valinnaisia origin-rajoituksia muokataan chatbotin Avaimet ja verkkotunnukset -näkymässä.

Käyttöoikeudet ja config lock​

Hallintapaneelin projektikäyttö on vain omistajalla (tai vanhan työtilan omistavalla käyttäjällä). Julkinen widget-avain ei anna pääsyä projektiasetuksiin tai tallennettuun keskusteluhistoriaan; organisaation jäsenyys ei yksin anna näitä projektioikeuksia.

Git/CI-hallintaa varten Chatbotin asetukset sisältää config deployment -tunnukset, joilla voi olla kehitys-, esikatselu- ja/tai tuotantoympäristön käyttöoikeudet, valinnainen vanhenemisaika ja peruutusmahdollisuus. Toisin kuin julkiset widget-avaimet, deployment-tunnuksen koko arvo näytetään vain luontihetkellä. Osiossa näkyy myös käyttöönottohistoria.

Toiminto Ota konfiguraation lukitus käyttöön on peruuttamaton. Se estää asetusten tallentamisen hallintapaneelissa ja manuaaliset sisältötoiminnot, kuten Personan tallentamisen ja Kerää nyt -toiminnon, vaikka ohjaimet näkyisivät edelleen. Ota asetukset käyttöön sen sijaan CLI-työnkulun kautta. Julkisten avainten hallinta, keskustelujen tyhjentäminen ja paketin sallima brändäysasetus eivät kuulu lukittuihin määrityskenttiin. Tokenin ympäristölaajuudet määrittävät, mihin ympäristöihin käyttöönotto on sallittu; ne eivät luo erillisiä chatbotteja tai selainavainten ympäristöjä.

Config-as-code sisältää myös widget.enabled-asetuksen. Arvo false poistaa julkisen chatin käytöstä, myös headless-SDK:ssa, ei vain kelluvaa widgetiä. Nykyisessä ulkoasulomakkeessa ei ole vastaavaa widgetin käyttöönotto-/käytöstäpoistokytkintä.

Paketit ja budjetit​

PakettiChatbotitSisältyvät sivutViestejä kuukaudessa
Free110100
Starter31501 000
Pro105 00010 000
Business2525 00050 000

Viestit ja pakettiin sisältyvät tallennetut sivut ovat omistajakohtaisia kiintiöitä, jotka jaetaan omistajan chatbottien kesken, myös Testaa chatbottia -käytön kanssa. Sivujen kuukausittainen päivitystyö ja päivitysten jäähdytysajat ovat erillisiä rajoja; tarkista päivitysbudjetit ennen suurta tuontia tai uudelleenrakennusta. Katso hinnoittelusta dokumentoidut jaetut pakettikiintiöt ja Tili ja laskutus -osiosta tilisi nykyinen käyttö ja käytettävissä oleva kiintiö.

Viestien, sivujen ja verkkosivustojen PAYG on valinnainen Pro/Business-paketeissa ja oletusarvoisesti pois käytöstä. Aseta kohdassa Tili ja laskutus kuukausittaiset ylitysbudjetit ominaisuuksittain tai valitse nimenomaisesti Ei kulutuskattoa. Nollabudjetti pitää ominaisuuden tiukasti rajattuna; ilman kulutuskattoa käyttö voi aiheuttaa rajattomia lisäveloituksia. PAYG ei avaa Free/Starter-pakettien ominaisuuksia eikä ohita crawlerin päivitysten jäähdytysaikoja. Profiilin nimeä voi muokata siellä; sähköpostiosoitetta hallitaan kirjautumispalvelun tiliasetuksissa.