Zum Hauptinhalt springen

Fortgeschritten: Chat-Box-Position über die JavaScript-API

Bestimmen Sie die Position der Chat-Box direkt im Code – flexibel auch für unterschiedliche Positionen auf Desktop und Mobilgeräten.

Verfasst von Michal Jindra

Entwickler können über gezielte Konfigurationsoptionen im Smartsupp-Installationscode exakt steuern, wo die Chat-Box angezeigt wird. In dieser Anleitung erfahren Sie, wie Sie die Chat-Box nach links verschieben, von der Standardposition abweichen und auf Mobilgeräten eine abweichende Platzierung festlegen.

Fortgeschritten: Position im Installationscode festlegen

🟡 Hinweis: Sie benötigen Entwicklerzugriff auf den Code Ihrer Website. Für das Verschieben der Chat-Box auf die linke Seite ist der Solo-Plan oder höher erforderlich.

Fügen Sie die Optionen im Konfigurationsbereich Ihres Installationscodes ein – direkt nach der Zeile mit _smartsupp.key und vor dem Loader (das ist der Code, der mit window.smartsupp|| beginnt). Die Chat-Box liest diese Einstellungen beim Laden aus; stellen Sie daher sicher, dass sie vor dem Start des Loaders eingefügt sind.

So platzieren Sie die Chat-Box auf der linken Seite:

<script>var _smartsupp = _smartsupp || {};_smartsupp.key = 'YOUR_SMARTSUPP_KEY';_smartsupp.orientation = "left";// ...restlicher Installationscode (der Loader)</script>

Um die Chat-Box von der Standardposition abzuheben (Werte in Pixel):

_smartsupp.offsetX = 20;  // verschiebt sie weiter vom Seitenrand weg_smartsupp.offsetY = 100; // verschiebt sie weiter vom unteren Rand nach oben

Eine andere Position nur auf Mobilgeräten einstellen:

<script>var _smartsupp = _smartsupp || {};_smartsupp.key = 'YOUR_SMARTSUPP_KEY';if (window.innerWidth < 768) {  _smartsupp.offsetY = 150;}// ...restlicher Installationscode (der Loader)</script>

So gehen Sie vor:

  1. Öffnen Sie den Code Ihrer Website und suchen Sie das Smartsupp-Installationsskript.

  2. Fügen Sie die gewünschten Optionen direkt nach der Zeile _smartsupp.key und vor dem Loader ein.

  3. Passen Sie die Werte entsprechend Ihrem Design an.

  4. Speichern Sie Ihre Änderungen und laden Sie Ihre Website im Inkognito- oder privaten Modus neu, um die neue Position zu überprüfen. Testen Sie bitte auch die Darstellung auf Mobilgeräten.

💡 Tipp: Befehle wie smartsupp('chat:position', ...) werden nicht unterstützt. Die Chat-Box ignoriert diese, und Ihre Browser-Konsole zeigt "Unknown API command" an. Alle verfügbaren Konfigurationsoptionen finden Sie in der Entwicklerdokumentation.


Wie geht es weiter?

💡 Sie benötigen weitere Unterstützung? Kontaktieren Sie unser Support-Team – wir helfen Ihnen gerne weiter!

Hat dies deine Frage beantwortet?