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

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 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çã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 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ção o 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çã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 fizerem login no seu site.

        Esta função permite que usuários autenticados façam login em 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.

      Nota:
      Para obter mais informações sobre a configuração do OIDC e autenticação baseada em SAML, consulte Como configurar login e logout automáticos para o Messenger de compromisso [KB1560205] artigo no Now Support Base de conhecimento.
    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 https://www.example.com/support

      Figura 1. Copie o código do Messenger de compromisso
      Configure o módulo do 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ção for exibido, execute um dos procedimentos a seguir.
      OpçãoDescrição
      Idioma: (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 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ção será exibido nesse idioma.
      Nota:
      Começando com Austrália 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 o. 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 as 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 suas aplicações nativas para iOS e android usando o Now Mobile SDK: