So fügen Sie den Asyntai-KI-Chatbot zu Kentico hinzu

Schritt-für-Schritt-Anleitung für Kentico CMS-Websites

Plattform:

Schritt 1: Ihren Einbettungscode erhalten

Gehen Sie zunächst zu Ihrem Asyntai Dashboard und scrollen Sie zum Abschnitt "Einbettungscode". Kopieren Sie Ihren einzigartigen Einbettungscode, der so aussieht:

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

Hinweis: Der obige Code ist nur ein Beispiel. Sie müssen Ihren eigenen einzigartigen Einbettungscode von Ihrem Dashboard kopieren, da er Ihre persönliche Widget-ID enthält.

Schritt 2: Code zur Master-Seitenvorlage hinzufügen (Empfohlen)

Um den Chatbot gleichzeitig auf allen Seiten Ihrer Kentico-Website hinzuzufügen, verwenden Sie die Master-Seitenvorlagen-Methode:

Melden Sie sich in Ihrem Kentico-Admin an und navigieren Sie zur Anwendung Page templates
Suchen und öffnen Sie Ihre Master-Seitenvorlage (die Vorlage, die auf allen Seiten verwendet wird)
Klicken Sie auf den Tab Header im Vorlagen-Editor
Fügen Sie im Header-Abschnitt Ihren Asyntai-Einbettungscode ein
Alternativ können Sie den Code zum Layout der Vorlage vor dem schließenden </head>-Tag hinzufügen
Klicken Sie auf Save, um die Änderungen zu übernehmen
Leeren Sie den Cache Ihrer Website und überprüfen Sie die Änderungen auf der Live-Website

Tipp: Die Verwendung der Master-Seitenvorlage stellt sicher, dass der Chatbot auf jeder Seite erscheint, die von dieser Vorlage erbt. Dies ist die effizienteste Methode für die websiteweite Bereitstellung in Kentico.

Alternative Methode 1: Seitenvorlagen-Header

Wenn Sie den Chatbot nur zu bestimmten Seitenvorlagen hinzufügen möchten:

Gehen Sie zur Anwendung Seitenvorlagen in Kentico Admin
Wählen Sie das spezifische Seitentemplate aus, das Sie bearbeiten möchten
Klicken Sie auf den Tab Header
Fügen Sie Ihren Asyntai-Einbettungscode mit einem Script-Tag hinzu:

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

Klicken Sie auf Save
Alle Seiten, die diese Vorlage verwenden, enthalten jetzt den Chatbot

Hinweis: Diese Methode ist nützlich, wenn Sie den Chatbot zu bestimmten Bereichen Ihrer Website hinzufügen möchten, die dieselbe Seitenvorlage verwenden, anstatt zur gesamten Website.

Alternative Methode 2: HEAD HTML Web Part

Für detailliertere Kontrolle auf bestimmten Seiten oder für vererbbares JavaScript über Unterseiten hinweg:

Öffnen Sie die Seite, die Sie bearbeiten möchten, im Kentico-Seiteneditor
Fügen Sie der Seite ein neues Web Part hinzu (vorzugsweise auf einer übergeordneten Seite für die Vererbung)
Suchen und wählen Sie das Web Part HEAD HTML
Fügen Sie Ihren Asyntai-Einbettungscode in die Webpart-Konfiguration ein
Konfigurieren Sie das Web Part als vererbbar, wenn Sie möchten, dass untergeordnete Seiten den Chatbot haben
Klicken Sie auf OK, um das Web Part zu speichern
Speichern und veröffentlichen Sie die Seite

Tipp: Das HEAD HTML Web Part eignet sich perfekt zum Hinzufügen von Code auf einer übergeordneten Seite, der automatisch auf alle untergeordneten Seiten übertragen wird und so eine bereichsweite Installation ermöglicht.

Alternative Methode 3: Benutzerdefinierte JavaScript-Dateien (Fortgeschritten)

Für Entwickler, die Skripte lieber als Dateien verwalten:

Navigieren Sie in Ihrem Kentico-Projekt zum Verzeichnis ~/CMSScripts/Custom/
Erstellen Sie eine neue JavaScript-Datei (z. B. asyntai-widget.js)
Fügen Sie Code hinzu, um Ihr Asyntai-Widget dynamisch zu 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);
})();

Referenzieren Sie diese Datei im Header Ihrer Master-Seitenvorlage:

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

Wichtig: Diese fortgeschrittene Methode erfordert Dateisystemzugriff und Kenntnisse der Kentico-Verzeichnisstruktur. Stellen Sie sicher, dass Sie über die richtigen Berechtigungen verfügen, und testen Sie immer zuerst in einer Staging-Umgebung.

Schritt 3: Installation überprüfen

Öffnen Sie nach dem Speichern Ihrer Änderungen und dem Leeren des Caches Ihre Website in einem neuen Browser-Tab oder Inkognito-Fenster. Sie sollten den Chat-Widget-Button in der unteren rechten Ecke sehen. Klicken Sie darauf, um sicherzustellen, dass er sich öffnet und korrekt funktioniert.

Widget nicht sichtbar? Stellen Sie sicher, dass Sie alle Änderungen gespeichert und den Kentico-Cache geleert haben (Settings > System > Clear cache). Versuchen Sie, Ihre Website in einem Inkognito-Fenster anzuzeigen. Überprüfen Sie die Browser-Konsole (F12) auf JavaScript-Fehler, die das Laden des Widgets verhindern könnten.