Use o código de incorporação Engagement Messenger para integrar recomendações proativas em uma página da web

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Modifique o código de incorporação de Engagement Messenger para habilitar recomendações e passar a consulta de pesquisa para recomendações com base em Pesquisa com IA.

    Antes de Iniciar

    Procedimento

    1. Navegar até Todos > Engagement Messenger > Módulos.
    2. Selecione o módulo Engagement Messenger que você deseja instalar no seu site.
    3. Na coluna Editar módulo, clique em Editar.
    4. No módulo Configurar Engagement Messenger, selecione a guia Implementar.
    5. Em um editor de texto, abra o arquivo HTML da página da Web no site ao qual você integra Engagement Messenger.
    6. Na guia Implementar, copie o código da seção Código de incorporação.
    7. Cole o código que você copiou no arquivo de texto antes do marcador do corpo de encerramento.
    8. Habilite recomendações para uma página específica no Messenger adicionando o parâmetro enableRecommendations: verdadeiro no código de incorporação.
      No site em que você integra Engagement Messenger, quando o usuário insere um termo de pesquisa no Messenger, por padrão, o slug do URL do site (a última parte do URL) será considerado a consulta de pesquisa. As condições do slug de URL para a consulta de pesquisa inserida na barra de pesquisa do Messenger são as seguintes:
      • Se houver uma única barra no final do URL, nenhum termo de pesquisa será selecionado. Por exemplo, https://example.service-now.com/.
      • Se um termo estiver entre barras no final do URL, o texto incluído será considerado um termo de pesquisa. Por exemplo, no URL https://example.service-now.com/product-xyz/, o produto xyz é considerado um termo de pesquisa.
      • Se uma única barra for seguida de texto, esse texto será considerado um termo de pesquisa. Por exemplo, no URL https://example.service-now.com/search_string, a cadeia de caracteres de pesquisa é considerada um termo de pesquisa.
      O slug de URL é usado para deduzir a consulta de pesquisa da seguinte forma:
      • Todos os caracteres especiais são substituídos por um espaço. Por exemplo, no URL https://example.service-now.com/product-xyz, o termo de pesquisa é "product xyz".
      • Qualquer extensão de arquivo é ignorada. Por exemplo, no URL https://example.service-now/product.html, o termo de pesquisa é "produto".
    9. Habilite recomendações no nível do módulo.
      1. Navegar até Todos > Engagement Messenger > Módulos.
      2. Selecione seu módulo Engagement Messenger.
      3. Clique em Editar.
      4. No módulo Configurar Engagement Messenger, selecione a guia Comportamento.
      5. Habilite o botão de alternância Habilitar recomendações.
    10. Opcional: Adicione lógica personalizada para passar um parâmetro de consulta de pesquisa para o Pesquisa com IA passando um retorno de chamada de função como o valor de um parâmetro getAISRecommendationsContext.
      O exemplo a seguir mostra o código modificado para gerar recomendações proativas com a lógica personalizada para passar uma consulta de contexto de pesquisa.
      ‹script src="https://example.service-now.com/scripts/sn_csm_ec.js"></script>
        ‹script>
        SN_CSM_EC.init({
                    moduleID:"https://instancename.service-now.com/<sys_id>",
                     loadFeature: SN CSM EC. loadEMFeature(),
                     enableRecommendations: true, 
                     getAISRecommendationsContext: function getSearchQuery(){
                     //Insert your code here to fetch the search query string return product xyz
      }
      
        };
        </script>
    11. Salve e publique o arquivo HTML.

    Resultado

    Engagement Messenger mostra recomendações com base no contexto fornecido pelo site de terceiros.

    Exemplo

    O exemplo a seguir mostra o código modificado para gerar recomendações proativas padrão para o contexto padrão.
    ‹script src="https://example.service-now.com/scripts/sn_csm_ec.js"></script>
      ‹script>
      SN_CSM_EC.init({
                  moduleID:"https://instancename.service-now.com/<sys_id>",
                   loadFeature: SN CSM EC. loadEMFeature(),
                   enableRecommendations: true 
                  }
    
      };
      </script>