embent

Installationsanleitungen / HTML & benutzerdefinierte Websites

Embent auf jeder HTML-Website installieren

Ein Script-Tag, kein Build-Schritt, kein Framework. Wenn du dein HTML bearbeiten kannst, bist du in unter einer Minute fertig.

Bevor du startest

  • Zugriff, um die HTML-Dateien oder Templates deiner Website zu bearbeiten.

Schritte

1

Kopier deinen Embed-Schnipsel

In deinem Embent-Dashboard öffne die Übersicht deines Bots und kopier den Embed-Schnipsel. Er sieht so aus:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>
2

Vor dem schließenden </body>-Tag einfügen

Öffne die Datei oder das Template, das jede Seite rendert — bei den meisten statischen Websites ist das ein gemeinsames Layout oder Footer-Include — und füg den Schnipsel direkt vor dem schließenden </body>-Tag ein.

3

Deine Änderungen veröffentlichen

Lad die bearbeitete Datei hoch oder deploy sie so, wie du deine Website normalerweise veröffentlichst.

Überprüfen, ob es funktioniert hat

Lad deine Website neu: Die Chat-Blase erscheint in der Ecke. Stell ihr eine Frage zu deinen eigenen Seiten, und sie sollte mit einer Quellenangabe antworten.

Wenn es nicht funktioniert

Ausprobiert, und das Widget zeigt sich nicht? Das hier löst fast jeden Fall.

Ich habe den Embed-Code hinzugefügt, aber das Widget erscheint nicht — keine Chat-Blase, kein Launcher, gar nichts zeigt sich auf meiner WebsiteVier Prüfungen lösen fast jeden Fall von „Widget wird nicht angezeigt“. Erstens: Öffne deine Live-Website, sieh dir den Seitenquelltext an (Rechtsklick → Seitenquelltext anzeigen) und such nach „embent“ — steht das Skript nicht dort, wurde der Code nicht auf einer veröffentlichten Seite gespeichert. Zweitens: Stell sicher, dass die data-bot-ID in deinem Snippet mit der in deinem Dashboard unter Einstellungen angezeigten übereinstimmt. Drittens: Leer den Seiten-Cache deiner Website und jeden CDN-Cache — eine gecachte Seite liefert weiter die alte Version ohne Widget. Viertens: Prüf, ob der Bot im Dashboard nicht pausiert ist: Ein pausierter Bot zeigt Besuchern absichtlich nichts an.
Die Chat-Blase erscheint, aber Antworten kommen nie an, oder das Widget fehlt und meine Website setzt eine Content-Security-PolicyFüg https://api.embent.com sowohl zu script-src (lädt das Widget-Skript) als auch zu connect-src hinzu (der Chat-Antwort-Stream verbindet sich zurück zum selben Origin). Ein fehlender script-src-Eintrag versteckt das Widget komplett; ein fehlender connect-src-Eintrag zeigt die Blase, aber keine Antwort streamt jemals herein.
Ich nutze Cloudflare mit Rocket Loader, und das Widget ist instabil oder fehltRocket Loader verzögert Skripte über seinen eigenen Loader. Das Widget ist darauf ausgelegt, das zu überstehen, aber falls es nicht erscheint, füg data-cfasync="false" zum Embent-Script-Tag hinzu — Rocket Loaders offizielles Opt-out — und das Skript lädt normal.

Häufige Fragen

Funktioniert es mit React, Vue, Next.js oder anderen Frameworks?Ja. Füg den Schnipsel einmal in das Root-HTML-Template ein — index.html oder dein Root-Layout. Das Widget rendert in einem Shadow DOM und bleibt deinem Framework nicht im Weg; keine Wrapper-Komponente nötig.
Verlangsamt es meine Website?Nein. Das Skript lädt asynchron, und das Widget ist unter 50 KB gzip ohne eigenes Framework, sodass es das Rendern deiner Seite nie blockiert.
Muss ich es zu jeder Seite hinzufügen?Nur zu Templates, die über Seiten hinweg geteilt werden. Eine Seite, die das gemeinsame Layout überspringt, braucht den Schnipsel separat.
Richte Embent jetzt auf deine Website aus.Ein KI-Agent, der lieber „Ich weiß es nicht“ sagt, als sich etwas auszudenken. Kostenloser Plan, keine Kreditkarte nötig — die meisten Websites antworten innerhalb von zwei Minuten.

Die Chat-Blase in der Ecke ist Embent selbst, live auf dieser Seite — frag sie alles über uns.