Incorporar Engagement Messenger em sua aplicação web

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura

    • Incorpore o código de origem do módulo do Messenger que você configurou em seu site para que você possa permitir que seus clientes comecem a usar Engagement Messenger em seu site.

    Antes de Iniciar

    Por Que e Quando Desempenhar Esta Tarefa

    Copie o código de origem do módulo do Messenger que você ativou e cole-o no arquivo HTML do site em que deseja implantar o Messenger.

    Em seguida, dependendo do tipo de autenticação selecionado para o módulo do Messenger configurado, talvez seja necessário escrever o código das funções para obter o token de ID e iniciar e parar a sessão de um usuário conectado no Messenger.

    Procedimento

    1. Navegar até Todos > Engagement Messenger > Módulos.
    2. Na coluna Editar módulo do módulo do Messenger que você deseja instalar em seu site, clique em Editar.
      A exibição da configuração assistida é exibida.
    3. Clique na guia Implementar.
    4. Se você tiver feito alguma mudança na seção Configurações de segurança, clique em Salvar.
      O código do módulo Engagement Messenger é atualizado.
    5. Role para baixo até a seção Incorporar código e clique em Copiar código.
    6. Abra o arquivo HTML do seu site e cole o código copiado antes do marcador do corpo de encerramento.
    7. Para um módulo do Messenger com autenticação baseada em OIDC ou SAMl, conclua a configuração a seguir.
      Tipo de autenticaçãoAção
      Baseada em OIDC
      1. Escreva o código para a função getTokenCallBack().
      2. Chame a função SN_CSM_EC.onLogin() sempre que os usuários fizerem login no seu site.

        Esta função permite que usuários autenticados façam login em Engagement Messenger sem problemas ao fazerem login no seu site.

      3. Chame a função SN_CSM_EC.onLogout() sempre que os usuários saírem do seu site.

        Esta função permite que usuários autenticados saiam sem problemas de Engagement Messenger e do seu site.
      Baseada em SAML
      1. Chame a função SN_CSM_EC.onLogin() sempre que os usuários fizerem login no seu site.

        Esta função permite que usuários autenticados façam login em Engagement Messenger sem problemas ao fazerem login no seu site.

      2. Chame a função SN_CSM_EC.onLogout() sempre que os usuários saírem do seu site.

        Esta função permite que usuários autenticados saiam sem problemas de Engagement Messenger e do seu site.
      Nota:
      Para obter mais informações sobre a configuração da autenticação baseada em OIDC e SAML, consulte o artigo Configuração do login e logout automáticos do Engagement Messenger [KB1560205] na Base de conhecimento Now Support.
    8. Se você habilitou o recurso de balcão de serviços para usuários não autenticados, remova o comentário da linha de código //guestWalkupBaseUrl e conclua a configuração inserindo o URL base do portal de suporte ao cliente.

      Por exemplo, se o portal de suporte ao cliente for https://www.example.com/support, atualize o código para guestWalkupBaseUrl = https://www.example.com/support

      Figura 1. Copiar código do Engagement Messenger
      Configure o módulo do Engagement Messenger com a ajuda das etapas realçadas. Para a implementação, use o código de incorporação para corrigir problemas de usuário não autenticado.
    9. Opcional: Para modificar o código de incorporação para definir o idioma preferencial no qual Engagement Messenger é exibido, siga um destes procedimentos.
      OpçãoDescrição
      idioma: {ISO-locale code} Permite que você carregue Engagement Messenger com um idioma fixo.
      setLang : getEMLanguage Permite alternar dinamicamente o idioma em que Engagement Messenger é exibido. O valor de getEMLanguage pode retornar qualquer código de localidade ISO que possa ser usado para o idioma do Messenger.
      A função setLang : getEMLanguage tem preferência quando ambos os parâmetros estão disponíveis. No entanto, se o usuário tiver definido o idioma preferencial na tabela [sys_user_preference], Engagement Messenger será exibido nesse idioma.
      Nota:
      A partir da versão Washington DC, os clientes atualizados também podem modificar o código de incorporação para habilitar a alternância de idioma.
    10. Opcional: Abra o site ao qual você adicionou o código Engagement Messenger para verificar se o ícone do inicializador está disponível e clique no ícone para verificar se ele inicia Engagement Messenger.
    11. Opcional: Modifique o código de incorporação de Engagement Messenger para integrar recomendações proativas em uma página da web.
      Para obter mais informações sobre como usar Engagement Messenger para integrar recomendações proativas em uma página da web, consulte Use o código de incorporação Engagement Messenger para integrar recomendações proativas em uma página da web.

    O que Fazer Depois

    Abra o site ao qual você adicionou o código Engagement Messenger e verifique se o ícone do inicializador do Messenger está disponível. Clique no ícone para iniciar o Engagement Messenger.

    Você também pode incorporar Engagement Messenger em seus aplicativos iOS e Android nativos usando o Now Mobile SDK: