Web-Chat-Version steuern

Der JavaScript-Code des Web-Chats folgt semantischen Versionierungsverfahren. Ab der Webchat-Version 7.0.0 können Sie die Version des Webchats, die Sie verwenden möchten, als Konfigurationsoption einstellen.

Wenn Sie keine Version angeben, wird automatisch die neueste Version verwendet (clientVersion: "latest"). Wenn Sie die neueste Version anwenden, profitieren Sie von den kontinuierlichen Verbesserungen, Feature-Ergänzungen und Fehlerkorrekturen, die regelmäßig im Web-Chat vorgenommen werden.

Wenn Sie jedoch umfangreiche Anpassungen auf Ihre Bereitstellung anwenden (z. B. das Überschreiben des Motivs mit Ihrem eigenen angepassten Motiv), können Sie Ihre Bereitstellung für eine bestimmte Version sperren. Durch das Sperren einer Version können Sie neue Versionen testen, bevor Sie sie auf Ihren Live-Web-Chat anwenden.

Um eine bestimmte Version (clientVersion: "major.minor.patch") zu verwenden, geben Sie sie wie folgt an:

Die folgenden Beispiele zeigen, was angegeben werden muss, wenn die aktuelle Version 7.7.1 ist.

  • Wenn Sie bei einer Hauptversion bleiben möchten, aber die neuesten Minor- und Patch-Releases abrufen möchten, geben Sie clientVersion: "7" an.
  • Wenn Sie bei einer Nebenversion bleiben möchten, aber die neuesten Patch-Releases abrufen möchten, geben Sie clientVersion: "7.7.0" an.
  • Wenn Sie eine bestimmte Nebenversion und ein bestimmtes Patch-Release verwenden möchten, geben Sie clientVersion: "7.7.1" an.

Gehen Sie wie folgt vor, um die Aktualisierungen in einem Web-Chat-Release zu testen, bevor Sie die Version auf Ihren Live-Web-Chat anwenden:

  1. Fixieren Sie den Web-Chat, der in Ihrer Produktionsumgebung ausgeführt wird, auf eine bestimmte Version.
  2. Betten Sie Ihre Web-Chat-Implementierung in eine neue Seite in einer Testumgebung ein und überschreiben Sie dann die Einstellung für die Versionssperre. Geben Sie beispielsweise clientVersion: "latest" an.
  3. Testen Sie den Web-Chat und nehmen Sie gegebenenfalls Anpassungen an der Konfiguration vor.
  4. Aktualisieren Sie Ihre Produktionsimplementierung so, dass sie die neueste Version verwendet, und wenden Sie alle anderen Konfigurationsänderungen an, die Sie nach dem Test als erforderlich angesehen haben.

Hier ist ein Beispiel für ein eingebettetes Skript, das die Web-Chat-Version auf " 7.7.0 sperrt.

<html>
  <body>
    <script>
      window.watsonAssistantChatOptions = {
        integrationID: "YOUR_INTEGRATION_ID",
        region: "YOUR_REGION",
        serviceInstanceID: "YOUR_SERVICE_INSTANCE_ID",

        // This is what determines the version of web chat used. Note that this value is also used in the script src below.
        clientVersion: "7.7.0",

        onLoad: function(instance) {
          instance.render();
        },
      };
      setTimeout(function() {
        const t=document.createElement('script');
        t.src="https://web-chat.global.assistant.watson.appdomain.cloud/versions/" + (window.watsonAssistantChatOptions.clientVersion || 'latest') + "/WatsonAssistantChatEntry.js";
        document.head.appendChild(t);
      });
    </script>
  </body>
</html>

Weitere Informationen zu Funktionen, die in früheren Web-Chat-Versionen eingeführt wurden, finden Sie unter Releaseinformationen zum Web-Chat.