Zum Hauptinhalt springen
Du konfigurierst das homie-Embed auf zwei Arten: über Attribute am <script>-Tag oder über globale Konfigurationsobjekte, die du vor dem Laden des Skripts auf window setzt. Setze mindestens chatbotId. Styling und Verhalten werden in der homie Plattform verwaltet und automatisch geladen.
Plattformspezifisches Setup findest du in der Installations-Übersicht.

​
Script-Attribute

Setze diese direkt am <script>-Tag.

​
window.homieBotConfig

Als Alternative zu Script-Attributen kannst du window.homieBotConfig vor dem Laden des Embed-Skripts setzen. Das ist nützlich, wenn dein CMS oder Tag-Manager Globals leichter setzt als Attribute.
​
chatbotId
string
Die eindeutige ID deines Chatbots. Wird genutzt, wenn kein chatbotId-Script-Attribut vorhanden ist.
​
domain
string
Standard:"https://chat.yourhomie.ai"
Der Origin des Chat-Hosts.
​
storeId
string
Store-Kennung, die an den Chat weitergegeben wird.
​
platform
'shopify' | null
Auf shopify setzen, um Shopify-Warenkorb- und Markt-Integration zu aktivieren.
​
lang
string
Erzwingt einen Sprachcode und überschreibt die automatische Erkennung.
​
country
string
ISO-3166-1-alpha-2-Ländercode für steuerkorrekte Preise.
​
currency
string
ISO-4217-Währungscode für steuerkorrekte Preise.
Script-Attribute haben Vorrang vor window.homieBotConfig. Das Embed schreibt die aufgelösten Werte nach dem Laden außerdem zurück in window.homieBotConfig.

​
window.homieUserConfig

Setze window.homieUserConfig vor dem Laden des Embeds, um eine Identität und beliebige Metadaten an das Chat-Iframe weiterzugeben. Das ist eine fortgeschrittene Option, um Konversationen einem bekannten Besucher zuzuordnen.
​
user_id
string
Eine stabile Kennung für den aktuellen Besucher.
​
user_hash
string
Ein servergenerierter Verifizierungs-Hash für die user_id.
​
user_metadata
Record<string, unknown>
Beliebige Schlüssel-Wert-Daten. Das Embed kodiert sie Base64, bevor es sie an das Iframe weitergibt.

​
Sprach-Auflösung

Die effektive Sprache wird aus dem ersten verfügbaren Signal aufgelöst:
1

Script-Attribut oder Config

Ein lang-Script-Attribut, ansonsten homieBotConfig.lang.
2

HTML lang

Das lang-Attribut am <html>-Element der Seite.
3

URL-Pfad

Ein Locale-Segment im aktuellen URL-Pfad.
4

Chatbot-Standard

Die im Chatbot konfigurierte Standardsprache. Ist das aufgelöste Locale nicht in den aktiven Übersetzungen des Chatbots, wird der Standard verwendet.

​
Shopify-Markt-Auflösung

Wenn platform auf shopify steht, gibt das Embed country und currency des aktiven Markts des Besuchers für steuerkorrekte Preise weiter. Der Wert wird aufgelöst aus:
1

Expliziter Override

Ein country- / currency-Script-Attribut, ansonsten homieBotConfig.country / homieBotConfig.currency.
2

Shopify-Storefront-Globals

Ansonsten window.Shopify.country und window.Shopify.currency.active, die Liquid-Theme-Shopify-Shops bereitstellen.
Die Markterkennung über window.Shopify gilt nur, wenn platform auf shopify gesetzt ist. Auf Nicht-Shopify-Seiten werden nur explizite country- / currency-Werte weitergegeben.