Sådan tilføjer du Asyntai AI-chatbot til Kentico

Trin-for-trin guide til Kentico CMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Tilføj kode til mastersidens skabelon (anbefalet)

For at tilføje chatbotten til alle sider på dit Kentico-websted på én gang skal du bruge mastersidens skabelonmetode:

Log ind på din Kentico Admin og naviger til applikationen Sideskabeloner
Find og åbn din mastersidens skabelon (skabelonen, der bruges på tværs af alle sider)
Klik på fanen Header i skabeloneditoren
I header-sektionen skal du indsætte din Asyntai-indlejringskode
Alternativt kan du tilføje koden til skabelonens layout før det afsluttende </head>-tag
Klik på Gem for at anvende ændringerne
Ryd dit websteds cache og bekræft ændringerne på det live websted

Tip: Brug af mastersidens skabelon sikrer, at chatbotten vises på hver side, der arver fra denne skabelon. Dette er den mest effektive metode til webstedsdækkende udrulning i Kentico.

Alternativ metode 1: Sideskabelonens header

Hvis du kun vil tilføje chatbotten til specifikke sideskabeloner:

Gå til applikationen Sideskabeloner i Kentico Admin
Vælg den specifikke sideskabelon, du vil redigere
Klik på fanen Header
Tilføj din Asyntai-indlejringskode ved hjælp af et script-tag:

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

Klik på Gem
Alle sider, der bruger denne skabelon, vil nu inkludere chatbotten

Bemærk: Denne metode er nyttig, når du vil tilføje chatbotten til specifikke sektioner af dit websted, der deler den samme sideskabelon, frem for hele webstedet.

Alternativ metode 2: HEAD HTML-webdel

For mere detaljeret kontrol på specifikke sider eller for nedarvbart JavaScript på undersider:

Åbn den side, du vil redigere, i Kentico-sideeditoren
Tilføj en ny webdel til siden (fortrinvis på en overordnet side for nedarvning)
Søg efter og vælg webdelen HEAD HTML
I webdelskonfigurationen skal du indsætte din Asyntai-indlejringskode
Konfigurer webdelen til at være nedarvelig, hvis du ønsker, at underordnede sider skal have chatbotten
Klik på OK for at gemme webdelen
Gem og udgiv siden

Tip: HEAD HTML-webdelen er perfekt til at tilføje kode til en overordnet side, der automatisk vil forplante sig til alle underordnede sider og skabe en sektionsdækkende installation.

Alternativ metode 3: Brugerdefinerede JavaScript-filer (avanceret)

Til udviklere, der foretrækker at administrere scripts som filer:

I dit Kentico-projekt skal du navigere til ~/CMSScripts/Custom/-mappen
Opret en ny JavaScript-fil (f.eks. asyntai-widget.js)
Tilføj kode til dynamisk at indlæse din Asyntai-widget:

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

Referer til denne fil i din mastersidens skabelons header:

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

Vigtigt: Denne avancerede metode kræver adgang til filsystemet og kendskab til Kenticos mappestruktur. Sørg for, at du har de rette tilladelser, og test altid i et stagingmiljø først.

Trin 3: Verificér installationen

Åbn dit websted i en ny browserfane eller inkognitovindue efter at have gemt dine ændringer og ryddet cachen. Du bør se chat-widget-knappen i det nedre højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for, at du har gemt alle ændringer og ryddet Kenticos cache (Indstillinger > System > Ryd cache). Prøv at se dit websted i et inkognitovindue. Tjek browserkonsollen (F12) for eventuelle JavaScript-fejl, der kan forhindre widgeten i at indlæse.