> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Konfiguration

> Script-Attribute, globale Konfigurationsobjekte sowie Sprach- und Shopify-Markt-Auflösung für das homie-Embed.

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.

```html theme={null}
<script
  src="https://cdn.yourhomie.ai/embed.min.js"
  chatbotId="YOUR-CHATBOT-ID"
  defer
></script>
```

Plattformspezifisches Setup findest du in der [Installations-Übersicht](/de/user-guide/installation/overview).

## Script-Attribute

Setze diese direkt am `<script>`-Tag.

| Attribut    | Erforderlich | Beschreibung                                                                                            |
| ----------- | ------------ | ------------------------------------------------------------------------------------------------------- |
| `chatbotId` | Ja           | Die eindeutige ID deines Chatbots. Ohne sie lädt das Embed nicht.                                       |
| `domain`    | Nein         | Der Origin des Chat-Hosts. Standard: `https://chat.yourhomie.ai` — musst du normalerweise nicht setzen. |
| `storeId`   | Nein         | Store-Kennung, die an den Chat weitergegeben wird (für store-spezifische Kataloge).                     |
| `platform`  | Nein         | Auf `shopify` setzen, um Shopify-Warenkorb-Integration und Storefront-Markterkennung zu aktivieren.     |
| `lang`      | Nein         | Eine Sprache erzwingen (z. B. `de`). Überschreibt die automatische Erkennung.                           |
| `country`   | Nein         | ISO-3166-1-alpha-2-Ländercode für steuerkorrekte Preise.                                                |
| `currency`  | Nein         | ISO-4217-Währungscode für steuerkorrekte Preise.                                                        |

## 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.

```html theme={null}
<script>
  window.homieBotConfig = {
    chatbotId: 'YOUR-CHATBOT-ID',
    storeId: 'your-store-id',
    platform: 'shopify',
    lang: 'de',
    country: 'DE',
    currency: 'EUR',
  };
</script>
<script src="https://cdn.yourhomie.ai/embed.min.js" defer></script>
```

<ParamField path="chatbotId" type="string">
  Die eindeutige ID deines Chatbots. Wird genutzt, wenn kein `chatbotId`-Script-Attribut vorhanden ist.
</ParamField>

<ParamField path="domain" type="string" default="https://chat.yourhomie.ai">
  Der Origin des Chat-Hosts.
</ParamField>

<ParamField path="storeId" type="string">
  Store-Kennung, die an den Chat weitergegeben wird.
</ParamField>

<ParamField path="platform" type="'shopify' | null">
  Auf `shopify` setzen, um Shopify-Warenkorb- und Markt-Integration zu aktivieren.
</ParamField>

<ParamField path="lang" type="string">
  Erzwingt einen Sprachcode und überschreibt die automatische Erkennung.
</ParamField>

<ParamField path="country" type="string">
  ISO-3166-1-alpha-2-Ländercode für steuerkorrekte Preise.
</ParamField>

<ParamField path="currency" type="string">
  ISO-4217-Währungscode für steuerkorrekte Preise.
</ParamField>

<Info>
  Script-Attribute haben Vorrang vor `window.homieBotConfig`. Das Embed schreibt die aufgelösten Werte nach dem Laden
  außerdem zurück in `window.homieBotConfig`.
</Info>

## 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.

```html theme={null}
<script>
  window.homieUserConfig = {
    user_id: 'user-123',
    user_hash: 'hmac-signature',
    user_metadata: { plan: 'pro', segment: 'returning' },
  };
</script>
<script src="https://cdn.yourhomie.ai/embed.min.js" defer></script>
```

<ParamField path="user_id" type="string">
  Eine stabile Kennung für den aktuellen Besucher.
</ParamField>

<ParamField path="user_hash" type="string">
  Ein servergenerierter Verifizierungs-Hash für die `user_id`.
</ParamField>

<ParamField path="user_metadata" type="Record<string, unknown>">
  Beliebige Schlüssel-Wert-Daten. Das Embed kodiert sie Base64, bevor es sie an das Iframe weitergibt.
</ParamField>

## Sprach-Auflösung

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

<Steps>
  <Step title="Script-Attribut oder Config">
    Ein `lang`-Script-Attribut, ansonsten `homieBotConfig.lang`.
  </Step>

  <Step title="HTML lang">
    Das `lang`-Attribut am `<html>`-Element der Seite.
  </Step>

  <Step title="URL-Pfad">
    Ein Locale-Segment im aktuellen URL-Pfad.
  </Step>

  <Step title="Chatbot-Standard">
    Die im Chatbot konfigurierte Standardsprache. Ist das aufgelöste Locale nicht in den aktiven Übersetzungen des Chatbots, wird der Standard verwendet.
  </Step>
</Steps>

## 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:

<Steps>
  <Step title="Expliziter Override">
    Ein `country`- / `currency`-Script-Attribut, ansonsten `homieBotConfig.country` / `homieBotConfig.currency`.
  </Step>

  <Step title="Shopify-Storefront-Globals">
    Ansonsten `window.Shopify.country` und `window.Shopify.currency.active`, die Liquid-Theme-Shopify-Shops bereitstellen.
  </Step>
</Steps>

<Note>
  Die Markterkennung über `window.Shopify` gilt nur, wenn `platform` auf `shopify` gesetzt ist. Auf Nicht-Shopify-Seiten
  werden nur explizite `country`- / `currency`-Werte weitergegeben.
</Note>