Configurando o widget de bate-papo portátil Virtual Agent

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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ço ou em Construtor de IU portais.

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

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

    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 sua instância ServiceNow, a URL deverá 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 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.
    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.

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

    Depois de incorporar o cliente do Virtual Agent, você pode, opcionalmente, acionar a autenticação SSO a partir 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 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 condições para executar a autenticação e redirecione os usuários para uma página do widget de bate-papo 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 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 o 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.