Use o widget de bate-papo portátil para adicionar Virtual Agent para sua página da web

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 IU portais.

    O widget de bate-papo portátil é um novo componente sísmico que facilita a adição Virtual Agent bate-papo na 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

    Pré-requisitos para usar o portátil Virtual Agent widget de bate-papo

    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 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 widget de bate-papo em qualquer subdomínio que não seja compartilhado com seu ServiceNow A 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 personalizada (com.snc.customurl) em sua instância.
    2. Adicione a URL personalizada (que você comprou e registrou anteriormente) à sua instância.
    Nota:
    Para saber mais sobre como usar URLs personalizados, consulte Associação de URLs personalizados à sua instância.

    Usando autenticação SSO com o portátil Virtual Agent widget de bate-papo

    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 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.

    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 especificada por você. 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 https://example.com.

    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)
    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 Agent e. Atendente bate-papo, 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 ServiceNow AI Platform e ServiceNow®, lembre-se de que ele não é compatível com Virtual Agent.