---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configurando o portátil Virtual Agentwidget de bate-papo

# Configurando o portátil Virtual Agentwidget de bate-papo {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

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

* Facilmente configurável
* Fluxo de autenticação de login único (SSO) mais simples
* Conecte-se 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 Portátil Virtual Agentwidget de bate-papo {#use-portable-va-web-client__section_q4m_3qp_r5b}

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

1. [Ative o plug-in de URL personalizado (com.snc.customurl) em sua instância.](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)
2. [Adicione o URL personalizado (que você comprou e registrou anteriormente) à sua instância.](https://www.servicenow.com/docs/access?context=configure-custom-url&version=yokohama&pubname=yokohama-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 [Associando URLs personalizados à sua instância](https://www.servicenow.com/docs/access?context=custom-url&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

## Usando autenticação SSO com o Portátil Virtual Agentwidget de bate-papo {#use-portable-va-web-client__section_bbj_tsp_r5b}

Depois de incorporar o cliente do Virtual Agent, você pode acionar a autenticação SSO do widget de bate-papo, mas somente quando sua instância estiver configurada para usar um provedor de SSO externo. Seu site de hospedagem também deve usar o mesmo provedor de SSO que sua instância. Para obter detalhes sobre como configurar provedores de SSO, consulte [Single Sign-on externo (SSO)](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=yokohama&pubname=yokohama-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 de widget de bate-papo que você especificar. Você também especifica os URLs permitidos que podem ser passados neste script, identificando-os no com.glide.cs.web_client_login_redirect_urlspropriedade do sistema. 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 seguintes propriedades do sistema:

* 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 do widget de bate-papo incorporado, ou seja, como os navegadores renderizam e protegem o conteúdo HTML para Virtual Agente. Atendentebate-papo, em um iframe, antes de incorporar o cliente de bate-papo da web. As diretivas de cabeçalho HTTP que você especifica informam ao navegador se uma página pode ser incorporada em determinados domínios para mitigar as tentativas de ClickJacking. A definição de ambas as 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 o. Now Platforme. ServiceNow®aplicações, esteja ciente de que ele não oferece suporte Virtual Agent.
* **[Configure o Portátil Virtual Agentwidget de bate-papo](https://servicenow-prod.fluidtopics.net/jYurbZmZGhoFVwHqQvsgWA)**   
  Configure o Portátil Virtual Agentwidget de bate-papo a ser executado Virtual Agentem páginas da web de terceiros.
* **[Adicione o Portátil Virtual Agentwidget de bate-papo para um site de terceiros](https://servicenow-prod.fluidtopics.net/3VkFCYF53LGfZxzMMcIFlw)**   
  Para usar o widget de bate-papo portátil para Virtual Agentem páginas da web de terceiros, adicione o código necessário à sua página da web.
* **[Incorporar o. Virtual Agentwidget de bate-papo em uma página da web externa (método legado)](https://servicenow-prod.fluidtopics.net/g7~w1Ut2AjCx4yGoZBAgvQ)**   
  Carregue o. Virtual Agentinterface do widget de bate-papo 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 de login único (SSO) para ser executado automaticamente para usuários convidados que estão usando o widget de bate-papo e não estão conectados.

**Tarefas relacionadas**   

* [Configure o Portátil Virtual Agentwidget de bate-papo](https://servicenow-prod.fluidtopics.net/jYurbZmZGhoFVwHqQvsgWA "Configure o Portátil Virtual Agentwidget de bate-papo a ser executado Virtual Agentem páginas da web de terceiros.")
* [Adicione o Portátil Virtual Agentwidget de bate-papo para um site de terceiros](https://servicenow-prod.fluidtopics.net/3VkFCYF53LGfZxzMMcIFlw "Para usar o widget de bate-papo portátil para Virtual Agentem páginas da web de terceiros, adicione o código necessário à sua página da web.")