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

# Livechat verbinden

> Fügen Sie einen KI-Chat auf Ihrer Website hinzu, der Besucherinnen und Besucher automatisch beantwortet.

# Livechat verbinden

## Überblick

Mit **Livechat** fügen Sie einen KI-Chat direkt auf Ihrer Website hinzu. Besucherinnen und Besucher öffnen ein Chat-Widget in der Ecke der Seite und erhalten Antworten von einem Ihrer AI Assistenten - rund um die Uhr, ohne dass jemand mitlesen muss.

In Placetel erstellen Sie dazu ein **Widget**, weisen ihm einen Assistenten zu, gestalten sein Aussehen und binden ein kurzes Skript auf Ihrer Website ein.

## Voraussetzungen

* Ein eingerichteter **Chat-Assistent**, der die Nachrichten beantworten soll.
* **Zugriff auf den HTML-Code Ihrer Website**, um das Einbindungs-Skript zu ergänzen.

<Info>
  Sie haben noch keinen Chat-Assistenten? Unter **AI Assistenten → Übersicht → Erstellen → Chat-Assistent** können Sie einen anlegen. Die Anleitung [AI-Assistenten erstellen und einrichten](/docs/de/agent-setup) erklärt die ersten Schritte. Ohne zugewiesenen Assistenten bleibt das Widget inaktiv.
</Info>

## Widget erstellen

<Steps>
  <Step title="Livechat öffnen">
    Öffnen Sie **Livechat** in der Seitenleiste.
  </Step>

  <Step title="Widget erstellen">
    Klicken Sie auf **Widget erstellen**.
  </Step>

  <Step title="Namen vergeben">
    Geben Sie dem Widget einen Namen, um es später wiederzuerkennen (z. B. „Support-Website").
  </Step>
</Steps>

## Chat-Assistenten zuweisen

Wählen Sie den Chat-Assistenten aus, der Besucherinnen und Besuchern auf Ihrer Website antworten soll. Im Auswahlfeld werden nur Chat-Assistenten angezeigt, keine Voice-Assistenten. Die Zuweisung wird sofort wirksam.

<Warning>
  Das Widget ist erst aktiv, wenn ein Assistent zugewiesen wurde.
</Warning>

## Widget gestalten

Passen Sie das Erscheinungsbild an Ihre Website an. Eine Live-Vorschau zeigt Ihre Änderungen sofort.

* **Titel** - die Überschrift des Chatfensters. Die **Erste Nachricht** legen Sie im Wizard des Chat-Assistenten unter **Grundlagen** fest.
* **Akzentfarbe** - die Hauptfarbe des Widgets.
* **Position** - in welcher Ecke der Website das Widget erscheint.
* **Avatar/Icon** - das Symbol, das den Chat öffnet.
* **„Powered by"-Hinweis** - ein- oder ausblendbar.

## Erlaubte Domains

Unter **Erlaubte Domains** tragen Sie die Domains ein, auf denen das Widget erscheinen darf, zum Beispiel `https://www.ihre-domain.de`. Nur auf diesen Domains wird der Chat geladen.

<Note>
  Tragen Sie die **exakte Herkunft (Origin)** ein - inklusive `https://` und der genauen Subdomain. Staging- oder Testumgebungen fügen Sie bei Bedarf als eigene Einträge hinzu.
</Note>

## Widget einbinden

Kopieren Sie das Skript von der Widget-Seite und fügen Sie es unmittelbar vor dem schließenden `</body>`-Tag auf jeder Seite ein, auf der der Chat erscheinen soll.

```html theme={null}
<script
  src="https://app.ihre-domain/livechat/embed.js"
  data-widget-id="…"
  async>
</script>
```

<Note>
  Das Skript wird pro Seite nur einmal benötigt und ist unbedenklich einzubinden. Ändern Sie die `data-widget-id` nicht - sie verknüpft das Skript mit Ihrem Widget.
</Note>

## Testen

Testen Sie zunächst die Antworten über **Chat testen** direkt im Wizard des Chat-Assistenten. Dafür brauchen Sie noch kein Widget. Anschließend können Sie das eingebundene Widget prüfen:

<Steps>
  <Step title="Website öffnen">
    Öffnen Sie die eingerichtete Website in einem privaten Browserfenster.
  </Step>

  <Step title="Chat öffnen">
    Öffnen Sie das Chat-Widget.
  </Step>

  <Step title="Testnachricht senden">
    Senden Sie eine Testnachricht.
  </Step>

  <Step title="Antwort prüfen">
    Prüfen Sie, ob die Antwort erscheint und das Gespräch unter **Conversations** sichtbar ist.
  </Step>
</Steps>

## FAQ

**Warum wird das Widget nicht angezeigt?** Prüfen Sie, ob ein Assistent zugewiesen ist und die aktuelle Domain unter **Erlaubte Domains** eingetragen wurde.

**Kann ich ein Widget auf mehreren Domains verwenden?** Ja. Tragen Sie jede genaue Domain in die Liste der erlaubten Domains ein.

**Kann ich den Assistenten später ändern?** Ja. Die Änderung gilt sofort für neue Gespräche.

**Wo finde ich eingehende Chats?** Unter **Conversations**.

**Wie deaktiviere ich den Chat?** Entfernen Sie die Zuweisung des Assistenten oder löschen Sie das Einbindungs-Skript von Ihrer Website.