Incorporer Engagement Messenger dans votre application Web

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Intégrez le code source du module de messagerie que vous avez configuré dans votre site Web afin de permettre à vos clients de commencer à l’utiliser Engagement Messenger sur votre site Web.

    Avant de commencer

    Pourquoi et quand exécuter cette tâche

    Copiez le code source du module de messagerie que vous avez activé et collez-le dans le fichier HTML du site Web sur lequel vous souhaitez déployer la messagerie.

    Ensuite, selon le type d’authentification que vous avez sélectionné pour votre module de messagerie configuré, vous devrez peut-être écrire du code pour que les fonctions obtiennent le jeton d’ID et pour démarrer et arrêter la session d’un utilisateur connecté dans la messagerie.

    Procédure

    1. Accédez à la Tous > Engagement Messenger > Modules.
    2. Dans la colonne Modifier le module du module de messagerie que vous souhaitez installer sur votre site web, cliquez sur Modifier.
      La vue de configuration guidée s’affiche.
    3. Cliquez sur l’onglet Implémenter .
    4. Si vous avez apporté des modifications à la section Paramètres de sécurité, cliquez sur Enregistrer.
      Le code du Engagement Messenger module est mis à jour.
    5. Faites défiler jusqu’à la section Code intégré et cliquez sur Copier le code.
    6. Ouvrez le fichier HTML de votre site web et collez le code copié avant la balise body de fermeture.
    7. Pour un module de messagerie avec authentification basée sur OIDC ou SAMl, procédez comme suit.
      Type d'authentificationAction
      Basée sur OIDC
      1. Écrivez du code pour la fonction getTokenCallBack().
      2. Appelez la fonction SN_CSM_EC.onLogin() chaque fois que les utilisateurs se connectent à votre site Web.

        Cette fonction permet aux utilisateurs authentifiés de se connecter de manière transparente lorsqu’ils Engagement Messenger se connectent à votre site Web.

      3. Appelez la fonction SN_CSM_EC.onLogout() chaque fois que les utilisateurs se déconnectent de votre site Web.

        Cette fonction permet aux utilisateurs authentifiés de se déconnecter de manière transparente de Engagement Messenger votre site Web.
      Basée sur SAML
      1. Appelez la fonction SN_CSM_EC.onLogin() chaque fois que les utilisateurs se connectent à votre site Web.

        Cette fonction permet aux utilisateurs authentifiés de se connecter de manière transparente lorsqu’ils Engagement Messenger se connectent à votre site Web.

      2. Appelez la fonction SN_CSM_EC.onLogout() chaque fois que les utilisateurs se déconnectent de votre site Web.

        Cette fonction permet aux utilisateurs authentifiés de se déconnecter de manière transparente de Engagement Messenger votre site Web.
      Remarque :
      Pour plus d’informations sur la configuration de l’authentification basée sur OIDC et SAML, consultez l’article Configuration de la connexion et de la déconnexion automatiques pour Engagement Messenger [KB1560205] dans la Now Support base de connaissances.
    8. Si vous avez activé la fonctionnalité de visite pour les utilisateurs non authentifiés, décommentez la //guestWalkupBaseUrl ligne de code et terminez la configuration en saisissant l’URL de base de votre portail d’assistance clientèle.

      Par exemple, si votre portail d’assistance clientèle est https://www.example.com/support, mettez à jour le code en guestWalkupBaseUrl = https://www.example.com/support

      Figure 1. Copier le code Engagement Messenger
      Configurez le module Engagement Messenger à l’aide des étapes mises en évidence. Pour l’implémentation, utilisez le code d’intégration pour résoudre les problèmes d’utilisateurs non authentifiés.
    9. Facultatif : Pour modifier le code incorporé afin de définir la langue préférée dans laquelle Engagement Messenger il est affiché, effectuez l’une des opérations suivantes.
      OptionDescription
      lang : {code ISO-locale} Vous permet de charger Engagement Messenger avec une langue fixe.
      setLang : getEMLangage Permet de changer dynamiquement la langue dans laquelle Engagement Messenger il est affiché. La valeur getEMLangage peut renvoyer n’importe quel code local ISO pouvant être utilisé pour la langue de messagerie.
      La fonction setLang : getEMLangage prend la préférence lorsque les deux paramètres sont disponibles. Toutefois, si l’utilisateur a défini la langue préférée dans la table Engagement Messenger [sys_user_preference], elle sera affichée dans cette langue.
      Remarque :
      À partir de la Australie version, les clients mis à niveau peuvent également modifier le code incorporé pour activer le changement de langue.
    10. Facultatif : Ouvrez le site Web auquel vous avez ajouté le Engagement Messenger code pour vérifier que l’icône de lanceur est disponible et cliquez sur l’icône pour vérifier qu’elle se lance Engagement Messenger.
    11. Facultatif : Modifiez le code d’intégration pour Engagement Messenger intégrer Recommandations proactives sur une page Web.
      Pour plus d’informations sur l’utilisation de l’intégration Engagement Messenger des recommandations proactives sur une page Web, reportez-vous à la section Utiliser Engagement Messenger le code intégré pour intégrer des recommandations proactives sur une page Web.

    Que faire ensuite

    Ouvrez le site Web auquel vous avez ajouté le Engagement Messenger code et vérifiez que l’icône de lancement de la messagerie est disponible. Cliquez sur l’icône pour lancer le Engagement Messenger fichier .

    Vous pouvez également l’intégrer Engagement Messenger dans vos applications iOS et Android natives à l’aide du Kit de développement logiciel (SDK) Now Mobile :