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

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.

Incorporado 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

1. Navegar até App de mensagens de interação > Mó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: "<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 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çã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 em App de mensagens de interação.

7. Crie uma função de wrapper personalizada para passar o contexto do recurso para o. 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"		
   				} 
   		  } 
   }

8. Substitua o. SN_CSM_EC.LOADEMRECURSO() função com uma função de wrapper personalizada que você criou em etapa 7 .
   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: chatFeatureContext()
   }); 
   

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çã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 em que 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

Context() : 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 : Desabilite a inicialização automática de App de mensagens de interação.

topic_id

8708db281bd5b81080df6247b04bcb79 : O identificador do sistema do módulo (sys_id).

idioma

fr : Define o idioma de bate-papo padrão como francês.