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: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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é Todos > 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, clique em 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.
      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 da URL do site (a última parte da URL) será considerado a consulta de pesquisa. 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é Todos > App de mensagens de interação > Módulos.
      2. Selecione seu módulo App de mensagens de interação.
      3. Clique em 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 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 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>