Trabajar con widgets y eventos de chat en línea
Manejo de widgets y eventos de chat en línea
Puedes personalizar la interacción entre el widget y el comportamiento del chat en vivo, así como el comportamiento de tu sitio web, reaccionando a los eventos JavaScript activados en la página por el código del widget. Hay tres
tipos de eventos disponibles :
- initialize_widget – se activa después de que el widget haya terminado de cargarse en la página del sitio;
- initialize_client : se activa cuando el cliente abre una ventana de diálogo en el chat en línea:
- Si no se configura la entrada de datos, inmediatamente al abrir la ventana de diálogo en el chat en línea;
- Si se configura la entrada de datos, entonces inmediatamente después de enviar los datos y abrir la ventana de diálogo en el chat en línea.
- first_client_message : se activa una vez cuando se envía el primer mensaje de un cliente en un chat en línea.
Ejemplos de escenarios de implementación:
- Cuando el cliente abre un diálogo, se resalta la sección Base de conocimiento en el sitio;
- Cuando un cliente envía su primer mensaje, se muestra un banner con una oferta especial.
Código de ejemplo para el manejo de eventos:
document.addEventListener('first_client_message', ShowBannerFunction)
Activación de widgets y eventos de chat en línea
Puede personalizar la interacción entre el widget y el comportamiento del chat en vivo y el comportamiento de su sitio activando eventos de JavaScript ejecutados por el código del widget.
Hay 2 tipos de eventos disponibles :
- popups:close — este evento cierra la ventana de diálogo en el chat en línea y las ventanas emergentes de widgets adicionales (por ejemplo, la ventana para la comunicación en Viber).
Ejemplo de un escenario de implementación:
- Al hacer clic en el botón para solicitar una devolución de llamada, cerrará la ventana de diálogo en el chat en línea.
Código de ejemplo para llamar a un evento:
document.dispatchEvent(new CustomEvent("popups:close"))
- popups:open — este evento abre la ventana de diálogo en el chat en línea y ventanas emergentes de widgets adicionales (por ejemplo, una ventana para la comunicación en Viber).
Ejemplo de un escenario de implementación:
- Al hacer clic en el botón de orden de devolución de llamada, se abrirá una ventana de diálogo en el chat en línea.
Código de ejemplo para llamar a un evento:
document.dispatchEvent(new CustomEvent("popups:open"))
Configurar notificaciones sobre nuevos mensajes en la pestaña de chat en línea
Puedes añadir un indicador de nuevo mensaje para los visitantes del sitio. Por cada nuevo mensaje de un operador en el chat en línea, puedes configurar la activación del evento new_message , que activará una notificación en el encabezado de la pestaña.
Eventos a integrar:
- new_message — se activa con cada nuevo mensaje del operador y agrega la cantidad de mensajes no leídos al contador unread_count .
- reset_new_message_count : se activa cuando el cliente abre el widget de chat; el contador de mensajes no leídos se restablece a cero, todos los mensajes se marcan como leídos.