---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configuração do cliente web Virtual Agent portátil

# Configuração do cliente web Virtual Agent portátil {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

O cliente web portátil é um widget de bate-papo que pode ser executado em páginas da web de terceiros, no portal de serviços ou em portais Construtor de IU.
O cliente web portátil é um novo componente sísmico que facilita a adição de bate-papo Virtual Agent à sua página. Ele simplifica a configuração e fornece os seguintes recursos:

* Facilidade de configuração
* Fluxo de autenticação Single Sign-on (SSO) mais simples
* Conectar ao Portal de serviços Bate-papo do agente
* Os parâmetros do sistema e as variáveis de contexto funcionam da mesma forma que antes
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## Pré-requisitos para usar o cliente web Virtual Agent portátil {#use-portable-va-web-client__section_q4m_3qp_r5b}

O cliente web portátil usa um elemento de quadro em linha (iframe). O site de terceiros deve estar no mesmo domínio primário que sua instância ServiceNow®. Por exemplo, site1.company.com e site2.company.com compartilham o mesmo domínio primário. Se você estiver incorporando o cliente web em qualquer subdomínio que não seja compartilhado com sua instância ServiceNow, o URL deve ser um URL de instância personalizada. Devido ao aumento da segurança do navegador, o cliente Web pode falhar ao carregar se você não usar uma URL personalizada.  
Antes de começar, faça o seguinte:

1. [Ative o plug-in de URL personalizada (com.snc.customurl) em sua instância.](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
2. [Adicione a URL personalizada (que você comprou e registrou anteriormente) à sua instância.](https://www.servicenow.com/docs/access?context=configure-custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
{#use-portable-va-web-client__ol_mtc_4kp_ktb}  
Nota:  
Para saber mais sobre como usar URLs personalizados, consulte [Associação de URLs personalizados à sua instância](https://www.servicenow.com/docs/access?context=custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

## Usar a autenticação SSO com o cliente web Virtual Agent portátil {#use-portable-va-web-client__section_bbj_tsp_r5b}

Depois de incorporar o cliente do Virtual Agent, você pode, opcionalmente, acionar a autenticação SSO do cliente Web, mas somente quando sua instância estiver configurada para usar um provedor SSO externo. Seu site de hospedagem também deve usar o mesmo provedor de SSO da sua instância. Para obter detalhes sobre como definir provedores de SSO, consulte [SSO (Single sign-on) externo](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

Para acionar a autenticação SSO, crie um script JavaScript que defina as condições para executar a autenticação e redirecione os usuários para uma página do cliente Web que você especificar. Você também especifica os URLs permitidos que podem ser passados neste script, identificando-os na propriedade do sistema com.glide.cs.web_client_login_redirect_urls. Especifique os URLs de redirecionamento completos ou a parte do host do URL, como <kbd class="ph userinput">https://example.com</kbd>.  
Este procedimento requer que você defina valores para as duas propriedades do sistema a seguir:

* com.glide.cs.embed.csp_frame_ancestors
* com.glide.cs.embed.xframe_options (Somente IE 11)

{#use-portable-va-web-client__ul_awd_xsp_r5b}Essas propriedades determinam a política de segurança para o cliente da Web incorporado, ou seja, como os navegadores renderizam e protegem o conteúdo HTML para bate-papo Virtual Agent e Atendente, em um iframe, antes de incorporar o cliente de bate-papo da Web. As diretivas de cabeçalho HTTP especificadas informam ao navegador se uma página pode ser incorporada em determinados domínios para reduzir as tentativas de clickjacking. A definição das duas propriedades garante que haja diretivas de segurança para os principais navegadores e também para navegadores mais antigos, como o Internet Explorer.  
Nota:  
Se você estiver usando a aplicação Sistema de gestão de conteúdo (CMS) para criar interfaces personalizadas para as aplicações Now Platform e ServiceNow®, lembre-se de que ele não é compatível com Virtual Agent.
* **[Configurar o cliente da Web portátil do Virtual Agent](https://servicenow-prod.fluidtopics.net/KRcf6xqwonz095rm9hjGXQ)**   
  Configure o widget de bate-papo do cliente web portátil para executar Virtual Agent em páginas da web de terceiros.
* **[Adicionar o cliente web Virtual Agent portátil a um site de terceiros](https://servicenow-prod.fluidtopics.net/eJAXbsBHvwSjAtcO782INw)**   
  Para usar o widget de bate-papo do cliente web portátil para Virtual Agent em páginas da web de terceiros, adicione o código necessário à sua página da web.
* **[Incorporar o cliente web Virtual Agent em uma página da web externa (método legado)](https://servicenow-prod.fluidtopics.net/tWpZxIKaiM0Ee7U93PuZAA)**   
  Carregue a interface do cliente web Virtual Agent em uma página da web externa usando um elemento de quadro em linha (iframe). Opcionalmente, você também pode habilitar o processo de autenticação Single Sign-on (SSO) para ser executado automaticamente para usuários convidados que estão usando o cliente web e não estão conectados.

**Tarefas relacionadas**   

* [Configurar o cliente da Web portátil do Virtual Agent](https://servicenow-prod.fluidtopics.net/KRcf6xqwonz095rm9hjGXQ "Configure o widget de bate-papo do cliente web portátil para executar Virtual Agent em páginas da web de terceiros.")
* [Adicionar o cliente web Virtual Agent portátil a um site de terceiros](https://servicenow-prod.fluidtopics.net/eJAXbsBHvwSjAtcO782INw "Para usar o widget de bate-papo do cliente web portátil para Virtual Agent em páginas da web de terceiros, adicione o código necessário à sua página da web.")