Zurück zum Dashboard

Dokumentation

Erfahren Sie, wie Sie Asyntai verwenden

So fügen Sie den Asyntai AI Chatbot zu CrafterCMS hinzu

Schritt-für-Schritt-Anleitung für CrafterCMS-Websites

Einbettungscode erhalten

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: Zum FreeMarker-Template hinzufügen (Empfohlen)

CrafterCMS verwendet FreeMarker (.ftl) Templates zum Rendern von Seiten. Der einfachste Weg, den Chatbot zu allen Seiten hinzuzufügen, ist die Bearbeitung Ihres Haupt-Seiten-Templates:

  1. Gehen Sie in Crafter Studio zu Site Dashboard > Content Types oder navigieren Sie zu den Templates
  2. Öffnen Sie Ihr Haupt-Seiten-Template (z.B. /templates/web/pages/home.ftl oder das Basis-Layout)
  3. Suchen Sie das schließende </body>-Tag
  4. Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem </body>-Tag ein:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Speichern Sie die Datei und veröffentlichen Sie über Crafter Studio

Tipp: Das Hinzufügen des Skripts vor dem schließenden </body>-Tag stellt sicher, dass es nach dem Seiteninhalt geladen wird, was für Chat-Widgets empfohlen wird und das Laden Ihrer Seite nicht verlangsamt.

Alternative Methode 1: Verwendung von Crafter-Template-Komponenten

Für eine bessere Organisation erstellen Sie ein dediziertes Komponenten-Template für das Chatbot-Widget:

  1. Erstellen Sie in Crafter Studio eine neue Template-Datei unter /templates/web/components/asyntai-widget.ftl
  2. Fügen Sie den folgenden Inhalt zum Komponenten-Template hinzu:
    <!-- Asyntai AI Chatbot Component --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  3. Binden Sie es in Ihr Haupt-Layout-Template mit einer FreeMarker-Include-Direktive ein:
    <#include "/templates/web/components/asyntai-widget.ftl" />
  4. Alternativ, wenn Sie Crafters Komponenten-Rendering-System verwenden:
    <@renderComponent component=contentModel.asyntaiWidget />
  5. Speichern Sie beide Dateien und veröffentlichen Sie über Crafter Studio

Hinweis: Die Verwendung eines separaten Komponenten-Templates ermöglicht es, den Chatbot auf Ihrer gesamten Website einfach zu aktivieren oder zu deaktivieren, indem Sie eine einzelne Include-Zeile auskommentieren.

Alternative Methode 2: Crafters Head/Scripts-Konfiguration verwenden

CrafterCMS ermöglicht das globale Einbinden von Skripten über die Website-Konfiguration:

  1. Navigieren Sie in Crafter Studio zu Site Config > Configuration
  2. Öffnen Sie die Datei Engine Site Configuration (site-config.xml)
  3. Fügen Sie eine benutzerdefinierte Skript-Injektionskonfiguration hinzu:
    <site> <!-- Existing configuration... --> <!-- Custom Scripts --> <scripts> <script> <src>https://asyntai.com/static/js/chat-widget.js</src> <async>true</async> <data-asyntai-id>YOUR_WIDGET_ID</data-asyntai-id> </script> </scripts> </site>
  4. Alternativ bearbeiten Sie Ihr Basis-FreeMarker-Layout, um aus der Website-Konfiguration zu lesen und Skripte dynamisch einzubinden:
    <#if siteConfig.getString("scripts.script.src", "")?has_content> <script async src="${siteConfig.getString("scripts.script.src")}" data-asyntai-id="${siteConfig.getString("scripts.script.data-asyntai-id")}"></script> </#if>
  5. Speichern und veröffentlichen Sie die Konfigurationsänderungen

Tipp: Die Verwendung der Website-Konfiguration ermöglicht es Ihnen, das Chatbot-Widget zu verwalten, ohne Template-Dateien direkt zu ändern, was spätere Aktualisierungen oder Entfernungen erleichtert.

Alternative Methode 3: Verwendung eines Groovy-Controllers

CrafterCMS unterstützt Groovy-Skripte für serverseitige Logik. Sie können einen Controller verwenden, um das Chatbot-Skript dynamisch hinzuzufügen:

  1. Erstellen Sie ein Groovy-Skript in /scripts/pages/ (z.B. /scripts/pages/home.groovy oder Ihren seitenweiten Controller)
  2. Fügen Sie den folgenden Code hinzu, um die Skript-URL in das Template-Modell einzufügen:
    // /scripts/pages/home.groovy import org.craftercms.engine.service.context.SiteContext def siteContext = SiteContext.current // Add Asyntai chatbot configuration to the model model.asyntaiEnabled = true model.asyntaiWidgetId = "YOUR_WIDGET_ID" model.asyntaiScriptSrc = "https://asyntai.com/static/js/chat-widget.js"
  3. Referenzieren Sie dann die Modellvariablen in Ihrem FreeMarker-Template:
    <#if model.asyntaiEnabled?? && model.asyntaiEnabled> <script async src="${model.asyntaiScriptSrc}" data-asyntai-id="${model.asyntaiWidgetId}"></script> </#if>
  4. Speichern Sie sowohl das Groovy-Skript als auch die Template-Datei
  5. Veröffentlichen Sie die Änderungen über Crafter Studio

Hinweis: Der Groovy-Controller-Ansatz ist nützlich, wenn Sie bedingte Logik benötigen (z.B. den Chatbot nur für bestimmte Benutzerrollen oder Seitentypen aktivieren) oder wenn Sie Konfigurationswerte aus externen Quellen beziehen möchten.

Schritt 3: Veröffentlichen und überprüfen

Veröffentlichen Sie Ihre Änderungen nach der Bearbeitung über Crafter Studio:

  1. Gehen Sie in Crafter Studio zum Site Dashboard
  2. Überprüfen Sie Ihre Änderungen im Abschnitt My Recent Activity oder Pending Approval
  3. Klicken Sie auf Veröffentlichen, um die Änderungen auf Ihrer Live-Website bereitzustellen
  4. Besuchen Sie Ihre CrafterCMS-Website in einem neuen Browser-Tab oder Inkognito-Fenster
  5. Sie sollten den Chat-Widget-Button in der unteren rechten Ecke sehen
  6. Klicken Sie darauf, um sicherzustellen, dass es korrekt öffnet und funktioniert

Widget nicht sichtbar? Stellen Sie sicher, dass Sie die Änderungen über Crafter Studio veröffentlicht haben. Überprüfen Sie, ob Sie die richtige Template-Datei bearbeiten, die Ihre Seiten verwenden. Leeren Sie Ihren Browser-Cache oder zeigen Sie die Seite in einem Inkognito-Fenster an. Wenn Sie Crafters Caching verwenden, leeren Sie den Engine-Cache über das Crafter Studio Dashboard.

Template-Speicherort: Die Speicherorte von CrafterCMS-Templates können je nach Projektstruktur variieren. Häufige Speicherorte sind /templates/web/pages/ für Seiten-Templates, /templates/web/components/ für Komponenten-Templates und /templates/web/ für Layout-Templates. Überprüfen Sie Ihre vorhandenen Templates, um zu finden, wo das </body>-Tag definiert ist.