Compartir a través de


Iniciar un chat

Siga estos pasos para iniciar un chat:

  1. Escuche el evento lcw:ready activado por un chat activo para empezar a utilizar los métodos del SDK de chat activo. Los métodos de chat activo deben ser invocados después de activar el evento lcw:ready. Puede escuchar este evento agregando su propio agente de escucha del evento en el objeto de la ventana.

  2. Una vez que activado el evento lcw:ready, llame al método startChat para iniciar un chat.

    Para autenticar a un cliente cuando inicia un chat, consulte Enviar token de autenticación.

    Para iniciar un chat de forma proactiva en función de varios escenarios de clientes en su organización, consulte Inicie un chat de forma proactiva.

Código de ejemplo

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat SDK ready event
	// SDK methods are ready for use now
	// Initiate a chat using startChat SDK
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

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

Considere un escenario en el que el cliente está en su página de portal y usted desea iniciar un chat cuando el cliente haya pasado algún tiempo en la página. Puede abrir mediante programación el widget de chat una vez que haya transcurrido el tiempo especificado.

En el código de ejemplo que se muestra a continuación puede ver cómo se inicia un chat al cabo de 5 minutos de espera del cliente.

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
    // Open chat widget proactively after customer has been waiting for 5 minutes
    setTimeout(function startProactiveChat() {
        Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
    }, 300000);
});

Usar botón de chat personalizado

Para usar un botón de chat personalizado en lugar del botón de chat listo para usar, agregue el atributo data-hide-chat-button en el fragmento de código del widget y establezca su valor en true. Invoque el método startChat en clic del componente personalizado de la interfaz de usuario para iniciar el chat.

Fragmento de código de widget de ejemplo para ocultar el botón de chat estándar

<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>

Consulte también

startChat
Referencia de API JavaScript para SDK de un chat activo
Personalizar el widget de chat
Iniciar un chat de forma proactiva