---
sourceDocument: Interfaces conversationnelles Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Interfaces conversationnelles Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configurer le widget de messagerie instantanée portable Agent virtuel

# Configurer le widget de messagerie instantanée portable Agent virtuel {#ariaid-title1}

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

Configurez le widget de messagerie instantanée portable Agent virtuel pour qu'il s'exécute Agent virtuel sur des pages Web tierces.

## Avant de commencer

Remarque :  
Pour les nouveaux clients qui s'intègrent à partir de Vancouver, le widget de messagerie instantanée n'est accessible que par défaut aux utilisateurs authentifiés. Pour permettre aux utilisateurs non authentifiés d'accéder au widget de messagerie instantanée, vous devez activer la page sn_va_web_client_app_embed pour l'accès public. Pour plus d'informations, consultez [Make UI pages public or private](https://www.servicenow.com/docs/access?context=t_MakeAPagePublic&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

Rôle requis : admin

## Pourquoi et quand exécuter cette tâche

ServiceNow ne prend en charge le portable Agent virtuel que lorsque le domaine et le nom de domaine de premier niveau correspondent au site qui charge le widget de messagerie instantanée. SSO (Authentification unique) n'est pris en charge que via l'URL service-now.com. Tout ce qui va au-delà nécessitera une solution et une mise en œuvre personnalisées.

## Procédure

1. Accédez à Tout, puis saisissez <kbd class="ph userinput">sys_properties.list</kbd> dans le filtre.
2. Dans la table Propriétés système \[sys_properties\], recherchez la com.glide.cs.embed.csp_frame_ancestors propriété par son nom.
3. Cliquez sur le nom de la propriété pour ouvrir le formulaire et spécifier les valeurs de directives.  
   {#configure-portable-va-web-client__table_mny_mrp_ktb__entry__2}

   | Champ | Description |
   |-|-|
   | Type | chaîne Il s'agit de la valeur par défaut. |
   | Valeur | Valeur source de la directive d'en-tête HTTP : `Content-Security-Policy :frame-ancestors<source>`Cette propriété s'applique à la plupart des principaux navigateurs, à l'exception d'Internet Explorer. Spécifiez une ou plusieurs sources, dont les suivantes : * 'self' : indique que l'origine est la même que la page servie. Par exemple, si la valeur est 'self' http://mywebsite.com, alors l'iframe est incorporé dans le domaine parent ainsi que mywebsite.com. Il s'agit de la valeur par défaut. * host-source : les domaines dans lesquels la page Web externe peut être incorporée. Spécifiez le site hôte Internet par nom, adresse IP ou URL et/ou numéro de port facultatif. L'adresse du site peut commencer par un caractère générique (astérisque). Exemple de valeur : http ://\*.example.com * scheme-source : un schéma. Par exemple : http : ou https : * aucune : aucune URL correspondante. {#configure-portable-va-web-client__ul_nny_mrp_ktb} |
   [ ]

   {#configure-portable-va-web-client__table_mny_mrp_ktb}
4. Revenez à la table Propriétés système \[sys_properties\] pour rechercher la com.glide.cs.embed.xframe_options propriété par nom.
5. Cliquez sur le nom de la propriété pour ouvrir le formulaire et spécifier les valeurs de directives.  
   {#configure-portable-va-web-client__table_mrd_5v5_4qbxxxxx__entry__2}

   | Champ | Description |
   |-|-|
   | Type | chaîne Il s'agit de la valeur par défaut. |
   | Valeur | Valeur de la directive d'en-tête X-Frame-Options, pour indiquer si le navigateur peut afficher une page Web externe dans un cadre. Spécifiez l'une des valeurs suivantes : * sameorigin : affiche la page dans un cadre qui a la même origine que la page elle-même. Il s'agit de la valeur par défaut. Cette propriété s'applique aux navigateurs plus anciens, tels qu'Internet Explorer 11. Exemple de valeur : autoriser à partir de https://example.com * deny : n'affiche pas la page dans un cadre. * URI allow-from : affiche la page uniquement dans un cadre sur l'origine spécifiée. Remarque : Cette valeur ne fonctionne plus dans les navigateurs modernes. {#configure-portable-va-web-client__ul_nrd_5v5_4qb} |
   [ ]

   {#configure-portable-va-web-client__table_mrd_5v5_4qbxxxxx}
6. Configurez les règles CORS pour que l'API REST accorde l'accès à plusieurs domaines.  
   Cette règle donne au domaine web que vous spécifiez les droits d'appeler l'API qui lui donne accès au widget de messagerie instantanée sur la page web sans restriction de sécurité. Tous les domaines doivent partager un domaine parent commun. En outre, vous devez créer une nouvelle règle CORS pour chaque sous-domaine que vous souhaitez prendre en charge.
   1. Accédez à TousServices web du systèmeRESTRègles CORS.
   2. Cliquez sur Nouveau.
   3. Sur le formulaire, renseignez les champs.  
      {#configure-portable-va-web-client__table_cvf_c5p_ktb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom unique de la règle. |
      | Application | Périmètre de l'application. Global est la valeur par défaut. |
      | REST API | Nom de l'API REST. Sélectionnez Compte de consommateur de conversation \[now/cs\]. |
      | Domaine | Le domaine de votre site web. Par exemple : https://mycompany.com Si vous avez plusieurs sous-domaines pour votre site Web, vous devez créer une règle CORS pour chacun d'entre eux. Par exemple, support.mycompany.com et products.mycompany.com nécessiteraient deux règles CORS distinctes. Remarque : Les caractères génériques ne sont pas autorisés. |
      | Durée maximale | Nombre de secondes de mise en cache de la session client. Après une demande CORS initiale, les demandes ultérieures du même client dans le délai spécifié ne nécessitent pas de message préalable au contrôle. Si vous n'indiquez pas de valeur, la valeur par défaut 0 indique que toutes les demandes nécessitent un message de contrôle en amont. |
      [ ]

      {#configure-portable-va-web-client__table_cvf_c5p_ktb}
   4. Dans l'onglet Méthodes HTTP , sélectionnez GET.  
      Le widget de messagerie instantanée portable ne recevra que des demandes.
   5. Cliquez sur Envoyer.
   6. **Facultatif :** Répétez ces étapes si vous souhaitez ajouter le widget de chat portable à un autre sous-domaine de votre site Web.
   {#configure-portable-va-web-client__substeps_jmp_vtp_ktb}
7. **Facultatif :** Créez un script JavaScript qui utilise la méthode (API Web) pour définir les conditions d'événement qui déclenchent l'authentification window.postMessage() SSO dans une page d'interface utilisateur et redirige les utilisateurs vers une page de widget de messagerie instantanée que vous spécifiez.  
   Pour rediriger les utilisateurs vers une page de widget de messagerie instantanée, utilisez la chaîne suivante : `<< https://<votre-instance>.service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri= >> + encodeURIComponent(<votre-page>)`  
   Remarque :  
   Avant d'exécuter le script, utilisez la com.glide.cs.web_client_login_redirect_urls propriété système pour spécifier les URL qui peuvent être transmises dans le script. La redirection fonctionne uniquement lorsque vous spécifiez une ou plusieurs URL autorisées dans la valeur de la propriété. Spécifiez les URL de redirection complètes ou la partie hôte de l'URL. Par exemple : <kbd class="ph userinput">https://example.com</kbd> .  
   Exemple de script

       <script>
           window.addEventListener("message", function(e) {
              // redirect to SSO login if the chat widget logs in but is logged in as a guest user(unauthenticated)
             if(e.data.type==="SESSION_CREATED" && e.data.authenticated === false)
               window.location.href = "https://<your-instance>.service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri=<' + encodeURIComponent(<your-page>);
             
             // redirect to SSO login if the ServiceNow platform logs out from underneath the chat widget
             if(e.data.type==="SESSION_LOGGED_OUT")
               window.location.href = "https://<your-instance>service-now.com/"https://<your-instance>service-now.com/sn_va_web_client_login.do?sysparm_redirect_uri=' + encodeURIComponent(<your-page>);
           });
         </script>

   Dans cet exemple, l'authentification est déclenchée dans l'instance spécifiée lorsque des événements SESSION_CREATED ou SESSION_LOGGED_OUT se produisent. Après l'authentification (lorsque les informations d'identification SSO des utilisateurs sont acceptées), les utilisateurs sont redirigés vers la page du widget de messagerie instantanée incorporé que vous avez spécifiée dans `sn_va-web_client_login.do ?sysparm_redirect_uri=' + encodeURIComponent(<votre-page>),` à condition que vous ayez également spécifié l'URL de la page dans la com.glide.cs.web_client_login_redirect_urls propriété.

## Que faire ensuite

[Ajouter le widget de messagerie instantanée portable Agent virtuel à un site Web tiers](https://servicenow-prod.fluidtopics.net/435zoNpc4eTIZik3uRL0lw "Pour utiliser le widget de messagerie instantanée portable sur Agent virtuel des pages Web tierces, ajoutez le code nécessaire à votre page Web.").