Enviar contexto personalizado durante o chat ao vivo

O contexto personalizado é uma coleção de pares de chaves ou valores. Apenas valores primitivos são permitidos para qualquer chave. As chaves devem corresponder às variáveis de contexto criadas para o fluxo de trabalho associado. Se nenhuma variável de contexto tiver sido criada em fluxo de trabalho ao vivo com um nome lógico correspondente, as variáveis serão criadas em tempo de execução assumindo o tipo como String. O provedor de contexto personalizado seria invocado pelo widget de bate-papo ao vivo quando um novo bate-papo fosse iniciado. Como os valores diferenciam maiúsculas de minúsculas, use a correspondência exata para passá-los para as variáveis de contexto. Para obter mais informações: Considerações para variáveis de contexto

Quando um cliente inicia um bate-papo a partir do portal, você pode passar o contexto personalizado para o Omnichannel for Customer Service. Esse contexto personalizado pode ser usado para exibir informações na interface do usuário e para criar regras de roteamento que eventualmente determinam a fila para a qual você deve rotear os chats.

Siga estas etapas para enviar contexto personalizado ao iniciar um bate-papo:

1. Os métodos SDK do chat ao vivo devem ser invocados após o evento de evento lcw:ready ser gerado. Você pode ouvir esse evento adicionando seu próprio ouvinte de eventos no objeto window.
2. Depois que o lcw:ready evento for gerado, registre um provedor de contexto personalizado com o bate-papo ao vivo usando o método setContextProvider .
3. Inicie o chat usando o método startChat .

Código de exemplo

function contextProvider(){
	//Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string               
	return {
			'contextKey1': 'contextValue1', // string value
			'contextKey2': 12.34, // number value
			'contextKey3': true // boolean value
	};
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat Ready event
	// SDK methods are ready for use now
	// Setting custom context provider to be used with Chat for Dynamics 365
	// The custom context provided by custom context provider can be used for routing the chat to a particular queue
	Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);
	// Starting a new chat
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat SDK error event
	console.log(errorEvent);
});

Para obter informações sobre como exibir as variáveis de contexto no Resumo da conversa, consulte Exibir contexto personalizado.

Informações adicionais

setContextProvider
getContextProvider
removeContextProvider
Referência da API JavaScript do SDK de chat ao vivo
Configurar variáveis de contexto para um bot