Chatbot-WidgetsBeta
Einen gebrandeten Chatbot erstellen und mit einem einzigen Script-Tag auf der eigenen Website einbetten
Diese Funktion ist in der Beta-Phase. Sie ist nutzbar, einzelne Details können sich aber noch ändern.
Ein Chatbot-Widget ist eine gebrandete Assistenz, die Sie in DeutschlandGPT erstellen und auf jeder Ihrer eigenen Websites einbetten. Besucher chatten mit ihr in einem kleinen Panel; Sie steuern Aussehen, das antwortende Modell, das Wissen, wer es einbetten darf und wie viel es kosten darf.
Öffnen Sie Chatbot-Widgets, um Ihre Widgets zu erstellen und zu verwalten. Dieses Produkt steht Organisationen zur Verfügung (nicht persönlichen Konten).
Chatbot-Widgets sind eine Beta-Funktion und nicht standardmäßig aktiv. Solange sie nicht freigeschaltet sind, fehlt der Eintrag „Chatbot-Widgets“ im Produktwechsler der Seitenleiste und der Link oben endet auf einer 404-Seite — das ist kein Fehler.
Vertraglich betreute Organisationen schalten sie selbst frei, unter Einstellungen → Organisation → Allgemein → Beta-Funktionen: Mit der Teilnahme am Beta-Tester-Programm erhalten Sie Zugang zu Funktionen, die sich noch in der Testphase befinden — darunter das einbettbare Chatbot-Widget. Business-Organisationen haben diesen Bereich nicht; dort nimmt der Support die Freischaltung vor.
Anschließend vergibt Ihr Administrator in den Rollen die Berechtigung „Chatbot-Widgets nutzen“.
Erstellen & Konfigurieren
Jedes Widget wird über mehrere Tabs im Builder konfiguriert. Jede Änderung wird automatisch als Entwurf gespeichert — Entwurfsänderungen sind für Besucher erst sichtbar, wenn Sie veröffentlichen (siehe unten).
- Identität — Name, Markenfarbe, Launcher-Symbol (eines der mitgelieferten Symbole oder Ihr eigenes Logo als PNG/JPEG/WEBP), Begrüßungsnachricht und Starter-Prompts (Vorschlagsfragen, die beim Öffnen des Chats angezeigt werden).
- Gehirn — das Modell, das Antworten generiert, sowie der System-Prompt: verborgene Anweisungen, die Rolle, Ton und Grenzen des Bots prägen. Besucher sehen den System-Prompt nie.
- Verhalten — Spracheingabe, Transkriptspeicherung und (wenn die Speicherung aktiv ist) der Datenschutzhinweis.
- Wissen — Dokumente, aus denen der Bot antworten kann (siehe unten).
- Sicherheit & Limits — die Domain-Erlaubnisliste, Ratenlimits und das monatliche Budgetlimit.
- Veröffentlichen & Versionen — Veröffentlichung und Rollback.
- Installieren — der Einbettungs-Snippet und eine Live-Vorschau.
- Analysen — Nutzung, Kosten und die häufigsten Fragen.
Wissen (RAG)
Laden Sie auf dem Tab Wissen Dokumente hoch und aktivieren Sie Wissensabruf (RAG). Der Bot durchsucht dann beim Antworten Ihre Dokumente und nutzt das Gefundene, um seine Antwort zu fundieren — dem Besucher als kurzer „Wissen wird durchsucht"-Schritt (ein Tool-Aufruf) über der Antwort angezeigt.
Uploads werden im Hintergrund verarbeitet: Jedes Dokument durchläuft Extraktion und Embedding, bis es Bereit ist. Ein Dokument ohne extrahierbaren Text zeigt Bereit (leer). Dokumente bleiben privat für das Widget, in das Sie sie hochgeladen haben.
Sprache
Aktivieren Sie Spracheingabe im Tab Verhalten, damit Besucher ihre Nachrichten sprechen statt tippen können. Sprache wird wie Text abgerechnet (siehe Abrechnung).
Veröffentlichen & Versionierung
Ein Widget geht erst live, wenn Sie es veröffentlichen. Beim Veröffentlichen wird ein Schnappschuss Ihres aktuellen Entwurfs erstellt und in eine unveränderliche Version eingefroren. Das eingebettete Widget liefert immer die veröffentlichte Version aus — nie Ihren laufenden Entwurf — sodass Sie gefahrlos weiterbearbeiten können.
Um eine Änderung rückgängig zu machen, öffnen Sie Veröffentlichen & Versionen und stellen Sie eine frühere Version über Wiederherstellen wieder her. Ihr aktueller Entwurf bleibt erhalten und ist von einem Rollback nicht betroffen.
Einbetten
Öffnen Sie nach der Veröffentlichung den Tab Installieren und kopieren Sie den Einbettungs-Snippet. Fügen Sie ihn direkt vor dem schließenden </body>-Tag auf jeder Seite ein, auf der das Widget erscheinen soll.
Der Snippet ist ein einzelnes <script>-Tag, das auf eine exakte, eingefrorene Loader-Version mit einem Subresource-Integrity-Hash (SRI) und crossorigin="anonymous" festgelegt ist, sodass der Browser die Script-Bytes vor der Ausführung prüft. Der Loader fügt einen isolierten iFrame ein, der den Chat hostet. Der Tab Installieren zeigt außerdem eine Live-Vorschau — genau das, was Ihre Besucher sehen.
Domain-Erlaubnisliste
Listen Sie auf dem Tab Sicherheit & Limits die Domains auf, die das Widget einbetten dürfen. Dies wird vom Browser durchgesetzt (über frame-ancestors) und kann daher nicht gefälscht werden.
- Nur die von Ihnen aufgeführten Domains dürfen das Widget einbetten.
- Ist die Erlaubnisliste leer, kann niemand es einbetten — das ist absichtlich ausfallsicher.
- Fügen Sie
www- und Apex-Varianten als separate Einträge hinzu, wenn Sie beide verwenden.
Schreibweise der Einträge
Sie können eine Adresse mit oder ohne https:// eintragen — beides funktioniert, Pfade werden automatisch entfernt:
| Eintrag | Wirkung |
|---|---|
example.com | gilt für http und https (empfohlen) |
https://example.com | nur https |
*.example.com | alle Subdomains (nicht die Apex-Domain selbst) |
localhost:3000 | lokale Tests — mit Port, so wie er in der Adresszeile steht |
Änderungen an der Erlaubnisliste wirken sofort; ein erneutes Veröffentlichen ist nicht nötig.
Seiten ohne Domain (file://)
Eine direkt von der Festplatte geöffnete HTML-Datei und Sandbox-iFrames haben den Origin null, der sich per frame-ancestors grundsätzlich nicht freigeben lässt. Testen Sie stattdessen über http://localhost — oder aktivieren Sie Null-Origin erlauben; dann kann das Widget allerdings von jeder Seite eingebettet werden.
Wenn nichts erscheint
Der Loader erkennt auf Ihrer Website selbst, wenn der Chat blockiert wurde: Er zeigt an Ort und Stelle an, welche Domain fehlt, und meldet es zurück. Im Tab Einbinden sehen Sie die betroffenen Domains und können sie mit einem Klick freigeben.
Ratenlimits & monatliches Budgetlimit
Zwei Kontrollen begrenzen Missbrauch und Kosten, beide auf dem Tab Sicherheit & Limits:
- Ratenlimits begrenzen, wie viele Nachrichten in einem Zeitfenster gesendet werden dürfen. Pro-IP-Limits (pro Minute, pro Tag) sind ein Best-Effort — Besucher können IPs wechseln — daher sind das Widget-weite Tageslimit und das Budgetlimit die eigentlichen Schutzgrenzen.
- Monatliches Budgetlimit ist eine Best-Effort-Monatsobergrenze. Sobald die Ausgaben dieses Monats erreicht sind, pausiert das Widget automatisch und Besuchern wird eine freundliche „Nicht verfügbar"-Meldung angezeigt. Da die Kosten erst nach Abschluss jeder Antwort bekannt sind, können einige laufende Nachrichten das Limit geringfügig überschreiten. Leer lassen für kein Limit.
Es gibt außerdem ein Limit für die maximale Anzahl an Nachrichten pro Konversation; bei Erreichen wird der Besucher gebeten, eine neue Konversation zu starten.
Transkripte & Datenschutz
Die Transkriptspeicherung ist standardmäßig deaktiviert. Wenn Sie Transkripte speichern im Tab Verhalten aktivieren:
- Wird ein Datenschutzhinweis erforderlich — ohne ihn können Sie nicht veröffentlichen.
- Sehen Besucher eine Einwilligungsabfrage und müssen zustimmen, bevor eine Konversation gespeichert wird.
- Löst die Speicherung personenbezogener Daten DSGVO-Pflichten aus: Informieren Sie Besucher über den Hinweis und stellen Sie eine Rechtsgrundlage sicher.
- Gespeicherte Transkripte werden für einen begrenzten Zeitraum aufbewahrt und danach automatisch gelöscht.
Bei deaktivierter Speicherung werden nur anonyme Aggregate (für Analysen) behalten — keine Nachrichteninhalte.
Analysen
Der Tab Analysen zeigt Konversationen, Nachrichten und Kosten über einen wählbaren Zeitraum, ein Nutzungsdiagramm sowie die häufigsten Besucherfragen. Die hier angezeigten Kosten entsprechen den abgerechneten Kosten.
Abrechnung
Chatbot-Widgets werden nutzungsbasiert (pay-as-you-go) über Ihr Workspace-Guthaben abgerechnet. Widget-Chat und -Sprache werden zum üblichen Pay-as-you-go-Chat-Tarif abgerechnet (etwa ein Aufschlag von 1,15× auf die reinen Modellkosten), konsistent mit dem eingebetteten Chat an anderer Stelle im Produkt. Das monatliche Budgetlimit und die Ratenlimits sind Ihre Werkzeuge, um diese Ausgaben planbar zu halten.