So fügen Sie den Asyntai-KI-Chatbot zu Umbraco hinzu
Schritt-für-Schritt-Anleitung für Umbraco-CMS-Websites
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: Master-Template bearbeiten (empfohlen)
Der einfachste Weg, den Chatbot auf allen Seiten hinzuzufügen, ist die Bearbeitung Ihres Master-Templates:
- Melden Sie sich in Ihrem Umbraco-Backoffice an
- Gehen Sie zu Settings in der linken Seitenleiste
- Erweitern Sie Templates
- Klicken Sie auf Ihr Master-Template (oder das Haupt-Layout-Template, das Ihre Website verwendet)
- Suchen Sie das schließende
</body>-Tag - Fügen Sie Ihren Asyntai-Einbettungscode direkt vor dem
</body>-Tag ein - Klicken Sie auf "Save"
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: Site-Settings-Dokumenttyp verwenden
Für mehr Flexibilität können Sie ein benutzerdefiniertes Feld hinzufügen, um Footer-Skripte zu verwalten:
- Gehen Sie zu Settings → Document Types
- Bearbeiten Sie Ihren Site Settings-Dokumenttyp (oder erstellen Sie einen, falls er nicht existiert)
- Fügen Sie eine neue Eigenschaft namens "Footer Scripts" mit dem Datentyp Textarea hinzu
- Speichern Sie den Dokumenttyp
- Go to Content and edit your Site Settings node
- Fügen Sie Ihren Asyntai-Einbettungscode in das Feld Footer Scripts ein
- Fügen Sie in Ihrem Master-Template diesen Code vor
</body>hinzu:@Html.Raw(Model.Value("footerScripts")) - Speichern Sie sowohl den Inhalt als auch das Template
Hinweis: Die Verwendung von @Html.Raw() ist wichtig, um die Script-Tags korrekt ohne HTML-Codierung zu rendern.
Alternative: Scripts-Ordner verwenden
Sie können auch eine JavaScript-Datei im Umbraco-Backoffice erstellen:
- Gehen Sie zu Settings → Scripts
- Klicken Sie mit der rechten Maustaste auf Scripts und wählen Sie "Create"
- Create a new file called asyntai-chatbot.js
- Fügen Sie den folgenden Code hinzu:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Replace
YOUR_WIDGET_IDwith your actual widget ID - Speichern Sie die Datei
- Binden Sie dieses Skript in Ihrem Master-Template vor
</body>ein:<script src="/scripts/asyntai-chatbot.js"></script>
Alternative: Seitenspezifisch mit RenderSection
Wenn Sie den Chatbot nur auf bestimmten Seiten haben möchten:
- Fügen Sie in Ihrem Master-Template vor
</body>hinzu:@RenderSection("footerScripts", required: false) - In the specific page template where you want the chatbot, add:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Schritt 3: Installation überprüfen
Besuchen Sie nach dem Speichern Ihrer Änderungen 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 das Template nach den Änderungen gespeichert haben. Versuchen Sie, Ihren Browser-Cache zu leeren oder die Seite in einem Inkognito-Fenster aufzurufen. Wenn Sie Umbraco Cloud verwenden, sollten Änderungen automatisch bereitgestellt werden. Bei selbstgehostetem Umbraco müssen Sie möglicherweise die Anwendung neu starten oder den Cache leeren.
Weebly