---
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


---

# Inicie um recurso em App de mensagens de interaçãousando código personalizado

# Inicie um recurso em App de mensagens de interaçãousando código personalizado {#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

Use o código personalizado para habilitar o link profundo e iniciar um recurso no App de mensagens de interaçãointegrado ao seu site.

## Antes de Iniciar

[Como configurar o App de mensagens de interação](https://servicenow-prod.fluidtopics.net/2dj6wwcFuoqz0_DWXSEXNg "Crie um App de mensagens de interaçãoe configure seu comportamento, aparência e estilo. Ao criar um módulo de messenger, você pode personalizar a aparência e o comportamento de acordo com a identidade visual da sua organização e para atender às necessidades do seu cliente.").

[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.").

Função necessária: ec_admin e administrador do site

## Por Que e Quando Desempenhar Esta Tarefa

Nota:  
Se você estiver usando o código existente, verifique se atualizou o script para mostrar `3,1 `. Por exemplo:  

    <script src="https://example.service-now.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    SN_CSM_EC.init({
          moduleID: "https://example.service-now.com/#aeff0547dd393010f87734cef087e2ba",
          loadFeature: SN_CSM_EC.loadEMFeature()
    });
    </script>

## Procedimento

1. Navegar até App de mensagens de interaçãoMódulos.
2. No módulo Configurar Messenger de compromisso, abra a guia Implemento.
3. Copie o código da seção Código de incorporação.
4. 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.
5. Cole o código que você copiou antes do marcador body de fechamento.
6. Defina o contexto do recurso e especifique as variáveis para o recurso.  
   Use o seguinte formato para definir um contexto de recurso:

       { 
       	feature: "<var class="keyword varname">&lt;feature_name&gt;</var>", 
       	openOnLoad: <var class="keyword varname">&lt;true/false&gt;</var>, 
       	params: { 
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var>",
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var> 
       	} 
       }

   No formato, especifique as variáveis de recurso.

   feature
   :   O nome do recurso. Para obter mais informações, consulte [Parâmetros de contexto do recurso compatíveis em App de mensagens de interação](https://servicenow-prod.fluidtopics.net/DHl72aebt3U3GAgal5QtuQ "Os recursos da capacidade de inicialização contextual permitem que você defina a tela de inicialização padrão em App de mensagens de interação.") .

   OpenOnLoad
   :   Inclua esta opção e defina-a como verdadeiro somente se quiser App de mensagens de interaçãopara abrir automaticamente. A configuração padrão para esta opção é para App de mensagens de interaçãonão abrir automaticamente.

   \<param_name\>": "\<param_value\>
   :   Nome e valor de um parâmetro associado ao recurso. Para obter mais informações, consulte [Parâmetros de contexto do recurso compatíveis em App de mensagens de interação](https://servicenow-prod.fluidtopics.net/DHl72aebt3U3GAgal5QtuQ "Os recursos da capacidade de inicialização contextual permitem que você defina a tela de inicialização padrão em App de mensagens de interação.").
7. Crie uma função de wrapper personalizada para passar o contexto do recurso para `SN_CSM_EC.init `função do código de incorporação.  
   Por exemplo, o código a seguir usa o. `Context() `função de wrapper personalizada para o contexto do recurso de bate-papo.


       function chatFeatureContext(){ 
       	return { 
       			feature: "CHAT",
       			openOnLoad: false,
       			params: { 
       				"topic_id": "8708db281bd5b81080df6247b04bcb79",
       				"language": "fr"		
       				} 
       		  } 
       }

   {#contextual-launch-using-script-engagement-messenger__wrapper-creation}
{#contextual-launch-using-script-engagement-messenger__wrapper-creation}
8. Substitua o. `SN_CSM_EC.LOADEMRECURSO() `função com uma função de wrapper personalizada que você criou em [etapa 7](https://servicenow-prod.fluidtopics.net/4dJoA9GoClAhyuv28Rec~A "Use o código personalizado para habilitar o link profundo e iniciar um recurso no App de mensagens de interaçãointegrado ao seu site.").  
   Por exemplo, no código a seguir, o. `Context() `a função wrapper é passada como o valor de `LoadFeature `atributo.

       SN_CSM_EC.init({ 
       		moduleID: "https://example.service-now.com/#<module_id>", 
       		loadFeature: <var class="keyword varname">chatFeatureContext</var>()
       }); 

9. Salve o arquivo.
10. **Opcional:** Verifique se o recurso designado é iniciado.
    1. Abra o site no qual você incorporou App de mensagens de interação.
    2. Selecione o ícone do inicializador.
    3. Verifique isso App de mensagens de interaçãoinicia o recurso que você configurou no código de incorporação.
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## Resultado

O recurso especificado no código de incorporação é iniciado por padrão quando App de mensagens de interaçãoé aberto no site no qual está incorporado.

## Exemplo

O código a seguir inicia o recurso de bate-papo por padrão. Também mostra como acionar um Virtual Agenttópico por padrão quando o bate-papo é carregado passando o identificador do sistema (sys_id) do tópico. Você também pode especificar um idioma para iniciar o bate-papo nesse idioma.

    <script src="https://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    function chatFeatureContext(){ 
    	return { 
    			feature: "CHAT",
    			openOnLoad: false,
    			params: { 
    				"topic_id": "8708db281bd5b81080df6247b04bcb79",
    				"language": "fr"		
    				} 
    		  } 
    }

    SN_CSM_EC.init({
    	moduleID: "https://example.service-now.com/#d27c94d6db403810a2a6a0ced39619da",
    	loadFeature: chatFeatureContext()
    });
    </script>

função
:   <var class="keyword varname">Context() </var>: A função wrapper para contexto de bate-papo.

feature
:   <var class="keyword varname">BATE-PAPO </var>: O recurso de bate-papo para iniciar Virtual Agentou Atendentebate-papo.

OpenOnLoad
:   <var class="keyword varname">falso </var>: Desabilita a inicialização automática de App de mensagens de interação.

topic_id
:   <var class="keyword varname">8708db281bd5b81080df6247b04bcb79 </var>Identificador do sistema do módulo (sys_id).

idioma
:   <var class="keyword varname">fr </var>: Define o idioma de bate-papo padrão como francês.