Zurück zum Dashboard

Dokumentation

Erfahren Sie, wie Sie Asyntai verwenden

So fügen Sie den Asyntai-KI-Chatbot zu Adobe Commerce (Magento) hinzu

Schritt-für-Schritt-Anleitung für Magento-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: Page Builder verwenden (Empfohlen)

Der einfachste Weg, den Chatbot hinzuzufügen, ist die Verwendung des HTML-Code-Blocks im Page Builder:

  1. Melden Sie sich in Ihrem Magento-Admin-Panel an
  2. Gehen Sie zu Content → Pages
  3. Bearbeiten Sie Ihre Startseite (oder jede andere Seite, auf der Sie den Chatbot möchten)
  4. Ziehen Sie im Page Builder ein "HTML Code"-Element auf die Seite
  5. Fügen Sie Ihren Asyntai-Einbettungscode ein
  6. Klicken Sie auf "Save"
  7. Leeren Sie den Cache: System → Cache Management → Flush Magento Cache

Wichtig: Die Verwendung des Page Builders fügt den Code nur zu einzelnen Seiten hinzu. Für eine websiteweite Installation verwenden Sie die unten beschriebene Layout-XML-Methode.

Alternative: Layout-XML verwenden (Alle Seiten)

Um den Chatbot auf allen Seiten hinzuzufügen, erstellen Sie eine Layout-Datei in Ihrem Theme:

  1. Navigieren Sie zu Ihrem Theme-Ordner: app/design/frontend/[Vendor]/[theme]/
  2. Erstellen Sie die Ordnerstruktur, falls sie nicht existiert: Magento_Theme/layout/
  3. Erstellen oder bearbeiten Sie die Datei default_head_blocks.xml
  4. Fügen Sie den folgenden Code hinzu:
    <?xml version="1.0"?>
    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <head>
    <script src="https://asyntai.com/static/js/chat-widget.js" src_type="url" async="true" data-asyntai-id="YOUR_WIDGET_ID"/>
    </head>
    </page>
  5. Ersetzen Sie YOUR_WIDGET_ID durch Ihre tatsächliche Widget-ID
  6. Führen Sie aus: bin/magento cache:flush
  7. Führen Sie aus: bin/magento setup:static-content:deploy -f (wenn im Produktionsmodus)

Alternative: CMS-Block verwenden

Sie können auch einen CMS-Block erstellen und ihn in Ihre Fußzeile einfügen:

  1. Gehen Sie zu Content → Blocks
  2. Klicken Sie auf "Add New Block"
  3. Setzen Sie einen Titel wie "Asyntai Chatbot"
  4. Setzen Sie den Identifier auf asyntai_chatbot
  5. Wechseln Sie im Inhaltseditor in den HTML-Modus und fügen Sie Ihren Einbettungscode ein
  6. Klicken Sie auf "Save Block"
  7. Fügen Sie den Block mit folgendem Code zu Ihrer Footer-Vorlage hinzu: {{block id="asyntai_chatbot"}}
  8. Leeren Sie den Cache

Schritt 3: Installation überprüfen

Besuchen Sie nach dem Speichern Ihrer Änderungen und dem Leeren des Caches Ihren Shop 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 Caches leeren: System → Cache Management → Flush Magento Cache. Versuchen Sie auch, Ihren Browser-Cache zu leeren oder die Seite in einem Inkognito-Fenster anzuzeigen. Im Produktionsmodus führen Sie bin/magento setup:static-content:deploy -f aus.