Widget einstellen

Jeder Assistent bringt sein eigenes Chatfenster mit. Diese Seite beschreibt alle Einstellungen dazu im Abschnitt Chatfenster auf Ihrer Website: jedes Feld mit Grenzen und Vorgabe, wer was ändern darf, was beim Speichern geschieht, wann eine Änderung auf Ihrer Website ankommt, was Vorschau und Einbindungsanzeige zeigen und wie Sie einen neuen Schlüssel erzeugen. Wie die Zeile auf Ihre Website kommt, steht unter Widget einbauen.

Wo die Einstellungen stehen

Öffnen Sie Arbeit › Assistenten (app.xicbot.de/assistenten) und klicken Sie beim gewünschten Assistenten auf Bearbeiten; mit der Rolle Lesen heißt der Knopf Ansehen. Der geöffnete Bereich enthält den Abschnitt Chatfenster auf Ihrer Website mit dem Hinweis „Das Chatfenster läuft in einem eigenen Rahmen. Es kann die Seite, auf der es liegt, weder lesen noch verändern.“ Mit Schließen klappen Sie den Bereich wieder zu.

Der Abschnitt hat vier Teile: oben das Formular mit allen Einstellungen und dem Knopf Speichern, darunter die Einbaucodes zum Kopieren, dann die Anzeige Einbindung auf Ihrer Website mit der Vorschau und am Ende der Teil Öffentlicher Schlüssel. Die Einstellungen gelten je Assistent: jeder Assistent hat sein eigenes Chatfenster mit eigenem Schlüssel und eigenem Einbaucode.

Wer was ändern darf

Der Dienst prüft die Rolle selbst, nicht nur die App. Ein Speichern ohne die Rolle Bearbeiten lehnt er ab, und die App meldet „Mit der Rolle Lesen lässt sich hier nur ansehen. Ändern kann, wer mindestens die Rolle Bearbeiten hat.“ Ein neuer Schlüssel ohne die Rolle Verwaltung endet mit „Das darf, wer mindestens die Rolle Verwaltung hat.“ Für alles auf dieser Seite braucht es außerdem eine Anmeldung, ein aktives Konto und eine bestätigte E-Mail-Adresse. Wie Rollen vergeben werden, steht unter Team und Rollen.

Alle Felder im Überblick

Keines der Felder ist Pflicht. Werte außerhalb der Grenzen weist schon der Browser beim Speichern zurück, der Dienst prüft sie ein zweites Mal. Die Tabelle nennt die Beschriftung in der App in der Reihenfolge des Formulars, was erlaubt ist und was gilt, solange Sie nichts ändern. Zahlen sind ganze Zahlen.

Ein Zahlenfeld, das Sie leeren, wird mit seiner Vorgabe gespeichert. Ein leeres Textfeld gilt als nicht gesetzt; es greift dann die Vorgabe aus der Tabelle.

Chatfenster freigeben

Der Schalter Chatfenster freigeben trägt den Hinweis „Erst mit dieser Freigabe antwortet der Schnipsel auf fremden Seiten. Ohne sie bleibt er wirkungslos.“ Zusätzlich muss der Assistent unter Grunddaten im Feld Status auf aktiv stehen. Fehlt eines von beiden, antwortet der Dienst auf den Einbaucode so, als gäbe es den Assistenten nicht, und der Lader nimmt den Auslöser vom Bildschirm. Genauso verhält es sich, wenn das Konto nicht aktiv ist oder eine Demo abgelaufen ist.

Ausschalten lässt die übrigen Einstellungen, den Schlüssel und den Einbaucode unberührt. Schalten Sie wieder ein, arbeitet der bisherige Code auf Ihren Seiten weiter. Wer das Chatfenster nur für eine Weile abschalten will, nimmt deshalb diesen Schalter oder den Status und keinen neuen Schlüssel. Mehr zu den beiden Schaltern steht unter Assistenten und Widget einbauen.

Löschen Sie den Assistenten (Rolle Verwaltung oder Inhaber), verschwinden mit ihm alle Einstellungen dieses Abschnitts und der Schlüssel; der Einbaucode findet danach keinen Assistenten mehr. Das Löschen beschreibt Assistenten.

Überschrift, Farbe und Bild

Überschrift im Fenster

Überschrift im Fenster nimmt bis zu 80 Zeichen auf. Bleibt das Feld leer, zeigt das Fenster den Namen des Assistenten; die App blendet ihn als Platzhalter ins leere Feld ein. Dieselbe Überschrift dient Bildschirmlesern als Name des Fensters und, solange es geschlossen ist, des Auslösers.

Farbe

Farbe öffnet den Farbwähler des Browsers; daneben steht der gewählte Wert als #RRGGBB. Der Dienst nimmt nur diese Form mit sechs Hexadezimalstellen an. Die Farbe füllt den Auslöser und die Flächen der Marke im Fenster. Zum Feld gehört der Hinweis „Die Schriftfarbe im Fenster wird aus dieser Farbe berechnet, damit der Kontrast auch bei hellen Tönen reicht.“ Die Schrift auf der Farbe wird dabei schwarz oder weiß gesetzt; eine eigene Schriftfarbe gibt es nicht.

Steht im Einbaucode ein eigenes data-farbe, gilt es nur, bis das Fenster die Einstellungen vom Dienst geladen hat; danach gilt die Farbe aus der App. Für data-platz und data-senkrecht gegenüber Ecke des Fensters gilt dasselbe. Die Rangfolge steht unter Script-Attribute.

Bild in der Titelleiste

Mit Datei wählen laden Sie ein Bild im Format PNG, JPEG oder WebP, Bild entfernen leert das Feld; beides wirkt erst mit Speichern. Das Bild erscheint in der Titelleiste des Fensters und auf dem Auslöser. Zuschnitt, Grenzen, Meldungen und Anzeige beschreibt Bild in der Titelleiste.

Lage und Größe

Ecke des Fensters bietet unten rechts, unten links, oben rechts und oben links. Dort sitzt der Auslöser, und dort öffnet sich das Fenster. Unter Abstand zum Seitenrand (px) und Abstand zur Ober- oder Unterkante (px) steht der Hinweis „Gemessen vom Auslöser zur jeweiligen Fensterkante. Auf Geräten mit abgerundetem Bildschirm kommt der geschützte Rand hinzu.“ Welche Kante gemeint ist, folgt aus der gewählten Ecke.

Breite des Fensters (px) und Höhe des Fensters (px) tragen den Hinweis „Wunschmaß. Auf einem kleinen Bildschirm gilt weniger, damit das Fenster im Bild bleibt; bis 560 Pixel Breite füllt es die Fläche ganz.“ Genau gilt: Die Breite ist höchstens so groß wie das Browserfenster abzüglich Seitenabstand und 16 Pixel. Die Höhe ist höchstens so groß wie das Browserfenster abzüglich 32 Pixel und des Abstands, den das Chatfenster zur Kante hält; dieser Abstand ist die Summe aus Kantenabstand, Größe des Auslösers und 12 Pixel. Liegt ein Aufbau Ihrer Seite über dem Platz des Auslösers, etwa ein Einwilligungsbanner, rückt der Auslöser senkrecht von ihm weg. Das Fenster rückt um denselben Betrag mit, und seine größte Höhe sinkt entsprechend. Ist das Browserfenster höchstens 560 Pixel breit, füllt das Chatfenster die ganze Fläche.

Skalierung (%) trägt den Hinweis „Wirkt auf den Auslöser und auf die Schriftgröße im Fenster. 100 heißt: unverändert.“ Bei 100 misst der Auslöser 56 Pixel und die Grundschrift 16 Pixel, bei 150 sind es 84 und 24 Pixel, bei 80 sind es 45 und 12,8 Pixel. Breite und Höhe des Fensters ändert die Skalierung nicht.

Eckenradius (px) rundet die Ecken des Fensters und des Auslösers, 0 ergibt spitze Ecken. Den Auslöser rundet der Radius höchstens bis zur Hälfte seiner Kantenlänge, also höchstens zum Kreis. Mit den Vorgaben (Radius 18, Auslöser 56 Pixel) ist er ein Quadrat mit abgerundeten Ecken. Füllt das Fenster auf einem schmalen Bildschirm die ganze Fläche, hat es keine runden Ecken.

Proaktive Ansprache

Der Hinweis zum Feld lautet „Je Regel ein Ereignis und ein Satz. Die erste Regel, die zutrifft, spricht; danach schweigt das Widget für diesen Besuch. Ohne Regel erscheint nichts ungefragt.“ Regel hinzufügen legt eine weitere Regel an, bis zu fünf; ein Zähler wie 2/5 zeigt den Stand, und bei fünf Regeln verschwindet der Knopf. Regeln ohne Satz entfernt die App beim Speichern. Der Satz einer Regel hat höchstens 200 Zeichen; ein Pfadfilter beginnt mit / und hat höchstens 120 Zeichen, sonst lehnt der Dienst das Speichern ab. Ereignisse, Pfadfilter und Reihenfolge beschreibt Proaktive Ansprache.

Dateien vom Besucher

Dateien vom Besucher annehmen nennt im Hinweis die Grenzen: „Bilder und PDF, höchstens 5 MB und fünf Dateien je Gespräch.“ Zugelassen sind PNG, JPEG, WebP und PDF, erkannt am Inhalt der Datei; SVG, Office-Formate und Archive sind ausgeschlossen. Nur bei eingeschaltetem Schalter bietet das Fenster eine Dateiauswahl an, in der Vorschau nicht.

Ist der Schalter aus, lehnt der Dienst jede Datei ab. Eine Seite, die noch mit der alten Einstellung offen ist, meldet dann „Dateien sind hier nicht freigegeben.“ Wie der Besucher Dateien sendet, steht unter Gespräch im Widget.

Einwilligung vor dem ersten Gespräch

Der Schalter Einwilligung vor dem ersten Gespräch trägt den Hinweis „Das Fenster zeigt dann ein Tor: ohne Zustimmung lässt sich nichts schreiben und nichts senden. Wer ablehnt, schließt das Fenster, ohne dass ein Gespräch entsteht.“ Das Feld Text der Einwilligung lässt sich nur bei eingeschaltetem Schalter bearbeiten und nimmt bis zu 500 Zeichen auf. Sein Hinweis: „Leer lassen heißt: es gilt unser Vorgabetext in der Sprache des Fensters.“ Der Vorgabetext lautet:

Die Sprache des Fensters folgt data-sprache im Einbaucode (de oder en), sonst der Sprache der aktiven Fassung, sonst gilt Deutsch. Ein eigener Text erscheint so, wie Sie ihn schreiben, in jeder Sprache des Fensters.

Nach dem Speichern trägt der Einbaucode zusätzlich data-einwilligung="erforderlich". Tauschen Sie den Code auf Ihren Seiten aus: ohne dieses Merkmal lädt der Lader das Fenster samt Einstellungen, sobald Ihre Seite geladen ist, also vor jeder Zustimmung. Der Dienst selbst verlangt die Zustimmung ab sofort und lehnt den Start eines Gesprächs ohne sie ab. Mit der Zustimmung speichert er den Zeitpunkt und einen SHA-256-Fingerabdruck aus dem Wortlaut, dem der Besucher zugestimmt hat, der Fassung der Datenschutzerklärung und der Seite. Dieser Wortlaut ist Ihr Text der Einwilligung oder, wenn das Feld leer ist, der Vorgabetext in der Sprache des Fensters. Mehr unter Script-Attribute und Einwilligung und Besucherrechte.

Erlaubte Domains

Der Hinweis zum Feld lautet „Eine pro Zeile. Unterdomains sind eingeschlossen. Leer heißt: jede Website darf das Fenster einbinden.“ Das Feld nimmt bis zu 500 Zeichen auf. Außer Zeilenumbrüchen trennen auch Kommas die Einträge; Leerzeichen am Rand sowie Groß- und Kleinschreibung spielen keine Rolle. Tragen Sie nur Domainnamen ein, ohne https:// und ohne Pfad: verglichen wird mit dem Domainnamen der Seite. Ein Eintrag example.com erlaubt example.com und shop.example.com.

Geprüft wird beim Start eines Gesprächs: die Seite, auf der das Fenster läuft, muss einem Eintrag gleichen oder eine Unterdomain davon sein. Ist die Liste gefüllt und keine Seite bekannt, lehnt der Dienst ebenfalls ab. Das Fenster zeigt dann „Dieser Chat ist für diese Website nicht freigegeben.“ Laden und Anzeige des Fensters prüft die Liste nicht, ebenso wenig die Anzeige Einbindung auf Ihrer Website. Mehr unter Widget einbauen.

Eigener Pfad auf Ihrer Domain

Mit Eigener Pfad auf Ihrer Domain laufen Fenster und Anfragen über eine Adresse auf Ihrer Domain, etwa https://example.com/chat. Erlaubt ist eine absolute Adresse mit http:// oder https:// und Rechnername, höchstens 200 Zeichen, ohne ? und ohne #. Schrägstriche am Ende werden beim Speichern entfernt. Eine unvollständige Adresse weist schon der Browser zurück; verletzt die Adresse eine der übrigen Regeln, lehnt der Dienst sie ab. Die App nennt den Grund dann unter dem Feld, etwa „Die Adresse Ihres eigenen Pfads darf weder „?“ noch „#“ enthalten.“, und meldet dazu „Bitte prüfen Sie die markierten Felder.“ Der Hinweis zum Feld endet mit „Leer heißt: kein eigener Pfad eingerichtet.“

Der zugehörige Einbaucode über Ihre eigene Adresse erscheint erst, wenn der Pfad gespeichert ist. Bis dahin steht an seiner Stelle „Sobald oben ein eigener Pfad steht und gespeichert ist, erscheint hier der zugehörige Einbaucode.“ Was Ihr Server dafür weiterreichen muss, steht unter Widget einbauen.

Speichern

Speichern übernimmt alle Felder des Abschnitts auf einmal. Während der Anfrage steht auf dem Knopf „Wird gespeichert …“, danach meldet die App „Gespeichert.“ Die Einstellungen gehören zum Assistenten, nicht zu einer Fassung: sie wirken ohne Veröffentlichen, und das Zurückholen einer älteren Fassung lässt sie unverändert.

• Leere Textfelder werden als nicht gesetzt gespeichert, es gilt dann die jeweilige Vorgabe.
• Geleerte Zahlenfelder werden mit ihrer Vorgabe gespeichert: 20, 20, 384, 620, 100 und 18.
• Regeln der proaktiven Ansprache ohne Satz fallen weg.
• Danach lädt die App die Einbaucodes und die Einbindungsanzeige neu. Scheitert nur dieser Schritt, sind die Einstellungen trotzdem gespeichert; die App meldet dann „Gespeichert. Der Einbaucode für „…“ konnte danach nicht neu geladen werden. Öffnen Sie diesen Assistenten erneut, um ihn zu sehen.“ und zeigt statt der Codes „Der Stand konnte nicht geladen werden.“
• Je angemeldeter Person gelten 30 Vorgänge pro Minute. Mitgezählt werden neben diesem Speichern auch Speichern unter Grunddaten, das Anlegen von Assistenten, das Veröffentlichen und Zurückholen von Fassungen, Neuen Schlüssel erzeugen, das Anlegen und Ändern von Werkzeugen sowie das Anlegen und Ändern von Prüffragen und das Starten von Läufen in der Abnahme. Darüber meldet die App „Zu viele Versuche. Bitte warten Sie einen Moment.“

Wann Änderungen auf Ihrer Website ankommen

Jede Seite, die nach dem Speichern neu lädt, bekommt alle Einstellungen. Eine Seite, die schon offen ist, fragt höchstens einmal pro Minute nach, und zwar wenn der Besucher das Fenster öffnet oder zum Tab zurückkehrt. Scheitert diese Nachfrage, bleibt alles, wie es ist.

Einbaucode kopieren

Unter dem Formular stehen bis zu zwei Einbaucodes in schreibgeschützten Feldern, jeder mit dem Knopf Einbaucode kopieren. Zuerst Einbaucode über Ihre eigene Adresse mit dem Hinweis „Der empfohlene Weg: Fenster und Anfragen laufen über Ihre Domain, der Besucher spricht mit keiner fremden Adresse.“, danach Einbaucode über unsere Adresse mit dem Hinweis „Diese Zeile gehört in den Kopf jeder Seite, auf der das Fenster erscheinen soll. Der Besucher lädt das Fenster dabei von unserer Adresse.“ Ansehen und kopieren kann jede Rolle.

Ist noch kein eigener Pfad gespeichert, steht an der ersten Stelle „Sobald oben ein eigener Pfad steht und gespeichert ist, erscheint hier der zugehörige Einbaucode.“ Nach dem Kopieren meldet die App „Einbaucode kopiert.“ Verweigert der Browser den Zugriff auf die Zwischenablage, erscheint „Kopieren war nicht möglich. Bitte den Text von Hand markieren.“ Solange die Codes laden, steht dort „Wird geladen …“, ließen sie sich nicht laden, „Der Stand konnte nicht geladen werden.“ So sieht ein Einbaucode über den eigenen Pfad https://example.com/chat bei eingeschalteter Einwilligung aus, … steht für Ihren Schlüssel:

<script src="https://example.com/chat/einbetten.js" data-xicbot="…" data-basis="https://example.com/chat" data-einwilligung="erforderlich" defer></script>

Wohin die Zeile gehört und wie sich die beiden Wege unterscheiden, steht unter Widget einbauen, alle Merkmale der Zeile unter Script-Attribute.

Einbindung und Vorschau

Die Anzeige Einbindung auf Ihrer Website zeigt, wann und auf welcher Seite das Fenster zuletzt auf einer fremden Seite geladen hat, etwa „Zuletzt geladen: 28.9.2026, 14:05:00“ und „Seite: www.example.com“. Hat es das noch nicht getan, steht dort „Das Fenster hat auf Ihrer Website noch nie geladen.“ Wann ein Eintrag entsteht, wann er sich ändert und was er nicht aussagt, steht unter Einbindung prüfen.

Vorschau anzeigen öffnet unter der Anzeige das Fenster, Vorschau schließen schließt es wieder; jede Rolle kann die Vorschau öffnen. Was sie zeigt und was nicht, steht unter Vorschau in der App.

Öffentlicher Schlüssel

Am Ende des Abschnitts steht unter Öffentlicher Schlüssel der Schlüssel selbst, derselbe Wert wie data-xicbot im Einbaucode. Mit Neuen Schlüssel erzeugen ersetzen die Rollen Verwaltung und Inhaber ihn; der bisherige Einbaucode hört damit sofort auf zu arbeiten. Wie der Tausch abläuft, was die App dabei meldet und was Sie vorher bereithalten, steht unter Öffentlicher Schlüssel. Zum vorübergehenden Abschalten eignet sich Chatfenster freigeben besser.

Meldungen

Über die Schnittstelle

Dieselben Einstellungen lassen sich über die Schnittstelle setzen. Die Felder heißen dort so:

Alle Endpunkte für Assistenten beschreibt Schnittstelle für Wissen und Assistenten, die öffentlichen Endpunkte des Fensters Schnittstelle des Widgets, die Drosseln Grenzen der Schnittstelle.

Weiterlesen

• Widget einbauen: Einbauwege, Domainliste, eigener Pfad und Prüfen der Einbindung.
• Script-Attribute: alle Merkmale der Einbauzeile und ihre Rangfolge.
• Darstellung und Bedienung: wie das Fenster beim Besucher aussieht und sich bedienen lässt.
• Proaktive Ansprache: Regeln, Ereignisse und Sprechblase.
• Einwilligung und Besucherrechte: Tor, Widerruf und Auskunft.
• JavaScript und Speicher: was das Fenster im Browser ablegt.
• Widget-Auslieferung: woher die Dateien des Fensters kommen.
• Assistenten: Grunddaten, Status, Fassungen und Löschen.

Häufige Fragen