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

Schritt-für-Schritt-Anleitung für Drupal-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: Verwendung des Header and Footer Scripts-Moduls (Empfohlen)

Der einfachste Weg, den Chatbot hinzuzufügen, ist die Verwendung des Moduls "Header and Footer Scripts":

  1. Log in to your Drupal admin panel
  2. Gehen Sie zu Extend und klicken Sie auf "Install new module"
  3. Suchen Sie nach "Header and Footer Scripts" oder laden Sie es von Drupal.org herunter
  4. Installieren und aktivieren Sie das Modul
  5. Gehen Sie zu Configuration → Development → Header and Footer Scripts
  6. Klicken Sie auf den Tab "Footer"
  7. Paste your Asyntai embed code in the footer scripts text area
  8. Klicken Sie auf "Konfiguration speichern"

Tipp: Das Hinzufügen des Codes im Footer-Bereich stellt sicher, dass er nach dem Seiteninhalt geladen wird, was für Chat-Widgets empfohlen wird.

Alternative: Theme-Template bearbeiten

You can add the code directly to your theme's template file:

  1. Navigieren Sie zu Ihrem Theme-Ordner: themes/your_theme/
  2. Öffnen Sie die Datei html.html.twig (oder erstellen Sie eine, falls sie nicht existiert)
  3. Suchen Sie das schließende </body>-Tag
  4. Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem </body>-Tag ein
  5. Speichern Sie die Datei
  6. Leeren Sie den Drupal-Cache: Configuration → Performance → Clear all caches

Wichtig: Änderungen an Theme-Dateien können beim Aktualisieren Ihres Themes überschrieben werden. Erwägen Sie die Verwendung eines Child-Themes oder des Moduls Header and Footer Scripts für eine dauerhaftere Lösung.

Alternative: Verwendung von Libraries (Für Entwickler)

Für Entwickler, die das Asset-Library-System von Drupal bevorzugen:

  1. Create or edit your theme's *.libraries.yml file
  2. Fügen Sie einen neuen Library-Eintrag hinzu:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Attach the library in your theme's *.info.yml file:
    libraries:
    - your_theme/asyntai-chatbot
  4. Leeren Sie den Drupal-Cache

Schritt 3: Installation überprüfen

Nachdem Sie Ihre Änderungen gespeichert und den Cache geleert haben, besuchen Sie 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 den Drupal-Cache leeren, indem Sie zu Configuration → Performance → Clear all caches gehen. Versuchen Sie auch, Ihren Browser-Cache zu leeren oder in einem Inkognito-Fenster zu öffnen.