Compartir a través de


Referencia del SDK de Chat en directo

La Plataforma omnicanal para Customer Service ofrece un conjunto de funciones que extienden la potencia de Dynamics 365 Customer Service Enterprise con el que las organizaciones pueden conectarse e interactuar de forma instantánea con sus clientes en distintos canales de mensajería digital. Se necesitan una licencia adicional para acceder a la Plataforma omnicanal para Customer Service. Para más información, consulte las páginas Descripción general de precios de Dynamics 365 Customer Service y Plan de precios de Dynamics 365 Customer Service.

Los siguientes métodos de JavaScript se pueden utilizar para realizar varias operaciones con el widget de chat en vivo de la Plataforma omnicanal para Customer Service.

Methods

Método Description
setContextProvider Establece el proveedor de contexto para los canales de chat en vivo. La función de proveedor de contexto, cuando se invoca, devuelve el contexto que se usará para inicializar una sesión de chat.
getContextProvider Recupera el proveedor de contexto personalizado establecido actualmente, si lo hay.
removeContextProvider Quita el proveedor de contexto personalizado establecido actualmente, si lo hay.
setAuthTokenProvider Establece el proveedor de tokens de autenticación.
getAuthTokenProvider Obtiene el proveedor de tokens de autenticación establecido actualmente, si lo hay.
removeAuthTokenProvider Quita el proveedor de token de autenticación establecido actualmente, si lo hay.
startChat Abre un chat existente, si lo hay. De lo contrario, inicia un nuevo chat. Puede usar el customContext parámetro en el método para pasar directamente el contexto para inicializar la sesión de chat
startProactiveChat Permite a las organizaciones involucrar a los usuarios invitándolos automáticamente a una conversación de chat en función de las reglas configuradas.
closeChat Finaliza la conversación entre el agente y el cliente. También se elimina cualquier caché del navegador relacionada con la conversación.
getAgentAvailability Recupera la disponibilidad del agente para una cola en función de las reglas de enrutamiento. El desarrollador omnicanal puede usar esta API para determinar si la opción de iniciar conversación debe ser visible para el cliente y también para mostrar información como el tiempo de espera y la posición en las colas.

Eventos

Event Description
lcw:ready Este evento se genera cuando el SDK de chat en vivo está listo para usarse.
lcw:error Este evento se genera en caso de que se produzca un error durante la duración de un chat. Para obtener información sobre los códigos de error y los mensajes de error, consulte la Referencia de códigos de error para la Plataforma omnicanal para Customer Service.
lcw:startChat Este evento se activa cuando se inicia un chat.
lcw:closeChat Este evento se activa cuando se cierra un chat.
lcw:chatQueued Este evento se genera cuando se crea e inicia la conversación de chat.
lcw:chatRetrieved Este evento se genera cuando el sistema recupera una conversación de chat en curso de la caché después de volver a cargar una página o abrirla en otra pestaña.
lcw:onClose Este evento se activa cuando el cliente que participa en el widget de chat cierra el widget.
lcw:onMinimize Este evento se activa cuando el cliente que participa en el widget de chat minimiza el widget.
lcw:onMaximize Este evento se activa cuando el cliente que participa en el widget de chat maximiza el widget.
lcw:onMessageReceived Este evento se activa cuando el widget de chat recibe un nuevo mensaje.
lcw:onMessageSent Este evento se activa cuando un cliente que participa en el widget de chat envía un nuevo mensaje.
lcw:threadUpdate Este evento se genera mediante el chat en vivo cuando un agente finaliza una conversación.
lcw:getAgentAvailability Este evento se genera cuando el getAgentAvailability método devuelve una respuesta correcta.

Omnicanal para servicio al cliente para desarrolladores