Iniciar um recurso em App de mensagens de interação usando código personalizado

Versão de lançamento: Zurich

Atualizado 31 de jul. de 2025

2 min. de leitura

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

Antes de Iniciar

Como configurar o App de mensagens de interação.

Incorporar App de mensagens de interação em sua aplicação web.

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 a ser exibido 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

Navegar até App de mensagens de interação > Módulos.
No Módulo Configurar Messenger de compromisso, abra a guia Implementar.
Copie o código da seção Código incorporado.
Em um editor de texto, abra o arquivo HTML da página da web no seu site ao qual você integra App de mensagens de interação.
Cole o código que você copiou antes do marcador corpo de fechamento.
Defina o contexto do recurso e especifique as variáveis do recurso.
Use o seguinte formato para definir um contexto de recurso:
```
{ 
	feature: "<feature_name>", 
	openOnLoad: <true/false>, 
	params: { 
		"<param_name>": "<param_value>",
		"<param_name>": "<param_value> 
	} 
}
```
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 com App de mensagens de interação .

OpenOnLoad

Inclua esta opção e defina-a como verdadeira somente se quiser App de mensagens de interação para abrir automaticamente. A configuração padrão para esta opção é para App de mensagens de interação nã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 com App de mensagens de interação.
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 ChatFeatureContext() 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"		
				} 
		  } 
}
```
Substitua SN_CSM_EC.LOADEMFEATURE() função com uma função de wrapper personalizada que você criou em etapa 7 .
Por exemplo, no código a seguir, o. ChatFeatureContext() a função wrapper é passada como o valor de LoadFeature atributo.
```
SN_CSM_EC.init({ 
		moduleID: "https://example.service-now.com/#<module_id>", 
		loadFeature: chatFeatureContext()
}); 
```
Salve o arquivo.
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ção inicia o recurso configurado no código de incorporação.

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 Agent tó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: ChatFeatureContext() : A função wrapper para contexto de bate-papo.
feature: BATE-PAPO : O recurso de bate-papo para iniciar Virtual Agent ou Atendente bate-papo.
OpenOnLoad: falso Desabilitar a inicialização automática de App de mensagens de interação.
topic_id: 8708db281bd5b81080df6247b04bcb79 Identificador do sistema do módulo (sys_id).
idioma: fr : Define o idioma de bate-papo padrão como francês.