Use App de mensagens de interação embed Code 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ção para habilitar recomendações e passar a consulta de pesquisa para recomendações baseadas em Pesquisa com IA.

    Antes de Iniciar

    Procedimento

    1. Navegar até Tudo > App de mensagens de interação > Módulos.
    2. Selecione o módulo App de mensagens de interação que você deseja instalar no seu site.
    3. Na coluna Editar módulo, selecione Editar.
    4. No módulo Configurar App de mensagens de interação, selecione a guia Implementar.
    5. Em um editor de texto, abra o arquivo HTML da página da Web no site em que você integra App de mensagens de interação.
    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 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.
      Quando um usuário insere um termo de pesquisa em App de mensagens de interação, o slug da URL do site (a última parte da URL) é incluído na consulta de pesquisa por padrão. As condições de 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 entre ele 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é Tudo > App de mensagens de interação > Módulos.
      2. Selecione seu módulo App de mensagens de interação.
      3. Selecione Editar.
      4. No módulo Configurar App de mensagens de interação, selecione a guia Comportamento.
      5. Habilite o botão de alternância Habilitar recomendações.
    10. Opcional: Adicione lógica personalizada ao 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 getAISRecommendationsContext.
      O exemplo a seguir mostra o código modificado para gerar recomendações proativas com a lógica personalizada para aprovar 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>