Como configurar o App de mensagens de interação

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 7 min. de leitura
  • Crie um módulo App de mensagens de interação e configure seu comportamento, aparência e estilo. Ao criar um módulo do Messenger, você pode personalizar a aparência e o comportamento de acordo com a identidade visual da sua organização e para atender às necessidades do cliente.

    Antes de Iniciar

    • Instalar a aplicação App de mensagens de interação.
    • Reúna ou prepare os seguintes itens:
      • Arquivos de imagem do seu logotipo e ícone do inicializador do Messenger. As imagens devem estar no formato de arquivo .jpg, .png, .bmp, .gif, .jpeg, .ico ou .svg.
      • Nomes de cores e códigos hexadecimais para identidade visual para configurar o estilo da interface do usuário do Messenger.
    • Função necessária: sn_csm_ec.ec_admin

    Procedimento

    1. Navegar até Tudo > App de mensagens de interação > Módulos.
    2. Escolha criar um módulo App de mensagens de interação ou editar um módulo existente.
      • Para criar um módulo, selecione Novo.
      • Para editar um módulo existente, selecione Editar na coluna Editar módulo do seu módulo do Messenger.
      A exibição da configuração assistida é exibida.
    3. Na exibição de configuração assistida, navegue por Módulo, Aparência, Comportamento, Recursos e Implementar.
    4. No formulário, preencha os campos.
      Tabela 1. Formulário do módulo do App de mensagens de interação
      Campo Descrição
      Módulo
      Nome do módulo Nome exclusivo para o módulo do Messenger.
      Descrição resumida Breve descrição do módulo do Messenger.
      Aparência
      Logotipo

      Logotipo que é exibido no cabeçalho do Messenger no seu site.

      O tamanho e as dimensões recomendados são:
      • Tamanho (em bytes): aproximadamente igual a 2 KB
      • Altura (em pixels): 30–55
      • Largura (em pixels): 30–55
      Nota:
      Se nenhum logotipo for selecionado, o ícone de página inicial ( ícone de página inicial) será exibido como um logotipo padrão no cabeçalho do Messenger.
      Ícone do iniciador

      Ícone que é exibido como a opção do Messenger no seu site. No seu site, a seleção deste ícone inicia o Messenger.

      O tamanho e as dimensões recomendados são:
      • Tamanho (em bytes): aproximadamente igual a 1 KB
      • Altura (em pixels): 24–60
      • Largura (em pixels): 24–60
      • Usar um ícone circular com fundo transparente
      Nota:
      O intervalo de tamanho da grade de um ícone do inicializador é de 24X24 a 60X60. Qualquer desvio do intervalo definido é redimensionado automaticamente para se ajustar ao tamanho do ícone do inicializador.
      Posição do ícone de inicialização

      Posição do ícone de inicialização do Messenger no seu site.

      Permitir que o módulo se expanda para a altura total

      Opção para habilitar o módulo do Messenger para expandir até a altura total da guia do navegador.

      Margem horizontal (em pixels)

      Distância à direita ou à esquerda da guia do navegador para o posicionamento do ícone do inicializador do Messenger.

      A distância é calculada da direita ou da esquerda com base na sua entrada para o campo Posição do ícone de inicialização.

      Por exemplo, se você definir a posição do ícone de inicialização como Direita e o deslocamento horizontal como 50, o ícone de inicialização será colocado a uma distância de 50 px à direita da guia do navegador.

      O valor máximo para este campo é 70 px.

      Margem vertical (em pixels)

      Distância da parte inferior da guia do navegador para o posicionamento do ícone de inicialização do Messenger.

      O valor máximo para este campo é 70 px.

      Cor principal

      Cor primária para estilizar o cabeçalho ou os botões no seu Messenger.

      Por exemplo, esta cor é usada para botões de ação do usuário, como Enviar, Simou OK.

      Cor principal da fonte

      Cor de texto usada em elementos de IU que usam a cor primária.

      Cor secundária

      Cor secundária para estilizar seu Messenger.

      Por exemplo, essa cor é usada para botões de ação do usuário, como Cancelar ou Não.

      Cor secundária da fonte

      Cor de texto usada em elementos de IU que usam a cor secundária.

      Cor terciária

      Cor terciária para estilizar seu Messenger.

      Por exemplo, esta cor é usada para marcar casos de clientes com marcadores como Ação necessária.

      Cor terciária da fonte Cor de texto usada em elementos de IU que usam a cor terciária.
      Tema

      Tema para outras opções de estilo do Messenger.

      Este campo é definido automaticamente como Tema do App de mensagens de interação do CWF.

      Se você quiser selecionar um tema diferente, certifique-se de que o tema selecionado aqui corresponda a determinados critérios. Para obter mais informações, consulte App de mensagens de interação requisitos do tema do módulo.

      Nota:
      Se o valor dos campos Cor primária, Cor secundáriaou Cor terciária estiver definido com nomes de cores, como Rosa, a IU App de mensagens de interação não exibirá essas cores corretamente. Como solução alternativa, você pode inserir os valores hexadecimais dessas cores. Por exemplo, use #FFC0CB para Rosa.
      Comportamento
      Notificação
      Habilitar notificações no ícone do inicializador Opção para habilitar mensagem de alerta de notificação pop-up no aplicativo quando uma nova mensagem for recebida.
      Habilitar sons Opção para obter o som de alerta de notificação.
      Habilitar notificações na guia do navegador Opção para obter o alerta de notificação na guia do navegador quando a página da Web em questão não estiver aberta.
      Habilitar o acompanhamento do comportamento do usuário

      Opção para habilitar a coleta de análise da experiência do usuário de usuários do seu App de mensagens de interação.

      Esta opção estará disponível somente se você ativar o plug-in Análise do Portal de serviços (com.glide.service-portal.analytics) em sua instância ServiceNow.

      Nota:
      Se você atualizar o nome do módulo App de mensagens de interação depois que o acompanhamento de comportamento do usuário estiver habilitado, o painel Análise da experiência do usuário mostrará o nome do módulo original, não o nome atualizado.
      Como administrador, você pode configurar o recurso de recomendações proativas para App de mensagens de interação. Para obter mais informações, consulte Configuração de recomendações proativas para App de mensagens de interação.
      Funcionalidades
      Consulte Definir a configuração do recurso de App de mensagens de interação.
      Implementar
      URLs do Site Lista separada por vírgulas de URLs dos sites onde você deseja implantar o Messenger.

      Por exemplo, https://www.example.com, https://www.yourwebsiteurl.com

      Tipo de autenticação
      Tipo de autenticação para este Messenger integrado. Selecione uma das seguintes opções.
      • Nenhum(a)
      • Baseado em SAML (Security Assertion Markup Language, Linguagem de marcação de asserção de segurança)
      • Baseado em Open ID Connect (OIDC)

      Se você quiser habilitar somente a experiência do usuário convidado para o Messenger em seu site, defina este campo como Nenhum.

      Certifique-se de criar um provedor de identidade (IdP) para o tipo de autenticação selecionado neste campo. Para obter mais informações, consulte Criar um provedor de identidade (IdP) para App de mensagens de interação.

      Identidade visual avançada
      Cor do texto do hiperlink Cor de texto usada para hiperlinks no Messenger.
      Ícone de navegação para trás O ícone aparece no cabeçalho do Messenger que permite ao usuário navegar para a página anterior. O tamanho do ícone é 24X24.
      Ícone de fechamento Este ícone aparece no cabeçalho do Messenger e permite que o usuário feche o Messenger. O tamanho do ícone é 16X16.
      Ícone de pesquisa de lista O ícone aparece no cabeçalho do Messenger que permite pesquisar em uma lista. O tamanho do ícone é 16X16.
      Ícone de expansão O ícone aparece no cabeçalho que permite ao usuário expandir o Messenger para acessar informações. O tamanho do ícone é 16X16.
      Ícone de recolhimento O ícone aparece no cabeçalho do Messenger que permite ao usuário recolher um Messenger expandido. O tamanho do ícone é 16X16.
      Ícone Iniciar bate-papo O ícone aparece no cabeçalho do Messenger que permite ao usuário iniciar um bate-papo com um agente sobre o tíquete ou a visita do técnico. O tamanho do ícone é 16X16.
      Ícone de menu de filtro O ícone aparece na parte superior da página da lista que permite ao usuário aplicar filtros para obter o resultado desejado. O tamanho do ícone é 24X24.
      Ícone de filtros aplicados O ícone aparece na parte superior da página da lista e mostra o ícone de filtros aplicados no Messenger. O tamanho do ícone é 24X24.
      Nota:
      A configuração de identidade visual avançada só está disponível na exibição de formulário.
    5. Selecione Save (Salvar).
    6. Selecione Instruções por e-mail para notificar o administrador de segurança para concluir as seguintes tarefas:
      1. Criar um provedor de identidade (IdP) para App de mensagens de interação.
      2. Configurar uma regra CORS para App de mensagens de interação.
      3. Criar cabeçalhos de resposta HTTP para App de mensagens de interação.
      Nota:
      App de mensagens de interação estende as capacidades do portal de serviços que não são compatíveis com Domain Separation. Para obter mais informações, consulte Domain separation and Service Portal. No entanto, outras tabelas usadas em App de mensagens de interação podem oferecer suporte à separação de domínio de acordo com as configurações com as quais foram criadas.

    Resultado

    Uma nova configuração do Messenger é criada e listada no módulo Módulos da aplicação App de mensagens de interação.

    O que Fazer Depois

    1. Propriedades App de mensagens de interação.
    2. configurar os recursos do App de mensagens de interação.
    3. Compartilhe o código do módulo do Messenger com seu desenvolvedor usando o código de e-mail para incorporar App de mensagens de interação ao seu site.
    4. A seguir estão as mudanças de formatação avançadas que estão disponíveis como uma configuração opcional em App de mensagens de interação: