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
| Tavoite | Seuraava vaihe |
|---|---|
| Liittää ChattyBoxin ylläpidetyn käyttöliittymän sovelluskoodista | JavaScript SDK |
| Rakentaa ja ylläpitää oma käyttöliittymä | Headless JavaScript SDK |
| Antaa AI-koodausavustajan integroida npm-paketti | AI-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-vaihetta | Hostatun widgetin skripti |
| Lisätä ylläpidetty widget WordPressiin muuttamatta teemaa | WordPress-lisäosa |
| Lisätä ylläpidetty widget Drupal 10- tai 11-sivustolle Composerilla | Drupal-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-arvo | Mitä voit tehdä |
|---|---|---|
| Yleiskatsaus | overview | Tarkista käyttöönoton eteneminen ja viimeaikainen toiminta |
| Tietopohja → Tuo ja päivitä | settings | Etsi, valitse, tuo ja päivitä sivuja; säädä lähdeasetuksia |
| Tietopohja → Sivut | content | Tarkastele sivuja ja haravointitöitä, poista sisältöä ja rakenna embeddingit uudelleen |
| Testaa chatbottia | test | Esitä kysymyksiä ja palaa tallennettuihin keskusteluihin |
| Keskustelut → Historia | logs | Lue tallennettuja keskusteluja ja poista yksittäisiä keskusteluja tai kaikki keskustelut |
| Keskustelut → Analytiikka | analytics | Tarkastele viimeisen 30 päivän vuorovaikutuksia, enintään 5 000 tallennetta; Pro/Business |
| Keskustelut → Vastaamattomia kysymyksiä | gaps | Tarkastele ja ratkaise havaittuja vastaamattomia kysymyksiä; Pro/Business |
| Mukauta → Käyttäytyminen | prompts | Valitse tai muokkaa avustajan ohjeita |
| Mukauta → Ulkonäkö | appearance | Esikatsele ja säädä hostatun widgetin ulkoasua ja kieltä |
| Asenna → Avaimet ja verkkotunnukset | keys | Luo/poista julkisia widget-avaimia ja muokkaa valinnaisia origin-rajoituksia |
| Asenna → Verkkosivuston asennus | embed | Valmistele asennus ja kopioi avaimen koodinpätkä |
| Chatbotin asetukset | manage | Hallitse 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
| Paketti | Chatbotit | Sisältyvät sivut | Viestejä kuukaudessa |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1 000 |
| Pro | 10 | 5 000 | 10 000 |
| Business | 25 | 25 000 | 50 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.