Incorporar App de mensagens de interação em sua aplicação web

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Incorpore o código-fonte do módulo do Messenger que você configurou em seu site para que você possa permitir que seus clientes comecem a usar App de mensagens de interação 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 que você selecionou para o módulo do Messenger configurado, talvez você precise escrever código para funções para obter o token de ID e iniciar e interromper a sessão de um usuário conectado no Messenger.

    Procedimento

    1. Navegar até Todos > App de mensagens de interação > Módulos.
    2. Na coluna Editar módulo do módulo do Messenger que você deseja instalar no seu site, clique em Editar.
      A exibição da configuração assistida é exibida.
    3. Clique na guia Implementar.
    4. Se você tiver feito mudanças na seção Configurações de segurança, clique em Salvar.
      O código do módulo App de mensagens de interação foi 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 da tag do corpo de fechamento.
    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 App de mensagens de interação sem problemas ao fazerem login no seu site.

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

        Esta função permite que usuários autenticados saiam sem problemas de App de mensagens de interação 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 App de mensagens de interação sem problemas ao fazerem login no seu site.

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

        Esta função permite que usuários autenticados saiam sem problemas de App de mensagens de interação 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 de login e logout automáticos do App de mensagens de interação [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 App de mensagens de interação
      Configure o módulo do App de mensagens de interação com a ajuda das etapas realçadas. Para a implementação, use o código de incorporação para corrigir quaisquer problemas de usuário não autenticado.
    9. Opcional: Para modificar o código de incorporação para definir o idioma preferencial no qual App de mensagens de interação é exibido, siga um destes procedimentos.
      OpçãoDescrição
      lang: {código de local ISO} Permite que você carregue App de mensagens de interação com um idioma fixo.
      setLang : getEMLanguage Permite que você alterne dinamicamente o idioma em que App de mensagens de interação é exibido. O valor 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], App de mensagens de interação será exibido nesse idioma.
      Nota:
      A partir da versão Xanadu, 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 App de mensagens de interação para verificar se o ícone do inicializador está disponível e clique no ícone para verificar se ele inicia App de mensagens de interação.
    11. Opcional: Modifique o código de incorporação de App de mensagens de interação para integrar as recomendações proativas em uma página da Web.
      Para obter mais informações sobre como usar App de mensagens de interação para integrar as recomendações proativas em uma página da Web, consulte Use App de mensagens de interação embed Code 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 App de mensagens de interação e verifique se o ícone do inicializador do Messenger está disponível. Clique no ícone para iniciar o App de mensagens de interação.

    Você também pode incorporar App de mensagens de interação em seus aplicativos iOS e Android nativos usando o Now Mobile SDK: