Intégration de la discussion Web sur votre page

Pour ajouter le widget de chat en ligne à votre site web, vous devez intégrer un élément de script généré dans votre source HTML.

L'intégration du chat en ligne est automatiquement incluse pour chaque assistant IA et est configurée séparément pour chaque environnement.

Pour l'intégration du chat en ligne dans une application React, consultez les autres méthodes proposées ici.

Pour ajouter le chat en ligne à votre site web :

  1. Sur la Icône Intégrations page « Intégrations », repérez la vignette « Chat en ligne » et cliquez sur « Ouvrir ». La fenêtre Ouvrir une discussion Web s'ouvre.

  2. Dans le champ Environnement, sélectionnez l'environnement auquel vous souhaitez que le widget de chat Web se connecte. Cliquez sur « Confirmer ».

La page Discussion Web s'ouvre et affiche les paramètres de l'intégration de discussion Web dans l'environnement sélectionné.

Le volet de prévisualisation montre à quoi ressemblera le chat Web lorsqu'il sera intégré dans une page Web. Si vous voyez un message commençant par « There is an error», c'est probablement que vous n'avez pas encore ajouté d'actions à votre assistant IA. Une fois que vous avez ajouté une action, vous pouvez tester la conversation à partir du panneau de prévisualisation.

  1. Cliquez sur l'onglet Embed.

Un fragment de code est généré en fonction de la configuration de la discussion Web. Vous (ou un développeur Web) ajouterez ce fragment de code à la page Web où vous souhaitez que la discussion Web apparaisse.

Ce fragment de code contient un élément HTML script. Le script appelle le code d' JavaScript, hébergé sur un site IBM, et crée une instance d'un widget qui communique avec l 'assistant IA.

  1. Cliquez sur l'icône Icône Copier « Copier dans le presse-papiers » pour copier le script d'intégration dans le presse-papiers.

  2. Éditez la source HTML de la page Web dans laquelle vous souhaitez que le widget de discussion Web apparaisse. Copiez le fragment de code dans la page. Collez le code aussi près possible de la balise de fermeture </body> pour vous assurer que votre page s'affiche plus rapidement.

Ne modifiez pas les valeurs de propriété integrationID ou region dans le script d'intégration généré.

Si vous n'êtes pas prêt à ajouter la discussion Web à un site Web opérationnel, vous pouvez le tester rapidement à l'aide d'un fichier HTML local. Utilisez ce code HTML comme source d'une page de test :

    <html>
    <head></head>
    <body>
        <title>My Test Page</title>
        <p>The body of my page.</p>
        &lt;!-- copied script elements --&gt;
        </body>
    </html>

Copiez ce code dans un fichier portant l'extension " .html et remplacez l'élément " script par le script d'intégration que vous avez copié à l'étape précédente.

Les identifiants du script d'intégration (tels que " integrationID, " serviceInstanceID) ne sont pas considérés comme secrets et sont visibles par toute personne ayant accès à votre site web. Pour plus d'informations, voir Sécurité.

  1. Si le système qui héberge votre site web a un accès limité à Internet (par exemple, si vous utilisez un proxy ou un pare-feu), assurez-vous que les URL qui hébergent le chat web sont accessibles. Pour plus d'informations, voir Accès aux hôtes de chat en ligne.

  2. Ouvrez la page Web (ou le fichier de test local) dans votre navigateur. Vous devriez voir l'icône du Icône de lancement du chat en ligne lanceur s'afficher sur la page.

  3. Cliquez sur l'icône du programme de lancement pour ouvrir la fenêtre de discussion.

  4. Collez le même script d'intégration dans chaque page Web où vous souhaitez que l 'assistant IA soit accessible à vos clients.

Vous pouvez coller la même balise script dans autant de pages de votre site Web que vous le souhaitez. Ajoutez-le partout où vous souhaitez que les utilisateurs puissent contacter votre assistant IA pour obtenir de l'aide. Toutefois, assurez-vous de ne l'ajouter qu'une seule fois sur chaque page.

Vous pouvez désormais tester votre assistant IA et voir ses réponses exactement comme le feraient vos clients.

Toutefois, avant le passage en mode production avec la discussion Web, vous voudrez probablement le personnaliser pour votre site et pour les besoins de vos clients. Pour plus d'informations, consultez la présentation du développement de chats en ligne.