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: Australia
  • Atualizado 12 de mar. de 2026
  • 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 .
    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 copiado 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.
      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á escolhido. 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 .
      5. Habilite o. Habilite recomendações chave 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 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>