Takaisin hallintapaneeliin

Dokumentaatio

Opi käyttämään Asyntai

Asyntai AI -chatbotin lisääminen Kenticoon

Vaiheittainen opas Kentico CMS -verkkosivustoille

Hae upotuskoodi

Vaihe 1: Hanki upotuskoodisi

Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Vaihe 2: Koodin lisääminen pääsivutemplaattiin (suositeltu)

Chatbotin lisäämiseksi kaikille Kentico-verkkosivustosi sivuille kerralla käytä pääsivutemplaattimenetelmää:

  1. Kirjaudu Kentico-ylläpitopaneeliisi ja siirry Page templates -sovellukseen
  2. Etsi ja avaa Master page template (kaikilla sivuilla käytetty templaatti)
  3. Napsauta Header-välilehteä templaattieditorissa
  4. Liitä Asyntai-upotuskoodisi header-osioon
  5. Vaihtoehtoisesti lisää koodi templaatin asetteluun ennen sulkevaa </head>-tagia
  6. Napsauta Save ottaaksesi muutokset käyttöön
  7. Tyhjennä sivuston välimuisti ja varmista muutokset julkisella sivustolla

Vinkki: Pääsivutemplaatin käyttö varmistaa, että chatbot näkyy jokaisella sivulla, joka perii tämän templaatin. Tämä on tehokkain menetelmä koko sivuston kattavaan käyttöönottoon Kenticossa.

Vaihtoehtoinen menetelmä 1: Sivutemplaatin otsikko

Jos haluat lisätä chatbotin vain tiettyihin sivutemplaatteihin:

  1. Siirry Page templates -sovellukseen Kentico-ylläpidossa
  2. Valitse tietty sivutemplaatti, jota haluat muokata
  3. Napsauta Header-välilehteä
  4. Lisää Asyntai-upotuskoodisi script-tagilla:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  1. Napsauta Save
  2. Kaikki tätä templaattia käyttävät sivut sisältävät nyt chatbotin

Huomautus: Tämä menetelmä on hyödyllinen, kun haluat lisätä chatbotin tietyille sivuston osioille, joilla on sama sivutemplaatti, koko sivuston sijaan.

Vaihtoehtoinen menetelmä 2: HEAD HTML -verkko-osa

Tarkempaa hallintaa varten tietyillä sivuilla tai periytyvää JavaScriptiä alasivuille:

  1. Avaa muokattava sivu Kentico-sivueditorissa
  2. Lisää uusi verkko-osa sivulle (mieluiten yläsivulle periytymistä varten)
  3. Etsi ja valitse HEAD HTML -verkko-osa
  4. Liitä Asyntai-upotuskoodisi verkko-osan asetuksiin
  5. Määritä verkko-osa periytyväksi, jos haluat chatbotin myös alasivuille
  6. Napsauta OK tallentaaksesi verkko-osan
  7. Tallenna ja julkaise sivu

Vinkki: HEAD HTML -verkko-osa sopii erinomaisesti koodin lisäämiseen yläsivulle, josta se leviää automaattisesti kaikille alasivuille luoden osiokohtaisen asennuksen.

Vaihtoehtoinen menetelmä 3: Mukautetut JavaScript-tiedostot (edistynyt)

Kehittäjille, jotka haluavat hallita skriptejä tiedostoina:

  1. Siirry Kentico-projektissasi ~/CMSScripts/Custom/-hakemistoon
  2. Luo uusi JavaScript-tiedosto (esim. asyntai-widget.js)
  3. Lisää koodi Asyntai-widgetin dynaamiseen lataamiseen:
(function() { var script = document.createElement('script'); script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); script.async = true; document.head.appendChild(script); })();
  1. Viittaa tähän tiedostoon pääsivutemplaattisi otsikossa:
<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Tärkeää: Tämä edistynyt menetelmä vaatii tiedostojärjestelmän käyttöoikeuden ja Kenticon hakemistorakenteen tuntemusta. Varmista, että sinulla on asianmukaiset oikeudet ja testaa aina ensin testiympäristössä.

Vaihe 3: Vahvista asennus

Tallenna muutokset ja tyhjennä välimuisti, avaa sitten verkkosivustosi uudessa selainvälilehdessä tai incognito-ikkunassa. Chat-widget-painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.

Etkö näe widgetiä? Varmista, että olet tallentanut kaikki muutokset ja tyhjentänyt Kenticon välimuistin (Settings > System > Clear cache). Kokeile avata sivustosi incognito-ikkunassa. Tarkista selaimen konsoli (F12) mahdollisten JavaScript-virheiden varalta, jotka saattavat estää widgetin latautumisen.