Der Kiosk-Modus ist eine eigene Freigabe, unabhängig von der Website-Einbettung. Ein Agent kann als Kiosk verfügbar sein, ohne auf anderen Seiten einbettbar zu sein — und umgekehrt. Anders als beim Einbetten gibt es beim Kiosk keine Liste erlaubter Origins — die einzige Hürde ist der Kiosk-Schalter. Aktiviere ihn daher nur für Agenten, die als öffentliche Vollbild-Seite erreichbar sein sollen.
Voraussetzungen
1
Kiosk-Modus aktivieren
Öffne den Agenten im Dashboard, gehe zum Tab Bereitstellung und aktiviere im Abschnitt Kiosk-URL den Schalter Kiosk-Modus aktivieren. Nur freigegebene Agenten können als Kiosk laufen. Das Umschalten dieses Schalters wird sofort gespeichert — du kannst direkt testen, ohne den Agenten erst manuell zu speichern.
2
Kiosk-URL holen
Kopiere die fertige URL aus dem Dashboard oder scanne den QR-Code mit dem Gerät. Du kannst die URL auch wie unten beschrieben selbst zusammenbauen.
3
Zum Startbildschirm hinzufügen
Öffne die URL auf dem Gerät im Browser und füge sie zum Startbildschirm hinzu. Vom Startbildschirm gestartet läuft sie als echte Vollbild-Web-App, ohne Browser-Bedienelemente.
Schnellstart
AGENT_ID durch die UUID deines Agenten (im Dashboard sichtbar). Öffne die URL direkt im Browser des Geräts — es gibt keinen iframe und keinen Einbettungs-Code zum Einfügen.
Query-Parameter
Alle Optionen werden als Query-Parameter an die/kiosk-URL gehängt. Ungültige Werte fallen automatisch auf den Standard zurück.
string
Standard:"open"
Mikrofon-Modus.
open nimmt während des ganzen Gesprächs auf; ptt aktiviert einen Push-to-Talk-Button, über den der Besucher nur beim Halten spricht. In beiden Modi bleibt das Mikrofon geräteseitig geöffnet — der Mikrofon-Indikator bleibt an — damit die Audiowiedergabe durchgehend in voller Lautstärke läuft, auch auf iPad/iPhone (statt in der leiseren „Anruf”-Lautstärke). Siehe Ton & Lautstärke.string
Standard:"de"
UI-Sprache der Bedienelemente.
de oder en.boolean
Standard:"true"
Ob der „Auflegen”-Button angezeigt wird. Im Kiosk-Modus ist er standardmäßig an, damit ein Besucher das Gespräch beenden kann; mit
endCall=false wird er ausgeblendet.number
Standard:"0"
Auto-Reset-Zeit in Sekunden. Nach dieser Inaktivität — während der Agent auf eine Eingabe wartet — endet das Gespräch und der Start-Screen kehrt für den nächsten Besucher zurück.
0 deaktiviert den Auto-Reset.Die Parameter
border und hideTextChat aus dem Embedding funktionieren hier ebenfalls (Hintergrundfarbe und Ausblenden der Text-Chat-Eingabe).Beispiel mit mehreren Optionen
Mikrofon nicht verfügbar? Kann der Agent nicht auf das Mikrofon zugreifen — etwa weil der Browser den Zugriff nicht erlaubt bekommen hat oder eine andere Anwendung das Mikrofon belegt — zeigt die Seite jetzt einen entsprechenden Hinweis an, und der Push-to-Talk-Button leuchtet beim Halten nicht auf. Prüfe in dem Fall die Mikrofon-Berechtigung der Seite in den Browser-Einstellungen und schließe Anwendungen, die das Mikrofon exklusiv verwenden.
Ton & Lautstärke
Damit der Agent auf einem Aufsteller gut hörbar ist, optimiert der Kiosk die Wiedergabe automatisch — je nach Gerät gibt es aber ein paar Stellschrauben.- iPad/iPhone: Der Ton läuft automatisch in voller Lautstärke, in beiden Mikrofon-Modi.
- Android: Der Kiosk schaltet die Ausgabe automatisch auf den lauten Systemlautsprecher („Speakerphone”) statt auf die leise Ohrmuschel.
Audio-Einstellungen (Zahnrad)
Oben rechts blendet ein Zahnrad-Symbol ein kleines Einstell-Panel ein. Dort kannst du:- die Audioverarbeitung anpassen — Echo-Unterdrückung, Rauschunterdrückung, Auto-Pegel und Stimmisolation (standardmäßig alle aktiv),
- das Audio-Gerät wählen. Auf Android erscheinen hier die Routing-Optionen des Systems, etwa „Speakerphone” (lauter Lautsprecher) und „Headset earpiece” (leise Ohrmuschel). Ist der Ton auf einem Android-Gerät zu leise, wähle hier „Speakerphone”.
Android: Anruf-Lautstärke. Sobald der Ton läuft, zeigt Android neben dem Lautstärkeregler ein kleines Telefonsymbol — die Lautstärke-Taste regelt dann die (getrennte) Anruf-Lautstärke, nicht die Medien-Lautstärke. Dreh sie am Gerät einmalig auf Maximum, damit der Kiosk laut genug ist.
Vollbild auf dem Gerät
Für echtes Vollbild ohne Adressleiste fügst du die Kiosk-URL zum Startbildschirm des Geräts hinzu und startest sie von dort. Nutze dafür das Teilen-Menü des Browsers (z. B. „Zum Startbildschirm hinzufügen”) — die Seite ist als eigenständige Web-App konfiguriert und öffnet sich daher ohne Bedienelemente.Auto-Reset bei Inaktivität
Mit gesetztemidle-Parameter erholt sich ein unbeaufsichtigter Kiosk von selbst: Verlässt ein Besucher das Gespräch, beendet der Agent die Sitzung nach der konfigurierten Inaktivität und kehrt zum Start-Screen zurück — bereit für die nächste Person. Der Timer läuft nur, während der Agent auf eine Eingabe wartet — er unterbricht den Agenten nie beim Sprechen oder Denken, und jede Berührung setzt ihn zurück.