Contrôle de la version de discussion Web

Le code JavaScript de discussion Web suit les pratiques de gestion des versions sémantiques. À partir de la version 7.0.0 du chat web, vous pouvez définir la version du chat web que vous souhaitez utiliser en tant qu'option de configuration.

Si vous ne spécifiez pas de version, la dernière version est utilisée automatiquement (clientVersion: "latest"). Lorsque vous appliquez la dernière version, vous bénéficiez des améliorations continues, des ajouts de fonctionnalités et des corrections de bogues qui sont apportées régulièrement à la discussion Web.

Toutefois, si vous appliquez des personnalisations étendues à votre déploiement, par exemple en remplaçant le thème par votre propre thème personnalisé, vous pouvez être amené à verrouiller votre déploiement sur une version spécifique. Le verrouillage d'une version vous permet de tester de nouvelles versions avant de les appliquer à votre discussion Web en direct.

Pour utiliser une version spécifique (clientVersion: "major.minor.patch"), spécifiez comme suit :

Les exemples suivants indiquent les éléments à spécifier lorsque la version en cours est 7.7.1.

  • Si vous souhaitez rester sur une version majeure, mais obtenir les dernières éditions mineures et de correctifs, indiquez clientVersion: "7".
  • Si vous souhaitez rester sur une version mineure, mais obtenir les dernières versions de correctifs, indiquez clientVersion: "7.7.0".
  • Si vous souhaitez verrouiller une version mineure et une édition de correctif spécifiques, indiquez clientVersion: "7.7.1".

Pour tester les mises à jour dans une édition de version de la discussion Web avant d'appliquer la version à votre discussion Web en direct, procédez comme suit :

  1. Verrouillez la discussion Web qui s'exécute dans votre environnement de production vers une version spécifique.
  2. Vous devez intégrer votre déploiement de discussion Web dans une nouvelle page dans un environnement de test, puis remplacer le paramètre de verrouillage de version. Par exemple, indiquez clientVersion: "latest".
  3. Testez la discussion Web et ajustez la configuration si nécessaire.
  4. Mettez à jour votre déploiement de production pour utiliser la dernière version et appliquez toute autre modification de configuration que vous avez jugée nécessaire après les tests.

Voici un exemple de script d'intégration qui verrouille la version du chat en ligne sur " 7.7.0.

<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>

Pour plus d'informations sur les fonctions qui ont été introduites dans les précédentes versions de discussion Web, voir les Notes sur l'édition de la discussion Web.