Incorporer Engagement Messenger dans votre application Web

Incorporez le code source du module de messagerie que vous avez configuré dans votre site Web afin de permettre à vos clients d'utiliser Engagement Messenger sur votre site Web.

Avant de commencer

• Activer un module Engagement Messenger.
• Rôle requis : sn_csm_ec.ec_admin

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 dans 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 le code pour que les fonctions obtiennent le jeton d'ID et pour démarrer et arrêter la session pour 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 dans 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 module Engagement Messenger est mis à jour.
5. Faites défiler la page jusqu'à la section Code incorporé puis cliquez sur Copier le code.
6. Ouvrez le fichier HTML de votre site Web et collez le code copié avant la balise de corps de fermeture.
7. Pour un module de messagerie avec une authentification basée sur OIDC ou SAML, effectuez la configuration suivante.

   Type d'authentification	Action
   Basée sur OIDC	Écrivez le code pour la fonction getTokenCallBack(). 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 à Engagement Messenger de façon transparente lorsqu'ils se connectent à votre site Web. 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 façon transparente de Engagement Messenger et de votre site Web.
   Basée sur SAML	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 à Engagement Messenger de façon transparente lorsqu'ils se connectent à votre site Web. 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 façon transparente de Engagement Messenger et de votre site Web.

   Remarque :

   Pour plus d’informations sur la configuration de l’authentification 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é Visite pour les utilisateurs non authentifiés, annulez le commentaire de la ligne de code //guestWalkupBaseUrl et terminez la configuration en entrant l'URL de base de votre portail d'assistance client.

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

   Figure 1. Copier le code Engagement Messenger

   

9. Facultatif : Pour modifier le code incorporé afin de définir la langue préférée dans laquelle Engagement Messenger s'affiche, effectuez l'une des actions suivantes.

   Option	Description
   lang: {ISO-locale code}	Vous permet de charger Engagement Messenger avec une langue fixe.
   setLang : getEMLanguage	Vous permet de changer dynamiquement la langue dans laquelle Engagement Messenger s'affiche. La valeur getEMLanguage peut renvoyer n'importe quel code ISO-régional qui peut être utilisé pour la langue de la messagerie.

   La fonction setLang : getEMLanguage prévaut lorsque les deux paramètres sont disponibles. Toutefois, si l'utilisateur a défini la langue préférée dans la table [sys_user_preference], Engagement Messenger s'affichera dans cette langue.

   Remarque :

   À partir de la version Washington DC, les clients de mise à niveau peuvent également modifier le code incorporé pour activer le changement de langue.
10. Facultatif : Ouvrez le site Web auquel vous avez ajouté le code Engagement Messenger pour vérifier que l'icône est disponible, et cliquez sur l'icône pour vérifier qu'il lance Engagement Messenger.
11. Facultatif : Modifiez le code incorporé de Engagement Messenger pour intégrer Recommandations proactives sur une page Web.
    Pour plus d’informations sur l’utilisation Engagement Messenger de Recommandations proactives sur une page Web, reportez-vous à la section Utiliser Engagement Messenger le code incorporé pour intégrer des recommandations proactives sur une page Web.

Que faire ensuite

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

Vous pouvez également les intégrer dans vos applications iOS et Android natives Engagement Messenger à l’aide du SDK Now Mobile :

• Intégrer Engagement Messenger dans une application iOS native à l’aide du Kit de développement logiciel (SDK) Now Mobile [KB1587276]
• Intégrer Engagement Messenger dans une application Android native à l’aide du Kit de développement logiciel (SDK) Now Mobile [KB1587611]