Iniciar um recurso em Engagement Messenger usando código personalizado

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura

    • Use o código personalizado para habilitar o link profundo e iniciar um recurso em Engagement Messenger integrado ao seu site.

    Antes de Iniciar

    Configurar Engagement Messenger..

    Incorporar Engagement Messenger 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, certifique-se de atualizar o script para mostrar v=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é Engagement Messenger > Módulos.
    2. No módulo Configurar Engagement Messenger, abra a guia Implementar.
    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 no site ao qual você integra Engagement Messenger.
    5. Cole o código que você copiou antes do marcador do corpo de encerramento.
    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 do recurso.
      feature
      O nome do recurso. Para obter mais informações, consulte Parâmetros de contexto do recurso compatíveis com Engagement Messenger .
      openOnLoad
      Inclua esta opção e defina-a como verdadeira somente se quiser que Engagement Messenger abra automaticamente. A configuração padrão desta opção é que Engagement Messenger não abra 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 Engagement Messenger.
    7. Crie uma função de wrapper personalizada para passar o contexto do recurso para a função SN_CSM_EC.init do código de incorporação.
      Por exemplo, o código a seguir usa a função de wrapper personalizado chatFeatureContext() para o contexto do recurso de bate-papo.
      
function chatFeatureContext(){ 
	return { 
			feature: "CHAT",
			openOnLoad: false,
			params: { 
				"topic_id": "8708db281bd5b81080df6247b04bcb79",
				"language": "fr"		
				} 
		  } 
}
    8. Substitua a função SN_CSM_EC.loadEMFeature() pela função de wrapper personalizado que você criou na etapa 7.
      Por exemplo, no código a seguir, a função de wrapper chatFeatureContext() é passada como o valor do atributo loadFeature .
      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 Engagement Messenger.
      2. Clique no ícone do inicializador.
      3. Verifique se Engagement Messenger inicia o recurso que você configurou no código de incorporação.

    Resultado

    O recurso que você especificou no código de incorporação é iniciado por padrão quando Engagement Messenger é aberto no site ao qual está incorporado.

    Exemplo

    O código a seguir inicia o recurso de bate-papo por padrão. Também mostra como acionar um tópico Virtual Agent 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 de wrapper do contexto de bate-papo.
    feature
    CHAT: o recurso de bate-papo para iniciar o bate-papo Virtual Agent ou Atendente.
    openOnLoad
    false: desabilitar a inicialização automática de Engagement Messenger.
    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.