Cum să adăugați Chatbot-ul AI Asyntai în Kentico

Ghid pas cu pas pentru site-urile CMS Kentico

Platformă:

Pasul 1: Obțineți codul de încorporare

Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:

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

Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.

Pasul 2: Adăugați codul în șablonul Master Page (Recomandat)

Pentru a adăuga chatbot-ul pe toate paginile site-ului Kentico simultan, utilizați metoda șablonului Master Page:

Conectați-vă la Kentico Admin și navigați la aplicația Page templates
Localizați și deschideți șablonul Master page (șablonul utilizat pe toate paginile)
Faceți clic pe fila Header în editorul de șabloane
În secțiunea header, lipiți codul de integrare Asyntai
Alternativ, adăugați codul în layout-ul șablonului înainte de eticheta de închidere </head>
Faceți clic pe Save pentru a aplica modificările
Goliți cache-ul site-ului și verificați modificările pe site-ul live

Sfat: Utilizarea șablonului Master Page asigură că chatbot-ul apare pe fiecare pagină care moștenește din acest șablon. Aceasta este cea mai eficientă metodă pentru implementarea pe tot site-ul în Kentico.

Metoda alternativă 1: Header-ul șablonului de pagină

Dacă doriți să adăugați chatbot-ul doar la șabloane de pagini specifice:

Mergeți la aplicația Page templates în Kentico Admin
Selectați șablonul de pagină specific pe care doriți să îl editați
Faceți clic pe fila Header
Adăugați codul de integrare Asyntai folosind o etichetă script:

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

Faceți clic pe Save
Toate paginile care folosesc acest șablon vor include acum chatbot-ul

Notă: Această metodă este utilă atunci când doriți să adăugați chatbot-ul la secțiuni specifice ale site-ului care partajează același șablon de pagină, și nu pe întregul site.

Metoda alternativă 2: Web Part HEAD HTML

Pentru un control mai granular pe pagini specifice sau pentru JavaScript moștenibil pe sub-pagini:

Deschideți pagina pe care doriți să o editați în editorul de pagini Kentico
Adăugați un nou web part pe pagină (preferabil pe o pagină părinte pentru moștenire)
Căutați și selectați web part-ul HEAD HTML
În configurația web part-ului, lipiți codul de integrare Asyntai
Configurați web part-ul să fie moștenibil dacă doriți ca paginile copil să aibă chatbot-ul
Faceți clic pe OK pentru a salva web part-ul
Salvați și publicați pagina

Sfat: Web part-ul HEAD HTML este perfect pentru adăugarea codului pe o pagină părinte care se va propaga automat către toate paginile copil, creând o instalare pe întreaga secțiune.

Metoda alternativă 3: Fișiere JavaScript personalizate (Avansat)

Pentru dezvoltatorii care preferă gestionarea scripturilor ca fișiere:

În proiectul Kentico, navigați la directorul ~/CMSScripts/Custom/
Creați un fișier JavaScript nou (de exemplu, asyntai-widget.js)
Adăugați cod pentru a încărca dinamic widget-ul Asyntai:

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

Referențiați acest fișier în header-ul șablonului Master Page:

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

Important: Această metodă avansată necesită acces la sistemul de fișiere și cunoștințe despre structura de directoare a Kentico. Asigurați-vă că aveți permisiunile corespunzătoare și testați întotdeauna mai întâi într-un mediu de staging.

Pasul 3: Verificați instalarea

După ce ați salvat modificările și ați golit cache-ul, deschideți site-ul dvs. într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.

Nu vedeți widgetul? Asigurați-vă că ați salvat toate modificările și ați golit cache-ul Kentico (Settings > System > Clear cache). Încercați să vizualizați site-ul într-o fereastră incognito. Verificați consola browserului (F12) pentru eventualele erori JavaScript care ar putea împiedica încărcarea widget-ului.