--- sourceDocument: Gestion du service clientèle Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/customer-service-management Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Gestion du service clientèle Xanadu ft:clusterId : - csm bundleId : - csm workflow : - Customer and Industry --- # Incorporer Engagement Messenger dans votre application Web # Incorporer Engagement Messenger dans votre application Web {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture 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](https://servicenow-prod.fluidtopics.net/M_EwiNI9GguxYcwYV~~idw "Activez le module Engagement Messenger que vous avez configuré de sorte que vous puissiez l'incorporer à votre site Web."). * Rôle requis : sn_csm_ec.ec_admin {#embed-engagement-messenger-code-in-your-web-application__ul_kvl_4pf_g4b} ## 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 ToutEngagement MessengerModules. 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 | 1. Écrivez le 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 à Engagement Messenger de façon transparente lorsqu'ils 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 façon transparente de Engagement Messenger et de votre site Web. {#embed-engagement-messenger-code-in-your-web-application__ol_dns_wtl_p4b} | | 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 à Engagement Messenger de façon transparente lorsqu'ils 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 façon transparente de Engagement Messenger et de votre site Web. {#embed-engagement-messenger-code-in-your-web-application__ol_cmk_25l_p4b} | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_vhq_vtl_p4b} 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. | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_gmq_3zs_f5b} 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 Xanadu, 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 des recommandations proactives dans une page Web, reportez-vous à la section [Utiliser Engagement Messenger le code d'intégration pour intégrer des recommandations proactives sur une page Web](https://servicenow-prod.fluidtopics.net/j38KO4DpOkkt9VDKJUTqrA "Modifiez le code d’intégration de Engagement Messenger pour activer les recommandations et transmettre la requête de recherche pour les recommandations en fonction de Recherche IA."). ## 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 Engagement Messenger dans vos applications iOS et Android natives à l'aide du Kit de développement logiciel (SDK) Now Mobile : * [Incorporer Engagement Messenger dans une application iOS native à l'aide du Kit de développement logiciel (SDK) Now Mobile \[KB1587276\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587276) * [Intégrer Engagement Messenger dans une application Android native à l'aide du Kit de développement logiciel (SDK) Now Mobile \[KB1587611\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587611) {#embed-engagement-messenger-code-in-your-web-application__ul_w2c_2vq_21c}