Uso App de mensagens de interaçãoCódigo incorporado para integrar recomendações proativas em uma página da web

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Modifique o código de incorporação de App de mensagens de interaçãopara 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çãomódulo que você deseja instalar em seu site.
    3. Na coluna Editar módulo, selecione Editar .
    4. No módulo Configurar Messenger de compromisso, selecione Implementar .
    5. Em um editor de texto, abra o arquivo HTML da página da web em 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 que você copiou no arquivo de texto antes do marcador body de fechamento.
    8. Adicione o parâmetro para habilitar recomendações para uma página específica no Messenger EnableRecommendations: Verdadeiro no código de incorporação.
      Quando um usuário insere um termo de pesquisa em App de mensagens de interação, O slug de URL do site (a última parte do URL) é incluído na consulta de pesquisa por padrão. 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á escolhido. Por exemplo, https://example.service-now.com/ .
      • Se um termo estiver cercado por barras no final do URL, o texto incluído 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 como 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çãomódulo.
      3. Selecione Editar.
      4. No módulo Configurar Messenger de compromisso, selecione Comportamento .
      5. Habilite o. Habilite recomendações chave de alternância.
    10. Opcional: Adicione lógica personalizada ao passar um parâmetro de consulta de pesquisa para Pesquisa com IApassando um retorno de chamada de função como o valor de um parâmetro Context 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

    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>