KI-Chat-Agent für Ihre Bubble-App
Hazelchat beantwortet Fragen Ihrer Besucher aus den Seiten und Dokumenten, die Sie freigegeben haben, und zeigt unter jeder Antwort die Quellen. Ein kostenloses Plugin bringt den Chat auf jede Seite Ihrer Bubble-App, ohne HTML-Element und ohne Code.
Version 1.0.0 für Bubble-Web-Apps. Der Free-Tarif enthält 50 Antworten im Monat für eine Website, ohne Karte, und bleibt kostenlos.
Wir haben das Plugin am 23. Oktober 2026 in unserer eigenen Bubble-Test-App im Free-Tarif ausprobiert: Ein Button öffnete den Chat, er beantwortete eine Frage mit ihrer Quelle, und ein zweiter Button schloss ihn. In der App einer Bubble-Kundschaft haben wir es noch nicht getestet. Sieht eine Bubble-Ansicht anders aus, gilt Bubbles eigene Hilfe.
Was Sie brauchen
- Eine Bubble-Web-App, die Sie bearbeiten können. Das Plugin funktioniert in jedem Bubble-Tarif; im kostenlosen Tarif läuft Ihre App nur als Testversion, Live braucht einen bezahlten Bubble-Tarif.
- Die Adresse, die Ihre Besucher nutzen: Ihre eigene Domain oder die
bubbleapps.io-Adresse Ihrer App. - Ein Hazelchat-Konto. Das Plugin braucht den gehosteten Hazelchat-Dienst; der Free-Tarif enthält 50 Antworten im Monat für eine Website, ohne Karte.
Hazelchat in fünf Schritten zu Bubble hinzufügen
-
In Hazelchat
Agenten vorbereiten
Fügen Sie Ihre Inhalte hinzu, prüfen Sie die Angaben und probieren Sie Ihren Agenten aus. Tragen Sie unter Website → Auf Ihrer Website installieren die Adresse Ihrer App ein und kopieren Sie Ihren öffentlichen Widget-Schlüssel. Er ist kein Passwort.
-
In Bubble
Plugin installieren
Öffnen Sie im Editor Ihrer App den Tab Plugins, klicken Sie auf Add plugins, suchen Sie nach Hazelchat und klicken Sie auf Install. Im Plugin-Marktplatz von Bubble heißt es Hazelchat AI Chat Agent.
-
In Bubble
Schlüssel einfügen
Fügen Sie den Schlüssel in den Einstellungen des Hazelchat-Plugins in Public widget key ein. Lassen Sie Wait for consent leer, es sei denn, Ihr Cookie-Banner muss den Chat zuerst erlauben.
-
In Bubble
Vorschau oder Deploy
Klicken Sie auf Preview, um es in der Testversion Ihrer App auszuprobieren, oder veröffentlichen Sie mit Deploy auf Live. Entfernen Sie ein Hazelchat-Skript, das Sie früher in den Seiten-Header eingefügt haben, damit der Chat nur einmal lädt.
-
In Ihrer App
Einschalten und testen
Klicken Sie in Hazelchat auf Veröffentlichen und einschalten (oder Einschalten, wenn Ihr veröffentlichter Agent unverändert ist). Hazelchat prüft, ob das Skript in Ihrer App ist, bevor der Agent live geht. Für eine Testversion nennen Sie deren Seite, zum Beispiel
https://ihre-app.bubbleapps.io/version-test. Stellen Sie dann im Chat eine Frage, kehren Sie zu Hazelchat zurück und klicken Sie auf Ja, ich habe diese Antwort gesehen.
Was das Plugin macht
Es fügt den Seiten Ihrer App ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.
Das Plugin fügt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel in den Header jeder Seite Ihrer App ein. Ohne gültigen Schlüssel startet das Skript nichts. Das Plugin hält nur diesen Schlüssel und eine Einwilligungs-Einstellung, liest keine Datentypen, Benutzer oder Workflows Ihrer App und sendet nichts von Bubble an Hazelchat. Aussehen, Texte und Begrüßungen des Chats kommen aus Ihrem Hazelchat-Arbeitsbereich.
Den Chat per Workflow öffnen
Der Chat hat seinen eigenen Button in der Ecke. Um ihn auch über Ihren eigenen Button zu öffnen, fügen Sie eine Workflow-Aktion hinzu:
Hazelchat – Open chat
Öffnet den Chat. Eine optionale Frage wird gesendet, wenn ein Klick des Besuchers den Workflow gestartet hat, sonst ins Eingabefeld des Chats gesetzt.
Hazelchat – Close chat
Schließt den Chat.
Hazelchat status
Ein Element mit den Zuständen Chat is ready, Chat is open und Problem sowie Events für geöffnet, geschlossen, bereit und Problem.
Einwilligung der Besucher
Wenn Ihr Consent-Tool einen Dienst namens Hazelchat führt, folgt der Chat ihm von selbst; siehe Cookie-Banner. Wenn Ihr eigenes Banner den Chat zuerst erlauben muss, tragen Sie true in Wait for consent ein. Der Chat bleibt dann geschlossen und sendet keine Chat-Anfragen, bis ein Workflow Hazelchat – Visitor consent mit yes ausführt. Führen Sie die Aktion mit no aus, wenn ein Besucher seine Einwilligung widerruft.
Wenn der Chat nicht erscheint
Schlüssel prüfen
Fügen Sie nur den 64-stelligen öffentlichen Widget-Schlüssel ein, ohne Leerzeichen. Alles andere zeigt nichts.
Live- und Test-Schlüssel
Bubble hält für Ihre Testversion einen eigenen Wert. Fügen Sie den Schlüssel in beide Felder ein, wenn das Plugin zwei zeigt.
Erneut veröffentlichen
Plugin-Einstellungen erreichen Live erst mit dem nächsten Deploy.
Eine zweite Domain
Der Free-Tarif bedient eine Website. Eine
bubbleapps.io-Adresse und Ihre eigene Domain sind zwei Websites.
Ändern oder entfernen
Neuer Widget-Schlüssel
Wenn Sie den Schlüssel in Hazelchat erneuern, fügen Sie den neuen in die Plugin-Einstellungen ein und veröffentlichen Sie erneut.
Chat pausieren
Schalten Sie Hazelchat in Ihrem Arbeitsbereich aus. Er antwortet sofort nicht mehr.
Aus der App entfernen
Deinstallieren Sie das Plugin im Tab Plugins, entfernen Sie seine Workflow-Aktionen und veröffentlichen Sie erneut. Ihr Hazelchat-Konto und Ihr Tarif bleiben unberührt.
Updates und Änderungen
Bubble zeigt neue Plugin-Versionen im Tab Plugins, und Sie entscheiden, wann Sie aktualisieren. Der Chat selbst ist das gehostete Skript von Hazelchat, das Hazelchat ohne Plugin-Update aktualisieren kann.
1.0.0 (20. Oktober 2026): bringt den Hazelchat-Chat mit einem Schlüssel auf jede Seite; Aktionen Open chat, Close chat und Visitor consent; das Element Hazelchat status.
Hazelchat ist nicht mit Bubble Group, Inc. verbunden und wird nicht von ihr unterstützt. Bubble ist eine Marke von Bubble Group, Inc. und wird hier nur genannt, um zu sagen, mit welcher Plattform das Plugin funktioniert.
Lassen Sie Ihre Bubble-App aus ihren eigenen Seiten antworten.
Fragen? Schreiben Sie an hello@hazelchat.co. Wir antworten innerhalb eines Werktags. Nicht auf Bubble? Hier sind alle Wege, Hazelchat zu installieren, und alles zu Cookie-Bannern.