Hoe voegt u de Asyntai AI-chatbot toe aan Kentico

Stapsgewijze handleiding voor Kentico CMS-websites

Platform:

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: Code toevoegen aan de hoofdpaginatemplate (aanbevolen)

Om de chatbot in één keer aan alle pagina's van uw Kentico-website toe te voegen, gebruikt u de hoofdpaginatemplate-methode:

Log in op uw Kentico Admin en navigeer naar de applicatie Page templates
Zoek en open uw Master page template (de template die op alle pagina's wordt gebruikt)
Klik op het tabblad Header in de template-editor
Plak uw Asyntai-insluitcode in de headersectie
U kunt de code ook toevoegen aan de layout van de template voor de afsluitende </head>-tag
Klik op Save om de wijzigingen toe te passen
Wis de cache van uw site en controleer de wijzigingen op de live site

Tip: Het gebruik van de hoofdpaginatemplate zorgt ervoor dat de chatbot verschijnt op elke pagina die van deze template overerft. Dit is de meest efficiënte methode voor een sitewijde implementatie in Kentico.

Alternatieve methode 1: Paginatemplate-header

Als u de chatbot alleen aan specifieke paginatemplates wilt toevoegen:

Ga naar de applicatie Page templates in Kentico Admin
Selecteer de specifieke paginatemplate die u wilt bewerken
Klik op het tabblad Header
Voeg uw Asyntai-insluitcode toe met een scripttag:

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

Klik op Save
Alle pagina's die deze template gebruiken, bevatten nu de chatbot

Opmerking: Deze methode is handig wanneer u de chatbot wilt toevoegen aan specifieke secties van uw site die dezelfde paginatemplate delen, in plaats van aan de hele site.

Alternatieve methode 2: HEAD HTML-webonderdeel

Voor gedetailleerdere controle op specifieke pagina's of voor overerfbaar JavaScript op subpagina's:

Open de pagina die u wilt bewerken in de Kentico Page-editor
Voeg een nieuw webonderdeel toe aan de pagina (bij voorkeur op een bovenliggende pagina voor overerving)
Zoek naar en selecteer het webonderdeel HEAD HTML
Plak uw Asyntai-insluitcode in de configuratie van het webonderdeel
Configureer het webonderdeel als overerfbaar als u wilt dat onderliggende pagina's de chatbot hebben
Klik op OK om het webonderdeel op te slaan
Sla de pagina op en publiceer deze

Tip: Het HEAD HTML-webonderdeel is perfect voor het toevoegen van code aan een bovenliggende pagina die automatisch wordt doorgegeven aan alle onderliggende pagina's, waardoor een sectiewijde installatie ontstaat.

Alternatieve methode 3: Aangepaste JavaScript-bestanden (geavanceerd)

Voor ontwikkelaars die scripts liever als bestanden beheren:

Navigeer in uw Kentico-project naar de map ~/CMSScripts/Custom/
Maak een nieuw JavaScript-bestand aan (bijv. asyntai-widget.js)
Voeg code toe om uw Asyntai-widget dynamisch te laden:

(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);
})();

Verwijs naar dit bestand in de header van uw hoofdpaginatemplate:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Belangrijk: Deze geavanceerde methode vereist toegang tot het bestandssysteem en kennis van de mapstructuur van Kentico. Zorg ervoor dat u de juiste machtigingen hebt en test altijd eerst in een stagingomgeving.

Stap 3: Installatie verifiëren

Open na het opslaan van uw wijzigingen en het wissen van de cache uw website in een nieuw browsertabblad of incognitovenster. U zou de chatwidgetknop rechtsonder in de hoek moeten zien. Klik erop om te controleren of deze correct opent en werkt.

Ziet u de widget niet? Zorg ervoor dat u alle wijzigingen hebt opgeslagen en de cache van Kentico hebt gewist (Settings > System > Clear cache). Probeer uw site te bekijken in een incognitovenster. Controleer de browserconsole (F12) op JavaScript-fouten die het laden van de widget kunnen verhinderen.