# Chat im Widget

Der Chat im Widget ist eine Unterhaltung mit Ihrem Bot direkt auf der Website. Der Besucher öffnet das Widget, schreibt eine Nachricht, und der Bot antwortet nach dem Szenario: mit Buttons, Bildern, Dateien. In einen Messenger muss er nicht wechseln.

Der Chat läuft über den Kanal „Web-Chat“ des Bots. Wie der Kanal selbst funktioniert, was der Operator sieht und wie Sie den Kanal trennen, steht auf der Seite [Web-Chat](https://support.watbot.org/de/chatbots/channels/web). Hier geht es um die Einstellungen des Chats im Widget.

## Was Sie brauchen

- **Einen Bot im selben Projekt wie das Widget.** Der Chat lässt sich nur mit einem Bot des eigenen Projekts verbinden.
- **Ein Pro-Abonnement beim Eigentümer des Bots.** Das Widget selbst braucht kein Abonnement, der Chat schon. Ohne Pro lässt sich der Chat nicht einschalten, und ist das Abonnement abgelaufen, bleibt das Widget ohne Chat auf der Website.
- **Zählung der Kontakte.** Jeder Besucher, der den Chat öffnet, wird zu einem Kontakt des Bots — wie ein Mensch, der dem Bot im Messenger geschrieben hat. Von der Zahl der Kontakte hängt der Preis von Pro ab: siehe [Der Pro-Tarif](https://support.watbot.org/de/billing/pro).

## Den Chat einschalten

1. Öffnen Sie das Widget und klicken Sie im Baukasten auf den Button mit dem Zahnrad — das Panel „Widget-Einstellungen“ öffnet sich.
2. Schalten Sie in der Zeile „Chat mit dem Bot“ die Option „Chat mit dem Bot im Widget anzeigen“ ein.
3. Wählen Sie im Feld „Bot“ einen Bot des Projekts.
4. Klicken Sie auf „Speichern“.

![Chat-Einstellungen und geöffneter Chat mit dem Bot im Widget](https://support.watbot.org/_media/de/04-widgets/_images/chat.webp?v=1791781230)

Beim Speichern verbindet die Plattform den Kanal „Web-Chat“ selbst mit dem Bot, falls er noch nicht verbunden ist. Ist das Widget bereits [auf der Website eingebunden](https://support.watbot.org/de/widgets/install), erscheint der Chat darin, ohne dass Sie an der Website etwas ändern.

Mit eingeschaltetem Chat braucht das Widget keine Links: Es kann auch nur den Chat enthalten.

## Einstellungen des Chats

| Einstellung | Was sie festlegt |
|---|---|
| „Bot“ | Mit welchem Bot des Projekts der Besucher schreibt |
| „Chat-Titel“ | Zeile im Kopf des Chats, bis zu 50 Zeichen. Leer — der Name des Bots. Daneben wird der Avatar des Bots angezeigt |
| „Beschriftung der Schaltfläche“ | Zeile des Chats in der Liste der Kontaktwege, bis zu 50 Zeichen. Leer — „Chat starten“ |
| „Platzhalter im Eingabefeld“ | Grauer Text im leeren Eingabefeld, bis zu 100 Zeichen. Leer — „Nachricht schreiben…“ |
| „Wie öffnen“ | Modus des Chats — siehe unten |
| „Dateien von Besuchern annehmen“ | Ob der Besucher Dateien senden darf |
| „Neue Besucher pro IP und Stunde“ | Schutz vor künstlich erzeugten Kontakten. Das Feld steht als letztes im Panel |

Unter den Einstellungen steht die Zeile „Besucher, die über diesen Chat geschrieben haben: …“ mit der Zahl der Kontakte, die über dieses Widget gekommen sind, und der Link „Unterhaltungen öffnen“: Er führt in den Bereich „Nachrichten“ des Bots.

### Modi: „Wie öffnen“

| Modus | Wie es auf der Website aussieht |
|---|---|
| „Als Schaltfläche in der Kanalliste“ | Das Widget öffnet sich als Liste: in der ersten Zeile der Chat, darunter Ihre Links. Der Chat öffnet sich beim Klick auf die Zeile |
| „Sofort als Chat“ | Das Widget öffnet sich direkt mit der Unterhaltung. Der Pfeil „Zurück“ im Kopf des Chats führt zur Liste der Links, falls es welche gibt |

Der erste Modus passt, wenn der Chat ein Kontaktweg neben den Messengern ist. Der zweite, wenn der Chat die Hauptrolle spielt.

### Dateiempfang

Der Schalter „Dateien von Besuchern annehmen“ ist standardmäßig eingeschaltet. Im Eingabefeld des Chats erscheint eine Büroklammer, und der Besucher kann senden:

- Bilder — JPG, PNG, GIF, WebP;
- Dokumente — PDF, Word, Excel, Textdateien und CSV;
- Audio und Video.

Einschränkungen: eine Datei bis 10 MB; von einem Besucher höchstens 20 Dateien und 50 MB pro Tag.

> [!NOTE]
> Die Einstellung gilt für alle Widgets mit diesem Bot: Schalten Sie sie in einem Widget aus, verschwindet die Büroklammer in allen.

### Neue Besucher pro IP und Stunde

Jeder neue Besucher des Chats ist ein kostenpflichtiger Kontakt des Bots. Damit niemand Hunderte davon anlegt, indem er den Chat immer wieder öffnet, begrenzt die Plattform die Zahl neuer Besucher von einer IP-Adresse pro Stunde. Standardmäßig 20, möglich sind 0 bis 1000; 0 hebt die Begrenzung auf.

Ein Besucher über dem Limit sieht „Der Chat ist derzeit nicht verfügbar, bitte versuchen Sie es später erneut“. Bereits begonnene Unterhaltungen betrifft die Begrenzung nicht.

> [!TIP]
> Erhöhen Sie den Wert, wenn Ihre Kunden oft von derselben Adresse aus online gehen — zum Beispiel Mitarbeiter eines großen Unternehmens oder Besucher eines Coworking-Space.

## Den Chat testen

Im Baukasten ist der Chat echt: Öffnen Sie ihn im Widget und schreiben Sie eine Nachricht. Das ist ein Test des Bots — genau wie das Fenster „Bot testen“ im Schema: Der Bot antwortet nach dem Szenario, aber eine solche Unterhaltung erzeugt weder Kontakte noch Statistik.

## Wie der Chat beim Besucher funktioniert

- Der Besucher wird zum Kontakt, wenn er den Chat öffnet, nicht wenn die Seite der Website geladen wird.
- Die Unterhaltung wird im Browser des Besuchers gespeichert. Kehrt er vom selben Gerät auf die Website zurück, sieht er seinen Verlauf und setzt das Gespräch fort.
- Nachrichten des Operators aus dem Bereich „Nachrichten“ kommen im selben Chat an.
- Solange der Chat geöffnet ist, ist das Banner des Widgets ausgeblendet.

### Wie der Besucher von einer Antwort erfährt

Hat der Besucher das Widget minimiert oder ist zu einem anderen Tab gewechselt, und der Bot oder der Operator hat geantwortet, ruft das Widget ihn zurück:

| Weg | Was der Besucher sieht |
|---|---|
| Badge | Ein roter Kreis mit der Zahl ungelesener Nachrichten auf dem Button des Widgets; mehr als neun — „9+“ |
| Hinweis | Eine Karte über dem Button: Name des Bots (oder „Operator“) und der Anfang der Nachricht. Ein Klick öffnet den Chat, das Kreuz schließt den Hinweis |
| Titel des Tabs | Eine Zahl in Klammern vor dem Namen der Seite — zum Beispiel „(2) Kamille — Blumenlieferung“ |
| Ton | Ein kurzes Signal. Es ertönt nur bei Nachrichten, die bei geöffneter Seite eingehen: Nach einem Neuladen wird Verpasstes ohne Ton angezeigt |

![Eingeklapptes Widget: Antwortvorschau und Zähler](https://support.watbot.org/_media/de/04-widgets/_images/unread.webp?v=1791781230)

Das Widget prüft etwa alle 20 Sekunden auf neue Nachrichten, deshalb erscheint das Badge mit einer kleinen Verzögerung. Eine Erlaubnis für Browser-Benachrichtigungen fragt das Widget nicht an. Die Benachrichtigungen funktionieren nur bei Besuchern, die den Chat auf diesem Gerät schon einmal geöffnet haben.

## Einschränkungen des Chats

- Ein Besucher kann höchstens 30 Nachrichten pro Minute senden.
- Eine Nachricht — bis zu 4096 Zeichen.
- Eine Datei — bis zu 10 MB; 20 Dateien und 50 MB pro Tag und Besucher.
- Beim Verschieben des Widgets in ein anderes Projekt wird der Chat darin ausgeschaltet.

Die Texte des Chats — Titel, Beschriftung der Schaltfläche und Platzhalter — prüft die Plattform genauso wie die übrigen Texte des Widgets: siehe [Prüfung der Widgets durch die Plattform](https://support.watbot.org/de/widgets).

## Wenn etwas nicht funktioniert

- **„Der Kanal „Web-Chat“ dieses Bots ist ausgeschaltet, daher wird der Chat auf der Website nicht angezeigt.“** Eine Warnung im Einstellungspanel: Der Kanal wurde im Schema des Bots getrennt. Klicken Sie direkt in der Warnung auf „Kanal verbinden“.
- **Beim Speichern öffnet sich ein Fenster mit dem Angebot, Pro abzuschließen.** Der Chat lässt sich nur mit Abonnement einschalten.
- **„Der Bot wurde im Projekt des Widgets nicht gefunden.“** Der gewählte Bot wurde gelöscht oder in ein anderes Projekt verschoben. Wählen Sie einen anderen.
- **Die Liste „Bot“ ist leer — „Das Projekt hat noch keine Bots“.** Erstellen Sie einen Bot in diesem Projekt oder verschieben Sie das Widget in ein Projekt mit Bot.
- **Kein Chat auf der Website, obwohl er eingeschaltet ist.** Prüfen Sie der Reihe nach: Ist Pro beim Eigentümer des Bots aktiv, ist beim Bot der Kanal „Web-Chat“ verbunden, ist das Widget gespeichert.
- **Der Besucher sieht „Der Chat ist derzeit nicht verfügbar, bitte versuchen Sie es später erneut.“** Gründe: Beim Eigentümer des Bots ist das Abonnement abgelaufen oder das Limit für neue Besucher hat gegriffen.
- **Der Besucher sieht „Zu viele Nachrichten, bitte warten Sie einen Moment.“** Das Limit von 30 Nachrichten pro Minute hat gegriffen.
- **Der Besucher kann keine Datei senden.** Die Meldungen des Chats nennen den Grund: „Die Datei ist zu groß: maximal 10 MB.“, „Dieser Dateityp wird nicht unterstützt. Bilder, Videos, Audio und Dokumente sind möglich.“, „Zu viele Dateien, bitte versuchen Sie es morgen erneut.“ oder „In diesem Chat können keine Dateien gesendet werden.“ — wenn der Dateiempfang ausgeschaltet ist.