Wir können dir helfen!

Dein Tarif (auch "Paket" genannt) legt fest, welche Funktionen und Kontingente (z. B. Anzahl Chaträume, Speicherplatz) dir zur Verfügung stehen.

So wechselst du:

1. Gehe zu Prepaid > Tarife - dort siehst du alle verfügbaren Pakete sowie eine ausführliche Vergleichstabelle darunter.
2. Wähle das gewünschte Paket über "Auswählen" aus.
3. Wir zeigen dir vor der Bestätigung an, ab welchem Datum der Wechsel aktiv wird - erst danach wird tatsächlich gewechselt.

Die Abbuchung für das neue Paket erfolgt automatisch von deinem Prepaid-Guthaben (siehe FAQ "Welche Zahlungsmethoden werden angeboten, wie funktioniert das Bezahlen?").

Zusatzoptionen (auch "Module" genannt) sind einzeln buchbare Erweiterungen für dein Chatsystem, unabhängig von deinem Grundpaket - z. B. neue Chat-Spiele, ein automatischer Abwesenheits-Status oder der Butler (siehe FAQ "Was ist der Butler und wie richte ich ihn ein?").

So buchst du eine:

1. Gehe zu Prepaid > Zusatzoptionen, Reiter Shop, um verfügbare Module zu durchsuchen.
2. Klicke auf eine Kachel, um Details zur Option zu sehen.
3. Klicke auf "Buchen" (bzw. bei kostenlosen Optionen auf "Installieren").

Der Preis wird automatisch von deinem Prepaid-Guthaben abgebucht. Unter dem Reiter Installiert siehst du alle aktuell aktiven Module.

Manche Module bringen nach der Aktivierung eine eigene Einstellungsseite mit, die dann automatisch im Menü der Administration erscheint.

Ein Chatraum ist einer der "Räume", in denen sich deine Besucher unterhalten - vergleichbar mit einem eigenen Zimmer oder Kanal.

So legst du einen neuen an:

1. Gehe zu Chaträume und klicke oben rechts auf Erstellen.
2. Vergib einen Namen und optional eine kurze Beschreibung.
3. Speichern - der Raum ist damit sofort für Besucher betretbar.

Im Anschluss kannst du den Raum noch einer Kategorie zuordnen (siehe FAQ "Wozu dienen Kategorien bei Chaträumen?") und sein Design anpassen (siehe FAQ "Wie ändere ich das Design eines Chatraumes?").

Kategorien sind Ordner für deine Chaträume - sie sortieren die Räume in der Übersicht, die Besucher beim Betreten des Chats sehen. Sinnvoll, sobald du mehr als eine Handvoll Räume hast.

Beispiel: statt einer langen, unsortierten Liste sehen Besucher stattdessen die Gruppen "Smalltalk", "Musik" und "18+", die sich jeweils aufklappen lassen.

So gehst du vor:

1. Lege die Kategorie unter Chaträume > Kategorien an, optional mit eigenem Vorschaubild.
2. Öffne einen bestehenden Raum zum Bearbeiten und ordne ihn dort der Kategorie zu.

Räume ohne zugeordnete Kategorie werden weiterhin ganz normal angezeigt, nur eben nicht gruppiert.

Hierzu hast du zwei Möglichkeiten:

Möglichkeit 1 - direkt am Raum: Öffne den Raum zum Bearbeiten, Reiter Design, und passe dort Schrift-, Tönungs- und Hintergrundfarben unmittelbar an - mit Live-Vorschau direkt daneben. Praktisch, wenn nur dieser eine Raum ein individuelles Design bekommen soll.

Möglichkeit 2 - Design-Template: Lege unter Chaträume > Designs eine Vorlage an und weise sie einem oder mehreren Räumen zu. Praktisch, wenn mehrere Räume dasselbe Design teilen sollen - änderst du später die Vorlage, ändern sich alle zugewiesenen Räume automatisch mit.

Auch mit zugewiesenem Design-Template kannst du am Raum selbst über "Style überschreiben" bzw. "Statusfarben überschreiben" (siehe Screenshot oben) einzelne Werte der Vorlage individuell übersteuern, ohne die Vorlage selbst zu verändern.

Ein Chatbefehl ist ein Kommando, das Nutzer im Chat eingeben (z. B. /hello), das dann eine von dir programmierte Aktion auslöst.

So erstellst du einen:

1. Gehe zu Inhalte > Befehle und klicke auf Erstellen.
2. Vergib einen Namen sowie ein oder mehrere Befehlsnamen (Kürzel, mit denen er im Chat aufgerufen wird, z. B. hello).
3. Wechsle zum Reiter Editor und implementiere die gewünschte Logik in JavaScript. Auf der linken Seite findest du die verfügbare API nach Bereich sortiert (Client, User, Room, Server, Logger, Utils), unten Logs und eventuelle Probleme deines Scripts.
4. Speichern.

Für die JavaScript-Schnittstelle (welche Funktionen dir zur Verfügung stehen) gibt es eine vollständige Dokumentation:

Fehler in deinem Script? Die Ausgaben landen zusätzlich in den Server-Logs - siehe FAQ "Wo finde ich die Server-Logs und wofür sind sie gut?".

"Fenster" sind kleine Zusatzseiten, die sich innerhalb des Chats öffnen lassen - ähnlich einem Pop-up. Typische Beispiele: eine Regeln-Seite, ein Kontaktformular oder eine eingebettete externe Webseite.

So erstellst du eines:

1. Gehe zu Inhalte > Fenster und klicke auf Erstellen.
2. Im Editor ziehst du Elemente aus der linken Palette (Label, Link, Content, Textfelder, Dropdown, Radio, Checkbox, Slider, Datum/Uhrzeit, E-Mail, Button, Tabs, Linie, Grid, Splitter) per Drag & Drop auf die Fenster-Vorschau in der Mitte.
3. Rechts stellst du die Fenster-Eigenschaften ein: Name, Titel, Breite/Höhe, Schriftfarbe, Hintergrundbild.
4. Speichern.

Damit Besucher das Fenster öffnen können, brauchst du meist noch einen Befehl oder Menüpunkt, der darauf verweist - siehe FAQ "Wie kann ich einen eigenen Chatbefehl erstellen?".

Smileys sind die kleinen Bildchen, die Besucher über ein Kürzel im Chat einfügen können (z. B. wird aus [mario] automatisch ein Super-Mario-Smiley).

So fügst du einen hinzu:

1. Gehe zu Inhalte > Smileys und klicke auf Erstellen.
2. Lade die Bilddatei hoch.
3. Vergib ein oder mehrere Kürzel (Syntax).
4. Speichern - der Smiley steht sofort zur Verfügung.

Wie viele eigene Smileys du anlegen darfst, hängt von deinem gebuchten Paket ab (siehe FAQ "Wie wechsle ich mein Tarif/Paket?"). Unter dem Reiter "Vorgaben" findest du zusätzlich vorgefertigte Smileys zur Auswahl.

Benutzer legst du nicht selbst manuell an - sie entstehen automatisch, sobald sich jemand über die Registrierung deines Chatsystems anmeldet (siehe FAQ "Wie kann ich eine Registrierung auf meiner Seite einbinden?").

Bestehende Benutzer bearbeitest du unter Benutzer:

1. Klicke in der Liste auf "Bearbeiten" beim gewünschten Benutzer.
2. Ändere z. B. seinen Rang, Anzeigenamen oder weitere Daten.
3. Speichern.

Was der "Rang" eines Benutzers genau bedeutet und wie du dessen Rechte einstellst, steht in der FAQ "Wie funktionieren Berechtigungen im Rang-Editor?".

Ein Rang ist eine Art Mitgliedsgruppe (z. B. "Administrator", "Mitglied"). Jeder Benutzer hat genau einen Rang, der zweierlei bestimmt: seine Farbe/Kennzeichnung im Chat und was er in der Administration darf.

So vergibst du Berechtigungen:

1. Gehe zu Benutzer > Ränge und wähle "Bearbeiten" bei einem Rang (oder lege über "Erstellen" einen neuen an).
2. Klappe einen der Bereiche auf (z. B. "Administration", "Module"), um die einzelnen Berechtigungen darin zu sehen.
3. Setze ein Häkchen bei jeder Berechtigung, die dieser Rang haben soll.
4. Speichern.

Ohne Berechtigung für einen Bereich sieht ein Benutzer den zugehörigen Menüpunkt in der Administration gar nicht erst.

Tipp für den Einstieg: Leg dir zunächst einen Rang mit allen Berechtigungen an und teste damit selbst, bevor du engere Ränge für andere Personen vergibst.

Das ist eine zentrale Bilderverwaltung - ein gemeinsamer Ordner für alle Bilder, die du an verschiedenen Stellen der Administration wiederverwenden möchtest (z. B. als Kategorie-Bild oder Design-Hintergrund).

Statt bei jeder einzelnen Auswahl eine neue Datei hochzuladen, wählst du unter Server > Bilder ein bereits hochgeladenes Bild aus - oder lädst dort über "Hochladen" ein neues hoch, damit es dir überall zur Auswahl steht. Links siehst du den Speicherverbrauch je Kategorie.

Logs sind ein fortlaufendes Protokoll dessen, was auf deinem Chatserver technisch passiert - hilfreich, wenn du einer Fehlermeldung auf den Grund gehen willst.

Du findest sie unter Server > Logs, dort kannst du:

• links nach Tag (Log-Datei) filtern,
• oben nach Schweregrad filtern (Debug = Detail-Info, Info = normaler Ablauf, Warnung = Auffälligkeit, Meldung/Fehler = tatsächlicher Fehler),
• gezielt nach einem Suchbegriff suchen.

Am relevantesten, wenn du eigene Befehle oder Fenster erstellt hast - Fehlermeldungen aus deinem eigenen Script landen ebenfalls hier.

Ein API-Token ist ein digitaler Schlüssel, mit dem ein externes Programm (z. B. deine eigene Webseite oder ein Script) auf dein Chatsystem zugreifen kann, ohne sich mit Benutzername und Passwort einzuloggen.

So erstellst du einen unter Sicherheit > API, Reiter Auth Tokens:

1. Klicke auf Erstellen - der Token wird automatisch generiert, angezeigt und direkt in die Zwischenablage kopiert.
2. Speichere den Token sicher, z. B. direkt in deinem Script - über das Kopier-Symbol neben dem Token-Feld kannst du ihn jederzeit erneut kopieren, solange du auf dieser Seite bist. Verlässt du die Seite, wird er aus Sicherheitsgründen nur noch verkürzt/gar nicht mehr im Klartext angezeigt.
3. Brauchst du den Zugriff nicht mehr, sperrst du den Token jederzeit über "Widerrufen" in seiner Zeile - widerrufene Tokens funktionieren sofort nicht mehr.

Zusätzlichen Schutz für den Zugriff über Tokens bietet die IP-Whitelist - siehe FAQ "Wie schränke ich den API-Zugriff per IP-Whitelist ein?". Ob externer Zugriff grundsätzlich möglich ist, steuerst du separat - siehe FAQ "Was bewirkt der Schalter API aktiviert unter Sicherheit > Backend?".

Die IP-Whitelist ist eine zusätzliche Absicherung für den Zugriff über API-Tokens (siehe FAQ "Wie erstelle und nutze ich API-Tokens?"): du legst fest, von welchen IP-Adressen aus überhaupt zugegriffen werden darf. Ein gültiger Token allein reicht dann nicht mehr - die Anfrage muss zusätzlich von einer erlaubten Adresse kommen.

Einrichten unter Sicherheit > API, Reiter Whitelist:

1. Klicke auf "Hinzufügen".
2. Trage die gewünschte IPv4- oder IPv6-Adresse ein (z. B. die Adresse des Servers, der deine Website oder dein Script betreibt).
3. Speichern.

Ist die Whitelist leer, gilt keine Einschränkung - dann entscheidet allein der Token darüber, ob ein Zugriff erlaubt ist.

Achtung: Trägst du eine erste IP-Adresse ein, greift die Einschränkung sofort für alle Tokens - stelle sicher, dass die Adresse stimmt, bevor du speicherst, sonst sperrst du dich selbst aus.

Das ist der zentrale Hauptschalter für den externen Zugriff über API-Tokens (siehe FAQ "Wie erstelle und nutze ich API-Tokens?"), zu finden unter Sicherheit > Backend.

Schaltest du ihn aus, wird jeder Zugriff über die Schnittstelle abgelehnt - auch mit einem gültigen Token. Die Seite Sicherheit > API zeigt dann statt der Token-/Whitelist-Verwaltung nur noch den Hinweis "Schnittstelle deaktiviert" an.

Wichtig: Der Login in dieser Administration selbst ist davon nicht betroffen - du kannst dich also auch bei ausgeschalteter API ganz normal einloggen. Betroffen ist ausschließlich der Zugriff externer Programme über Tokens.

Dieser Schalter unter Sicherheit > Backend steuert, ob sich ein und derselbe Benutzer gleichzeitig auf mehreren Geräten/Browsern einloggen darf.

Im Normalzustand (ausgeschaltet) wird bei jedem neuen Login automatisch die vorherige Sitzung desselben Benutzers beendet - er wird also auf dem anderen Gerät "rausgeworfen".

Aktivierst du den Schalter, dürfen mehrere Sitzungen gleichzeitig bestehen, z. B. wenn derselbe Benutzer sowohl am Handy als auch am PC gleichzeitig eingeloggt sein soll.

Das Audit-Log ist ein Nachweis-Protokoll für sicherheitsrelevante Aktionen in deiner Administration - vergleichbar mit einem Kassenbuch, nur für Verwaltungshandlungen statt Geld.

Dort wird u. a. festgehalten:

• wer sich wann eingeloggt hat,
• wer wessen Berechtigungen wann geändert hat,
• weitere administrative Eingriffe, jeweils mit Zeitpunkt und ausführendem Benutzer.

Zu finden unter Sicherheit > Audit-Log - praktisch, um im Nachhinein nachzuvollziehen, wer eine bestimmte Änderung vorgenommen hat, besonders wenn mehrere Personen Zugriff auf die Administration haben.

"Whitelabel" bedeutet: du ersetzt unsere Marke ("Mein Chatserver") in der Administration durch deine eigene - eigener Name, eigenes Logo, eigene Farbe.

Einrichten unter Einstellungen > Whitelabel:

1. Trage deinen gewünschten Namen ein.
2. Lade optional ein eigenes Logo hoch.
3. Wähle eine eigene Grundfarbe.
4. Speichern - die Änderung ist sofort für alle sichtbar, die die Administration danach öffnen.

Diese Funktion ist paketabhängig - ist sie in deinem aktuellen Tarif nicht enthalten, wird dir das direkt auf der Seite angezeigt (siehe FAQ "Wie wechsle ich mein Tarif/Paket?").

Bevor jemand deinen Chat betritt, sieht er zuerst eine Login-Seite. Diese gestaltest du unter Einstellungen > Login.

Dort lässt sich u. a. einstellen:

• eine Raum-Vorauswahl (welcher Raum beim Login vorausgewählt ist),
• die Sprache der Login-Seite,
• im Reiter "Design" ein eigenes Hintergrundbild oder eine Hintergrundfarbe und das Farbschema,
• im Reiter "Einbettung" die Parameter für die Einbindung auf deiner eigenen Seite (siehe FAQ "Wie binde ich den Clienten auf meiner Seite ein?").

Wichtig zur Abgrenzung: Das betrifft ausschließlich die Login-Seite deiner Chat-Besucher - nicht den Login-Bildschirm dieser Administration hier.

Standardmäßig ist dein Chatsystem über eine Adresse wie <subdomain>.mein-chatserver.de erreichbar. Zusätzlich kannst du deine eigene Domain einbinden (z. B. chat.deine-domain.de).

So gehst du vor:

1. Trage deine Domain unter Einstellungen > Optionen > Domain ein.
2. Richte bei deinem Domain-Anbieter einen A-Record oder CNAME ein, der auf unseren Server zeigt (das sind Einträge im "Adressbuch des Internets", die einer Domain sagen, wohin sie zeigen soll) - die genauen Werte zeigt dir die Seite direkt an.
3. Warten: wir prüfen automatisch, ob die Domain korrekt zeigt (Domain-Status), und stellen danach selbstständig ein SSL-Zertifikat aus (Reiter Domain-Zertifikat, das "https"-Schloss im Browser). Das kann bis zu 30 Minuten dauern.

Solange die eigene Domain noch nicht korrekt eingerichtet ist, bleibt deine bisherige <subdomain>.mein-chatserver.de-Adresse ganz normal weiter erreichbar.

Der Reiter Übersicht unter Einstellungen > Optionen zeigt dir rein informativ die technischen Eckdaten deines Chatsystems - hier änderst du nichts, sondern liest nur ab:

• System-ID: eine interne Nummer, die dein Chatsystem eindeutig identifiziert - relevant, falls du mit unserem Support sprichst.
• Mandat: der interne Kurzname deines Systems.
• Hostname: die Standard-Adresse deines Chatsystems (<subdomain>.mein-chatserver.de).
• Port: die technische "Türnummer", über die sich ein Chat-Client mit deinem Server verbindet.

Hostname und Port brauchst du, wenn du deinen Client selbst einbindest oder entwickelst - siehe FAQ "Wie binde ich den Clienten auf meiner Seite ein?" und "Wie kann ich einen eigenen Clienten entwickeln?".

Ist der Wartungsmodus eingeschaltet, können sich nur Nutzer einloggen, die einen der dafür freigegebenen Ränge besitzen (welche das sind, legst du fest - siehe FAQ "Wie schalte ich den Wartungsmodus ein?").

Alle anderen Nutzer bekommen beim Login-Versuch statt des Chats deine hinterlegte Nachricht angezeigt und können nicht einloggen - dein Chat bleibt für sie unsichtbar/nicht betretbar, bis du den Modus wieder ausschaltest.

Praktisch z. B. für geplante Wartungsarbeiten oder wenn du Änderungen erst in Ruhe selbst testen willst, bevor Besucher sie sehen.

Unter Einstellungen > Optionen, Reiter Wartungsmodus, findest du drei Einstellungen:

1. Wartungsmodus aktiviert: der Hauptschalter.
2. Ränge: welche Ränge trotz aktivem Wartungsmodus weiterhin einloggen dürfen (z. B. dein eigener Admin-Rang, damit du selbst testen kannst).
3. Nachricht: der Text, der ausgesperrten Nutzern beim Login-Versuch angezeigt wird.

Was Nutzer ohne freigegebenen Rang dabei konkret sehen, steht in der FAQ "Was passiert im Wartungsmodus?".

Der "Butler" ist kein eigenes Feature, sondern ein ganz normaler Benutzer deines Chatsystems mit einer besonderen Rolle: Sobald ein Chatraum startet, wird dieser Benutzer automatisch gebunden - z. B. um automatisierte Nachrichten in seinem Namen zu senden.

Der Butler selbst ist ein Modul, das erst aktiv sein muss - siehe FAQ "Was sind Zusatzoptionen/Module und wie bekomme ich sie?".

Einrichten unter Einstellungen > Butler:

1. Wähle in der Liste den Benutzer aus, der als Butler dienen soll.
2. Speichern.

Am besten legst du dafür einen eigenen Benutzer an, statt einen bestehenden "echten" Account zu verwenden. Über den Reiter "Test" kannst du die Einrichtung direkt ausprobieren.

Die Verbindung zum Chatsystem erfolgt über deine Server-Daten (<subdomain>.mein-chatserver.de, oder deine eigene Domain - siehe FAQ "Wie binde ich eine eigene Domain ein?") sowie einen Port. Beide findest du unter Einstellungen > Optionen > Übersicht.

Der Chatserver ist wahlweise über WebSocket als auch über TCP erreichbar. Nach erfolgreicher Verbindung erhält der Client ein Initial-Paket mit Versionsinformationen. Sendet der Client nicht innerhalb von 5 Sekunden ein Handshake-Paket, wird die Verbindung automatisch geschlossen.

Die vollständige Protokoll-Dokumentation:

Als Basis zur Entwicklung kannst du auch unseren vorgefertigten Beispiel-Client verwenden - vollständig in Angular umgesetzt, inklusive Fenster- und Befehlssystem:

Statt einen eigenen Client zu entwickeln (siehe FAQ "Wie kann ich einen eigenen Clienten entwickeln?"), kannst du unseren vorgefertigten Client per <object>-Tag direkt auf deiner eigenen Webseite einbinden - ganz ohne eigene Entwicklung.

Minimal-Beispiel, das du direkt in deine Seite einfügen kannst:

<object type="text/html" width="560" height="280" data="https://<subdomain>.mein-chatserver.de/Client/">
  <param name="port" value="<port>" />
</object>

Ersetze <subdomain> und <port> durch deine eigenen Werte (zu finden unter Einstellungen > Optionen > Übersicht - siehe FAQ "Was bedeuten System-ID, Mandat, Hostname und Port ...?"). Nutzt du eine eigene Domain, kannst du sie hier alternativ anstelle des Hostnamens einsetzen.

Der Port ist der einzige Pflicht-Parameter. Optional lässt sich der Client farblich und mit eigenem Hintergrund an deine Seite anpassen sowie ein Standard-Raum vorauswählen:

Weitere Parameter und ein Beispiel mit vollständiger Konfiguration:

Auch für die Registrierung neuer Nutzer bieten wir eine Schnittstelle an - zwei Wege stehen dir offen:

Weg 1 - vorgefertigtes Formular: nutze einfach dieses fertige Registrierungsformular per Link oder eingebettet auf deiner Seite (analog zum Client per <object>-Tag einbindbar, siehe FAQ "Wie binde ich den Clienten auf meiner Seite ein?"):

https://<subdomain>.mein-chatserver.de/register/

Weg 2 - eigenes Formular per Script: baust du lieber ein eigenes, optisch angepasstes Formular, sendest du die eingegebenen Daten per Script an unsere Registrierungs-Schnittstelle. Neu registrierte Nutzer tauchen danach automatisch unter Benutzer auf (siehe FAQ "Wie verwalte ich Benutzer meines Chatsystems?").

Eine ausführliche Dokumentation zu Weg 2 findest du hier:

Statt uns außerhalb der Administration per E-Mail zu schreiben, eröffnest du hier direkt ein Support-Ticket - vergleichbar mit einem Chat-Verlauf, nur für deine Anfragen an unseren Support.

Zu finden unter Support > Tickets:

• Ein neues Ticket eröffnest du über "Erstellen" oben rechts.
• Jedes Ticket führt eine eigene, fortlaufende Konversation - deine Nachrichten und unsere Antworten erscheinen chronologisch untereinander.
• Über die Reiter "Offen" und "Geschlossen" wechselst du zwischen laufenden und bereits abgeschlossenen Tickets - auch geschlossene bleiben zum Nachlesen erhalten.

So bleibt der komplette Verlauf deiner Support-Anfragen an einem Ort, statt in verschiedenen E-Mails verteilt zu sein.

Die Übersicht ist die Startseite der Administration und fasst den aktuellen Zustand deines Chatsystems auf einen Blick zusammen, z. B.:

• wie viele Besucher gerade online sind,
• wie viel Speicherplatz (für Bilder/Uploads) bereits belegt ist,
• dein aktuelles Prepaid-Guthaben sowie gebuchtes Paket,
• Schnellzugriffe auf häufig genutzte Bereiche der Administration.

Ideal als erster Anlaufpunkt, um zu sehen, ob gerade alles normal läuft, bevor du in einen bestimmten Bereich wechselst.