--- sourceDocument: Gestion du service à la clientèle de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/customer-service-management Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Gestion du service à la clientèle de Yokohama 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: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 * [Activer un Engagement Messenger module](https://servicenow-prod.fluidtopics.net/qzlN~lk0wndUvb2w0joHhA "Activez le Engagement Messenger module que vous avez configuré afin de pouvoir l’intégrer dans 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 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 à TousEngagement MessengerModules. 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'authentification | Action | | 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. {#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 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. {#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é 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 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. | Option | Description | | `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. | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_gmq_3zs_f5b} 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 Yokohama 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 un code intégré pour intégrer des recommandations proactives sur une page Web](https://servicenow-prod.fluidtopics.net/zBjyHL63MVo2W1v0a2dsTg "Modifiez le code d’intégration pour Engagement Messenger activer les recommandations et transmettre la requête de recherche pour les recommandations basées sur Recherche IA."). ## 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 : * [Incorporer Engagement Messenger dans une application iOS native à l'aide du 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 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}