Zum Hauptinhalt springen
Die manuelle Methode ist der universelle Weg, homie AI zu installieren. Sie funktioniert auf jeder Seite, die HTML bearbeiten lässt: Füge das Embed Script auf jeder Seite vor dem schließenden </body>-Tag ein und die Chat-Bubble lädt für deine Kund:innen.
Bevor du startest, stelle sicher, dass du Folgendes hast:
  • Einen in der Plattform erstellten Assistenten
  • Dein aus dem Veröffentlichen-Bereich des Assistenten kopiertes Embed Script
  • Die Möglichkeit, das HTML deiner Seite zu bearbeiten

​
Embed Script hinzufügen

1

Embed Script kopieren

Öffne deinen Assistenten in der Plattform, gehe zu seinem Veröffentlichen-Bereich und kopiere das Script. Es enthält bereits deine chatbotId.
Veröffentlichen-Bereich in der Plattform mit dem kopierbaren Script-Snippet
2

Vor dem schließenden Body-Tag einfügen

Füge das Script auf jeder Seite deiner Website direkt vor dem schließenden </body>-Tag ein:
Ersetze YOUR-CHATBOT-ID durch deine eigene chatbotId aus der Plattform. Wenn du das Script direkt aus dem Veröffentlichen-Bereich kopierst, ist das bereits erledigt.
3

Speichern und prüfen

Speichere deine Datei und lade die Seite im Browser neu.

​
Optionale Attribute

Das Script akzeptiert optionale Attribute, um deinem Assistenten zusätzlichen Kontext zu übergeben:
Für programmatische Konfiguration, Methoden und Events siehe die Client API.
Mit dem Embed Script musst du die aktuelle Seiten-URL nicht manuell übergeben. Das Embed sendet sie automatisch an den Chat — auch wenn sich die Seite später ändert.
Lade deine Seite neu. Die homie-Chat-Bubble erscheint unten rechts. Öffne sie und sende eine Testnachricht.

​
Direkte Iframe-Einbindung

Wenn du den Chat bewusst als eigenständiges Iframe rendern willst — zum Beispiel auf Terminals, Kiosksystemen oder in einer kontrollierten App-Shell — kannst du das Embed Script überspringen und die Chat-URL direkt nutzen:
Beim direkten Iframe wird der Kontext als reguläre Query-Parameter angehängt:
Bei einer direkten Iframe-URL ist currentUrl nur der initiale Kontext. Ändert sich die Host-Seite später, musst du die Iframe-URL selbst aktualisieren. Das Embed Script erledigt das automatisch.

​
Fehlerbehebung

  • Widget nicht sichtbar? Prüfe, ob deine chatbotId mit der in der Plattform übereinstimmt, ob das Script vor dem schließenden </body>-Tag steht und ob deine Content Security Policy das Embed Script von cdn.yourhomie.ai sowie das Laden des Chats von chat.yourhomie.ai erlaubt.
  • Script oder Iframe lädt nicht? Öffne die Browser-Konsole, achte auf Netzwerk- oder Fehlermeldungen und prüfe die Domain in der URL.
  • currentUrl wird nicht erkannt? Prüfe, ob die URL encodiert übergeben wird.
  • Immer noch festgefahren? Siehe den Troubleshooting-Guide der Client API.

​
Nächste Schritte

Client API

Konfiguriere das Widget und rufe Methoden von deiner Seite auf.

Fehlerbehebung

Löse häufige Installations- und Laufzeitprobleme.