Julkaisu

Julkaise tekoälyagentti chat-widgetinä tai sivulle upotettuna keskusteluna.

Avaa kopiointivalikko

Voit julkaista tekoälyagentin kelluvana chat-widgetinä tai sivun sisältöön sijoitettuna keskusteluna. Kopioi aina juuri tämän agentin koodi Muokkaimen Asenna-valikosta. Koodi sisältää oikean julkisen tunnisteen, joten sitä ei tarvitse muokata käsin.

Upotustapa · Valitse tämä, kun · Huomio
Upotustapa	Valitse tämä, kun	Huomio
Verkkosivun chat-widget	Haluat kelluvan avauspainikkeen koko sivustolle	Tukee Widget API -komentoja, analytiikkasuostumusta ja kirjautuneen käyttäjän tunnistamista
Sivulle upotettu keskustelu	Haluat keskusteluikkunan kiinteäksi osaksi yhtä sivua	Ei näytä kelluvaa avauspainiketta eikä tue isäntäsivun Widget API -komentoja
WordPress	Sivustosi käyttää WordPressiä	Virallinen lisäosa asentaa widgetin ilman koodin kopiointia

Ennen asennusta

Testaa tavallisimmat asiakaskysymykset Muokkaimen esikatselussa.
Tallenna muutokset ja julkaise agentti. Luonnos tai tauolla oleva agentti ei vastaa sivustolla.
Avaa Asetukset → Suojaus. Jos domain-rajoitus on käytössä, lisää jokainen käytettävä origin erikseen, esimerkiksi https://example.com ja https://www.example.com. *.example.com ei kata apex-domainia example.com.

Avaa agentin Muokkain.
Valitse Asenna → Verkkosivun chat-widget.
Kopioi koko <script>-koodinpätkä.
Lisää koodi kerran sivuston yhteiseen pohjaan juuri ennen sulkevaa </body>-tagia.
Julkaise sivuston muutos.

Useimmat julkaisujärjestelmät tarjoavat sivustonlaajuisen Footer- tai Custom Code -kentän. WordPressissä voit käyttää myös virallista Aihio Chatbot -lisäosaa .

Astro-sivusto

Luo esimerkiksi src/components/AihioWidget.astro ja liitä Muokkaimesta kopioitu koodi siihen. Muuta vain avaava <script>-tagi muotoon <script is:inline>, jotta Astro ei niputa tai siirrä julkista bootstrap-koodia.

Tuo komponentti yhteiseen layoutiin ja renderöi se kerran ennen </body>-tagia:

---
import AihioWidget from '../components/AihioWidget.astro';
---

<html lang="fi">
  <body>
    <slot />
    <AihioWidget />
  </body>
</html>

Älä lisää chatbotin salaisuutta Astro-komponenttiin tai mihinkään PUBLIC_-ympäristömuuttujaan. Upotuskoodin chatbotId on julkinen tunniste; identiteettivarmistuksen salaisuus kuuluu vain palvelimelle.

Välitä analytiikkasuostumus

Chat toimii ilman analytiikkasuostumusta. Välitä käyttäytymisanalytiikan lupa widgetille vasta, kun kävijä on hyväksynyt sen evästehallinnassa:

AihioWidget('consent', {
  analytics: hasAnalyticsConsent,
});

Korvaa hasAnalyticsConsent oman evästehallintasi totuusarvolla ja kutsu komentoa aina valinnan muuttuessa. Tuntematon tai hylätty valinta tarkoittaa arvoa false. Selaimen Do Not Track -asetus estää widgetin analytiikan myös silloin, kun isäntäsivu välittää arvon true.

Tunnista kirjautunut käyttäjä

Käytä tunnistamiseen lyhytikäistä, palvelimella HS256-allekirjoitettua JWT:tä ja välitä selaimelle vain valmis token:

AihioWidget('identify', {
  token: serverSignedIdentityToken,
});

Kutsu uloskirjautumisen yhteydessä AihioWidget('resetUser'), jotta seuraava saman laitteen käyttäjä ei näe edellisen käyttäjän keskusteluhistoriaa. Katso palvelin-esimerkit, tokenin väitteet ja turvallinen käyttöönottojärjestys identiteettivarmistuksen ohjeesta . Älä koskaan allekirjoita tokenia selaimessa tai paljasta salaisuutta upotuskoodissa.

Upota keskustelu sivun sisältöön

Valitse Asenna → Sivulle upotettu keskustelu.
Kopioi koko <iframe>-elementti.
Lisää se kohtaan, jossa haluat keskustelun näkyvän.
Säädä ympäröivän alueen korkeus. Oletuskoodi käyttää vähintään 600 pikselin korkeutta.

Iframe sopii esimerkiksi yhteydenotto- tai tukisivulle. Valitse skriptiupotus, jos tarvitset kelluvan avauspainikkeen, identify-komennon, analytiikkasuostumuksen tai muut Widget API -komennot.

Varmista asennus

Avaa julkaistu sivu yksityisessä selainikkunassa.
Varmista, että chat-widget tai upotettu keskustelu näkyy ja vastaa testiviestiin.
Testaa sekä mobiili- että työpöytäleveys.
Testaa analytiikkasuostumuksen hyväksytty ja hylätty tila, jos välität suostumuksen.
Jos tunnistat käyttäjiä, tarkista Asetukset → Suojaus -näkymästä, että Aihio on vastaanottanut validin tokenin ennen varmistuksen pakottamista.

Jos keskustelu ei näy

Selain näyttää domain-virheen: lisää osoiterivin tarkka origin sallittuihin domaineihin. Lisää esikatselu- ja tuotantodomain erikseen.
Selainkonsolissa näkyy CSP-virhe: salli https://app.aihio.ai skripti- ja verkkoyhteyksille tai iframe-upotukselle. Salli inline-bootstrap nonce- tai hash-menetelmällä; älä heikennä koko sivustoa asetuksella unsafe-inline vain widgetiä varten.
Latauspyyntö epäonnistuu: tarkista selaimen Network-välilehdeltä, että aihio-loader.js ja chatbotin asetusten pyyntö palauttavat onnistuneen vastauksen.
Koodi näkyy vain osalla sivuista: siirrä skripti sivuston yhteiseen layoutiin ja varmista, että se lisätään vain kerran.
Iframe on liian matala: määritä ympäröivälle elementille korkeus tai muuta iframe-elementin min-height-arvoa.

Voit perua asennuksen poistamalla lisäämäsi <script>- tai <iframe>-elementin ja julkaisemalla sivuston uudelleen.

Keskeytä käyttö tai aktivoi uudelleen

Avaa agentin yläpalkin käyttötilan valikko ja valitse Keskeytä, kun haluat lopettaa vastaamisen tilapäisesti. Tarkista, että tila muuttuu muotoon Keskeytetty, ja testaa vaikutus sivustolla.

Kun haluat jatkaa käyttöä, valitse Aktivoi ja varmista testiviestillä, että agentti vastaa jälleen. Jos käyttöönotto estyy, tarkista valmis tietolähde ja näkyvä virheilmoitus.

Keskeyttäminen ei poista sivuston asennuskoodia. Poista koodi erikseen, jos et halua keskusteluikkunan latautuvan lainkaan. Käyttötilan muuttaminen ei myöskään palauta vanhoja ohjeita tai aiempaa asetuskokonaisuutta.