WebBlocks Live Chat

Mantenga conversaciones de soporte alojadas en su propio servidor entre visitantes del sitio y operadores del CMS. Los visitantes abren un componente de chat; los operadores leen y responden desde Live Chat en el panel del CMS. No se necesita una cuenta de chat externa ni un servicio WebSocket. Esta guía documenta Live Chat 0.7.1.

Utilice PHP 8.4 o posterior y WebBlocks CMS ^1.95.1, que proporciona el entorno de ejecución necesario de WebBlocks UI. Descargue el ZIP compatible desde la página de Live Chat en el catálogo. Instálelo en Sistema → Plugins, actívelo y compruebe que la configuración de la base de datos haya terminado correctamente. Una aplicación anfitriona antigua puede mostrar una advertencia de salud del plugin; actualícela antes de utilizar esta versión.

Abra Live Chat → Ajustes y seleccione el sitio. Los ajustes generales controlan la activación, disponibilidad en línea/fuera de línea, posición izquierda/derecha, correo obligatorio fuera de línea y notificaciones opcionales a operadores. La disponibilidad se selecciona manualmente; no detecta la presencia de un operador.

Los textos por idioma tienen su propio formulario. Configure título, bienvenida, mensaje fuera de línea y etiqueta del botón de apertura para cada idioma habilitado. Guardar los ajustes generales conserva los textos; guardar los textos conserva los ajustes generales. Los textos ausentes recurren al idioma predeterminado y después al texto heredado existente.

El componente habilitado solo se abre al pulsar su botón. El visitante indica su nombre y, opcionalmente, su correo; puede exigir correo para nuevas conversaciones fuera de línea. Cerrar el componente conserva el borrador no enviado. Tras cerrar una conversación, Iniciar una nueva conversación devuelve al formulario inicial. Los mensajes y respuestas llegan al componente mediante consultas periódicas.

Los operadores necesitan Ver chat en directo para leer conversaciones, Responder al chat en directo para responder o cerrarlas y Administrar chat en directo para configurar el componente. El sitio seleccionado limita la lista y las acciones disponibles.

Utilice las vistas de conversaciones abiertas, pendientes de respuesta, no leídas y cerradas. La búsqueda encuentra nombres, correos y contenido del historial. La vista abierta predeterminada sitúa primero las pendientes de respuesta; también puede ordenar de más recientes a más antiguas o al contrario. No leída y pendiente de respuesta son estados distintos: leer un mensaje no lo responde.

La bandeja y la conversación se actualizan cada cinco segundos mientras son visibles. Leer al final de una conversación visible marca los mensajes del visitante como leídos. Si consulta mensajes anteriores, las novedades no desplazan su posición; Nuevos mensajes lleva a los últimos. Responda, cierre una conversación resuelta o vuelva a abrirla si hace falta más ayuda. Reabrirla permite al visitante responder de nuevo.

Los operadores autorizados también reciben indicadores de no leídas en el menú lateral y avisos dentro del panel para nuevos mensajes. Estos avisos no marcan las conversaciones como leídas ni envían notificaciones del sistema operativo.

Las notificaciones a operadores fuera de línea son opcionales. Configure el destinatario y actívelas solo si las necesita. Los correos de respuesta a visitantes están deshabilitados; las respuestas se entregan mediante el chat.

El contenido y la frecuencia heredan la política de notificaciones del sitio del CMS. Según esta política, se envían inmediatamente, por lotes o en un resumen diario. Los mensajes de solo aviso omiten nombres, direcciones, cuerpos de mensajes y tokens privados de conversación. Los resúmenes diarios siempre incluyen información mínima.

La entrega por lotes/diaria y los recordatorios diarios requieren ejecutar cada minuto el programador de Laravel del servidor. Consulte su salud registrada si el correo queda pendiente. Las notificaciones exclusivamente inmediatas sin recordatorios diarios no necesitan envío programado. Se utiliza la configuración de correo del CMS; una transferencia correcta al transporte no demuestra llegada a la bandeja del destinatario.

El plugin habilitado anuncia sus rutas mediante el descubrimiento de API del CMS y OpenAPI. Utilice GET /webadmin/api/plugins/webblocks-live-chat/settings?site_id=1 con live-chat.read. PATCH o PUT en la misma ruta requieren live-chat.settings.write y una site_id explícita.

Las escrituras solo actualizan los campos enviados y combinan los valores por idioma con los textos existentes. Solo se admiten idiomas habilitados del sitio. Siguen aplicándose las restricciones de sitio del token y el acceso delegado vigente. Consulte la política de capacidades de tokens del CMS instalado; no suponga que activar el plugin concede acceso.

Si falta el botón de apertura, compruebe activación del plugin, sitio seleccionado, activación del componente y compatibilidad de la aplicación anfitriona. El modo fuera de línea cambia el texto inicial; la activación del componente es independiente. Si se interrumpen las respuestas, compruebe si se cerró la conversación. Si hay correo pendiente, revise destinatario, configuración de correo del CMS, política heredada y salud del programador.

Vuelva a la descripción general de plugins, consulte la versión del catálogo o utilice la referencia de la Internal Content API.