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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Incorpore o código-fonte do módulo do messenger que você configurou em seu site para 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-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 do Messenger configurado, pode ser necessário escrever o código das 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 guia.
    4. Se você fez alguma mudança na seção Configurações de segurança, clique em Salvar .
      O código do App de mensagens de interação o módulo foi atualizado.
    5. Role para baixo até a seção Código incorporado 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 do 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. Escrever código para ObtoTokenCallBack() função.
      2. Ligue para SN_CSM_EC.ONLOGIN() sempre que os usuários fazem login no seu site.

        Esta função permite que usuários autenticados façam login no App de mensagens de interação perfeitamente 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ção e seu site.

      Baseada em SAML
      1. Ligue para SN_CSM_EC.ONLOGIN() sempre que os usuários fazem login no seu site.

        Esta função permite que usuários autenticados façam login no App de mensagens de interação perfeitamente 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ção e seu site.

    8. Se você habilitou o recurso de balcão de serviços para usuários não autenticados, remova o comentário //guestWalkupBaseUrlLinha de código e 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 e atualize o código para GuestWalkupBaseUrl: https://www.example.com/support

      Figura 1. Copie o código do Messenger de engajamento
      Configure o módulo do Messenger de engajamento 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 for exibido, siga um destes procedimentos.
      OpçãoDescrição
      (Código ISO-locale) Permite que você carregue App de mensagens de interação com 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 pode 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ção será exibido nesse idioma.
      Nota:
      Começando com Zurich versã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 App de mensagens de interação có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ção Para integrar 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 Recomendações proativas em uma página da Web, consulte Usar App de mensagens de interação Incorporar código 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çã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 nativos para iOS e android usando o Now Mobile SDK: