Incorporado App de mensagens de interaçãoem sua aplicação web

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 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 o. App de mensagens de interaçãoem seu site.

    Antes de Iniciar

    Por Que e Quando Desempenhar Esta Tarefa

    Copie o código-fonte do módulo do messenger que você ativou e cole-o no arquivo html do site onde você deseja implantar o messenger.

    Em seguida, dependendo do tipo de autenticação selecionado para o módulo de messenger configurado, talvez seja necessário escrever o código para as 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é Tudo > App de mensagens de interação > 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 em Implementar .
    4. Se você tiver feito alguma mudança na seção Configurações de segurança, clique em Salvar .
      O código do App de mensagens de interaçãoo módulo foi atualizado.
    5. Role para baixo até a seção Código de incorporação e clique em Código de cópia .
    6. Abra o arquivo HTML do seu site e cole o código copiado antes do marcador body de fechamento.
    7. Para um módulo de messenger com autenticação baseada em OIDC ou baseada em SAML, conclua a configuração a seguir.
      Tipo de autenticaçãoAção
      Baseada em OIDC
      1. Escreva o código para GetTokenCallBack() função.
      2. Ligue para 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çãoperfeitamente quando eles fazem login no seu site.

      3. Ligue para SN_CSM_EC.ONLOGOUT() sempre que os usuários fazem logout do seu site.

        Esta função permite que usuários autenticados façam logout perfeitamente do App de mensagens de interaçãoe seu site.

      Baseada em SAML
      1. Ligue para 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çãoperfeitamente quando eles fazem login no seu site.

      2. Ligue para SN_CSM_EC.ONLOGOUT() sempre que os usuários fazem logout do seu site.

        Esta função permite que usuários autenticados façam logout perfeitamente do App de mensagens de interaçãoe seu site.

    8. Se você habilitou o recurso de balcão para usuários não autenticados, remova o comentário //guestWalkupBaseUrlE conclua a configuração inserindo o URL base do seu portal de suporte ao cliente.

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

      Figura 1. Copie o código do Messenger de compromisso
      Configure o módulo Messenger de compromisso com a ajuda das etapas destacadas. 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çãofor exibido, execute um dos procedimentos a seguir.
      OpçãoDescrição
      Idioma: (Código ISO-locale) Permite que você carregue App de mensagens de interaçãocom um idioma fixo.
      SetLang : getEMLanguage Permite alternar dinamicamente o idioma no qual App de mensagens de interaçãoé exibido. . GetEMLanguage O valor pode retornar qualquer código ISO-local que possa ser usado para o idioma do messenger.
      . SetLang : getEMLanguage a função 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çãoserá exibido nesse idioma.
      Nota:
      Começando com Yokohamaversão, 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. App de mensagens de interaçãocódigo para verificar se o ícone do inicializador está disponível e clique no ícone para verificar se ele é iniciado App de mensagens de interação.
    11. Opcional: Modifique o código de incorporação de App de mensagens de interaçãoPara integrar recomendações proativas em uma página da web.
      Para obter mais informações sobre como usar App de mensagens de interaçãoPara integrar as recomendações proativas em uma página da web, consulte Uso App de mensagens de interaçãoCódigo incorporado para integrar recomendações proativas em uma página da web.

    O que Fazer Depois

    Abra o site ao qual você adicionou App de mensagens de interaçãoe 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çãoEm suas aplicações nativas para iOS e android usando o Now Mobile SDK: