Referencia de las SDK de chat activo
La Plataforma omnicaal 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 pueden usarse para realizar distintas operaciones con el widget Live de chat de Omnicanal para servicio al cliente.
Métodos
| método | Descripción |
|---|---|
setContextProvider |
Establece el proveedor de contexto para los canales de chat en vivo. Cuando se invoca la función de proveedor de contextos, este devuelve el contexto que se debe usar para inicializar una sesión de chat. |
getContextProvider |
Recupera el proveedor de contextos personalizado que esté definido en estos momentos, en su caso. |
removeContextProvider |
Quita el proveedor de contextos personalizado que esté definido en estos momentos, en su caso. |
setAuthTokenProvider |
Establece el proveedor de símbolos de autenticación. |
getAuthTokenProvider |
Obtiene el proveedor de símbolos que esté definido en estos momentos, en su caso. |
removeAuthTokenProvider |
Quita el proveedor de símbolos que esté definido en estos momentos, en su caso. |
startChat |
Abre un chat existente, en su caso. De lo contrario, inicia nuevo chat. Puede usar el parámetro customContext en el método para pasar directamente el contexto para inicializar la sesión de chat |
startProactiveChat |
Permite a organizaciones interactuar con usuarios invitándoles automáticamente a una conversación de chat siguiendo las reglas configuradas. |
closeChat |
Finaliza la conversación entre el agente y el cliente. También se elimina cualquier caché del navegador relacionado con la conversación. |
getAgentAvailability |
Recupera la disponibilidad del agente para una cola según las reglas de enrutamiento. El desarrollador omnicanal puede usar esta API para determinar si la opción de inicio de 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
| Evento | Descripción |
|---|---|
lcw:ready |
Este evento se activa cuando el SDK de un chat activo está listo para usarse. |
lcw:error |
Este evento se genera en caso de que se produzca un error durante la vigencia de un chat. Para obtener información sobre los códigos de error y los mensajes de error, consulte la Referencia de código de error para omnicanal para servicio al cliente. |
lcw:startChat |
Este evento se desencadena cuando se inicia un chat. |
lcw:closeChat |
Este evento se desencadena cuando alguien se cierra un chat. |
lcw:chatQueued |
Este evento se activa cuando se crea e inicia la conversación del chat. |
lcw:chatRetrieved |
Este evento se genera cuando una conversación de chat en curso el sistema recupera de la memoria caché después de que se vuelve a cargar una página o se abre en otra pestaña. |
lcw:onClose |
Este evento se activa cuando el cliente que participa en el chat widget 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 el cliente que participa en el widget de chat envía un mensaje nuevo. |
lcw:threadUpdate |
Este evento lo genera el chat en vivo cuando un agente finaliza una conversación. |
lcw:getAgentAvailability |
Este evento se genera cuando el método getAgentAvailability devuelve una respuesta exitosa. |