---
sourceDocument: Yokohama Customer Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/customer-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

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

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

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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

* [Incorporado App de mensagens de interaçãoem sua aplicação web](https://servicenow-prod.fluidtopics.net/wuocSoh7U7IqSw102t8~Qg "Incorpore o código-fonte do módulo do messenger que você configurou em seu site para que você possa permitir que seus clientes comecem a usar o. App de mensagens de interaçãoem seu site.").
* [Ative um App de mensagens de interaçãomódulo](https://servicenow-prod.fluidtopics.net/JQyz0f75DU2sDGGAxI8Pyw "Ative o. App de mensagens de interaçãomódulo que você configurou para que possa incorporá-lo ao seu site.").
* Função necessária: sn_csm_ec.ec_admin
{#em-contextual-help__ul_kvl_4pf_g4b}

## Procedimento

1. Navegar até TudoApp de mensagens de interaçãoMó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, <kbd class="ph userinput">https://example.service-now.com/ </kbd>.
   * 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 <kbd class="ph userinput">https://example.service-now.com/product-xyz/ </kbd>, 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 <kbd class="ph userinput">https://example.service-now.com/search_string </kbd>a cadeia de caracteres de pesquisa é considerada como um termo de pesquisa.
   {#em-contextual-help__ul_sbp_3xg_ktb}  
   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 <kbd class="ph userinput">https://example.service-now.com/product-xyz </kbd>, o termo de pesquisa é "product xyz".
   * Qualquer extensão de arquivo é ignorada. Por exemplo, na URL <kbd class="ph userinput">https://example.service-now/product.html </kbd>, o termo de pesquisa é "produto".
   {#em-contextual-help__ul_mz3_2rc_jtb}
9. Habilite recomendações no nível do módulo.
   1. Navegar até TudoApp de mensagens de interaçãoMó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.
   {#em-contextual-help__substeps_xhc_trm_ktb}
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>