Usar App de mensagens de interação Incorporar código para integrar recomendações proativas em uma página da Web

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Modifique o código de incorporação de App de mensagens de interação para habilitar recomendações e aprovar a consulta de pesquisa para recomendações com base em Pesquisa com IA.

    Antes de Iniciar

    Procedimento

    1. Navegar até Tudo > App de mensagens de interação > Módulos.
    2. Selecione App de mensagens de interação módulo que você deseja instalar em seu site.
    3. Na coluna Editar módulo, clique em Editar .
    4. No módulo Configurar Messenger de compromisso, selecione Implementar guia.
    5. Em um editor de texto, abra o arquivo HTML da página da web no seu site ao qual você integra App de mensagens de interação.
    6. Em Implementar Copie o código da seção Código de incorporação.
    7. Cole o código copiado no arquivo de texto antes do marcador body de fechamento.
    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 App de mensagens de interação, quando o usuário insere um termo de pesquisa no messenger , Por padrão, o slug de URL do site (ú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 uma única barra estiver no final do URL, nenhum termo de pesquisa será selecionado. Por exemplo, https://example.service-now.com/ .
      • Se um termo estiver cercado por barras no final do URL, o texto anexado será considerado um termo de pesquisa. Por exemplo, na URL https://example.service-now.com/product-xyz/ , o produto xyz é considerado um termo de pesquisa.
      • Se uma única barra for seguida por texto, esse texto será considerado um termo de pesquisa. Por exemplo, na 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, na URL https://example.service-now.com/product-xyz , o termo de pesquisa é "product xyz".
      • Qualquer extensão de arquivo é ignorada. Por exemplo, na 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é Tudo > App de mensagens de interação > Módulos.
      2. Selecione seu App de mensagens de interação módulo.
      3. Clique em Editar.
      4. No módulo Configurar Messenger de compromisso, selecione Comportamento guia.
      5. Habilite o. Habilitar recomendações comutador de alternância.
    10. Opcional: Adicione lógica personalizada para passar um parâmetro de consulta de pesquisa para Pesquisa com IA passando um retorno de chamada de função como o valor de um parâmetro Context getAsiRecommendationsContext .
      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

    App de mensagens de interação 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>