# Chat per iframe einbetten oder direkt verlinken

> Zeig deinen intoCHAT-Agenten per iframe direkt in einer Seite statt als schwebende Bubble, oder teile seinen Direktlink per E-Mail, Social Media oder QR-Code.

Neben dem schwebenden Launcher kannst du jeden Agenten per iframe direkt in einer Seite zeigen oder über einen Direktlink auf einer eigenen Seite öffnen. Beides findest du im Tab **Share** (Teilen), mit deiner Agenten-ID bereits ausgefüllt.

## iframe in der Seite

Klicke auf der Karte **Iframe Embed** auf **Copy Code**. Die Karte zeigt auch eine Vorschau.

```html
<iframe
  src="https://www.intochat.ai/agent/YOUR_AGENT_ID"
  width="100%"
  height="600px"
  frameborder="0"
></iframe>
```

Füge den Code dort ein, wo der Chat erscheinen soll, etwa auf einer Hilfe- oder Kontaktseite. Der Chat erscheint genau dort, wo du das iframe platzierst.

So verhält sich der eingebettete Chat:

- Der Chat ist immer offen. Es gibt keinen Launcher und keinen Tooltip.
- Er füllt das iframe aus. Passe `width` und `height` an dein Layout an. Die Kopfzeile ist 60 Pixel hoch, das Eingabefeld sitzt unten.
- Deine Einstellungen aus [Appearance](/de/docs/appearance) gelten: Theme, Schrift, Ecken, Farben von Kopfzeile und Nachrichten, Avatar, Begrüßungen, Fragevorschläge, Fußzeile und der Hinweis „Powered by intoCHAT“. Die Launcher-Farbe färbt weiterhin den Senden-Button. Begrüßungs-Pop-up und automatisches Öffnen gelten hier nicht.
- Die Kopfzeile hat keinen Schließen-Button. Den gibt es nur im Chatfenster, das sich über den Launcher des Script-Tags öffnet.

> Clientseitige Aktionen brauchen das Script-Tag, weil ihre Handler über `embed.js` auf deiner Seite laufen. Im iframe wartet der Agent auf eine Antwort deiner Seite, und die Aktion schlägt nach 20 Sekunden fehl. Nutzt dein Agent [clientseitige Aktionen](/de/docs/client-actions), binde ihn per [Script-Tag](/de/docs/script-tag) ein.

## Direktlink

Klicke auf der Karte **Direct Chat URL** auf **Copy URL** oder auf **Open Chat**, um ihn in einem neuen Tab zu öffnen.

```text
https://www.intochat.ai/agent/YOUR_AGENT_ID
```

Der Link öffnet eine ganze Seite mit dem Chat und deinen Einstellungen aus Appearance. Wie das iframe hat sie keinen Schließen-Button. Typische Einsätze:

- Per E-Mail, in Social-Media-Beiträgen oder im Newsletter teilen.
- Als QR-Code für Drucksachen oder die Ladentheke.
- Hinter einem Button „Chatte mit uns“ auf einer Website, auf der du keine Scripts einfügen kannst.
- Den Agenten vor der Installation in einem eigenen Fenster testen.
- In der Web-View einer mobilen App öffnen.

## Was passt wofür

| | Script-Tag | iframe | Direktlink |
|---|---|---|---|
| Erscheint als | Launcher auf jeder Seite | Box in einer Seite | Eigene Seite |
| Zugriff auf deine Website nötig | Ja | Ja | Nein |
| Launcher, Tooltip, Position | Ja | Nein | Nein |
| Begrüßungs-Pop-up und automatisches Öffnen | Ja | Nein | Nein |
| Schließen-Button | Ja | Nein | Nein |
| Clientseitige Aktionen | Ja | Nein | Nein |
| Speichert die Seite, auf der der Chat begann | Ja | Nein | Nein |

Alle drei nutzen denselben Agenten und dasselbe Wissen. Gespräche erscheinen unter **Conversations**, Leads unter **Leads**, und Nachrichten zählen auf deinen Plan genauso wie im Launcher.

## Gut zu wissen

- Der Link nutzt immer die Adresse intochat.ai.
- Jeder mit dem Link kann mit dem Agenten chatten. Standardmäßig kann jede Website das iframe einbetten. Mit [erlaubten Domains](/de/docs/allowed-domains) beschränkst du es auf deine eigenen Websites, der Link funktioniert dann weiter. Machst du den Agenten privat, funktionieren weder der Link noch Einbettungen.
- Trainiere einen öffentlichen Agenten nur mit Inhalten, die öffentlich sein dürfen.
- Änderungen im Tab **Appearance** gelten beim nächsten Laden der Seite oder des iframes. Neuer Einbettungscode ist nicht nötig.

Den schwebenden Launcher bindest du über das [Script-Tag](/de/docs/script-tag) ein.