Versionierung von Webkomponenten – Überblick & Leitfaden
Die Versionierungsfunktion für die Webkomponente ist jetzt im Produktivsystem live. Im Folgenden finden Sie alle relevanten Details dazu, wie die Versionierung funktioniert und wie Sie verwalten können, welche Version Sie verwenden.
1. Aktuelle Konfiguration (Legacy-URL)
Sie verwenden derzeit die folgende Build-URL:
🔗 https://assets.theblockbrain.ai/scripts/blocky-chat/blocky-chat.bundle.js
Dies ist die Legacy-URL und wird immer automatisch die neueste Version bereitstellen. Es ist keine Aktion erforderlich, wenn Sie mit dieser URL bei der neuesten Version bleiben möchten.
2. Neue Versionierungs-URLs
Mit der neuen Versionierungsfunktion haben Sie jetzt zwei Möglichkeiten, zu steuern, welche Version der Web-Komponente Sie verwenden:
Option
URL
Beschreibung
Immer die neueste Version
Zeigt jederzeit automatisch auf die neueste Version.
Fixierte Version
Verweist auf eine bestimmte Version (z. B., v1.0.1-rc5). Ersetzen Sie das Versionssegment in der URL, um zu einer anderen Version zu wechseln.
Alle verfügbaren Versionen und Release-Tags werden hier verwaltet und veröffentlicht: 🔗 https://github.com/theblockbrain/b2b-webcomponents/releases Sprache
Die Web-Komponente liefert ihre integrierten UI-Texte – Schaltflächenbeschriftungen, den Titel „New Conversation“ und den Eingabeplatzhalter „Write your message“ – in Englisch (Standard) und Deutsch. Die Sprache wird über den Bundle-Pfad ausgewählt: Fügen Sie das Locale-Segment nach dem Versionssegment hinzu.
Englisch (Standard)
(keins)
https://assets.theblockbrain.io/scripts/blocky-chat/latest/blocky-chat.bundle.js
Englisch (explizit)
/en/
https://assets.theblockbrain.io/scripts/blocky-chat/latest/en/blocky-chat.bundle.js
Deutsch
/de/
https://assets.theblockbrain.io/scripts/blocky-chat/latest/de/blocky-chat.bundle.js
Das Muster funktioniert mit jeder Version: .../scripts/blocky-chat/{version}/{locale}/blocky-chat.bundle.js (z. B. latest/de/ oder v1.0.5/de/).
Um das Widget auf Deutsch umzustellen, ändern Sie nur das Script src — lassen Sie alle anderen Attribute (orgId, uid, userUid, publicToken) unverändert:
Hinweis: Dieser Pfad steuert nur die integrierten statischen Texte der Komponente. Die Willkommensnachricht und die Antworten des Bots folgen den Spracheinstellungen der Plattform und werden von diesem Pfad nicht beeinflusst. Wenn die statischen Beschriftungen auf einer deutschen Seite auf Englisch erscheinen, lädt der Embed das Standard-Bundle (Englisch) — wechseln Sie den
srczum/de/Pfad.
Derzeit sind nur Englisch und Deutsch verfügbar.
3. So wechseln Sie Versionen
Der Wechsel zu einer anderen Version ist ganz einfach:
Wählen Sie die gewünschte Version
Ersetzen Sie das Versionssegment in der URL (z. B. ändern Sie
v1.0.1-rc5durch das neue Versions-Tag).Aktualisieren Sie die Skriptreferenz in Ihrer Integration, damit die neue URL verwendet wird.
Das war's — weitere Konfiguration ist nicht erforderlich.
4. Woher erfahren Sie von neuen Versionen?
Wenn Sie die
/latest/URL verwenden, erhalten Sie immer automatisch die neueste Version.Wenn Sie eine fixierte Versions-URL verwenden, benachrichtigen wir Sie, sobald eine neue Version veröffentlicht wird (einschließlich neuer Funktionen und Release-Tags).
5. Web-Component-Konfiguration
Sie können Ihre Web-Component-Einstellungen direkt in Ihrem Admin-Tab verwalten. Jeder Mandant hat einen eigenen Web-Components-Tab zur Verwaltung seiner spezifischen Konfiguration:
Zuletzt aktualisiert