Para qué sirve#
LiveHelp es el widget de chat en vivo que se instala en tu sitio web. El visitante abre una burbuja de chat y su conversación llega a Connecto como cualquier otro canal. Puedes crear varios widgets (por ejemplo, uno por sitio o por propósito) y personalizar su tamaño, color, formulario previo, asuntos y dominios permitidos.
Quién puede usarlo: administradores.
Cómo llegar: Ajustes de sistema → Canales de mensajería → tarjeta LiveHelp (Web).
La tarjeta «LiveHelp (Web)»#
Todos los widgets van agrupados en una sola tarjeta. Muestra cuántos hay y una flecha para expandir o contraer la lista. Cada fila muestra el nombre, su estado (Activo / Apagado), la fecha de creación y el botón Detalle de canal.
Detalle de canal#
Abre una vista con tres pestañas:
- Dashboard: mensajes y conversaciones del widget por mes.
- Widget: el código para pegar en tu sitio (con botón Copiar código), un resumen de la configuración (tamaño, color, datos, asunto, dominios) y el botón Editar widget, que abre la ventana de edición (también para un widget apagado).
- Configuración: características del widget y la zona de baja: Apagar widget / Encender widget y Eliminar widget.
La ventana «Nuevo widget de chat web» / «Editar widget»#
A la derecha de la ventana hay una vista previa del widget que se actualiza mientras cambias las opciones.
Apariencia#
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Nombre del widget | Nombre en Connecto (obligatorio) | Texto | Vacío |
| Página web | Sitio donde lo instalarás | Texto | Vacío |
| Ancho | Ancho de la ventana de chat (px) | 260 a 600 | 380 |
| Alto | Alto de la ventana de chat (px) | 360 a 800 | 560 |
| Color | Color del botón, el encabezado y las burbujas del visitante | Selector | Verde |
Antes de iniciar la conversación#
El interruptor Pedir datos al visitante decide cómo empieza la conversación:
- Apagado: el visitante abre el chat y la conversación se crea cuando escribe su primer mensaje. Hasta entonces no existe ningún contacto ni conversación.
- Encendido: el visitante llena un formulario y la conversación se crea al enviarlo.
El formulario tiene tres datos fijos, y de cada uno eliges si se muestra y si es obligatorio: Nombre, Correo electrónico y Teléfono (WhatsApp). Con Agregar campo puedes añadir campos extra (se guardan como información adicional del contacto).
Qué pasa con el contacto:
- Si el correo o el teléfono ya pertenecen a un contacto, se usa ese contacto y solo se le completan los datos que le faltaban; nunca se sobrescribe lo que ya tenía.
- Si no existe, se crea un contacto nuevo.
- Si el teléfono pertenece a un contacto y el correo a otro distinto, se usa el del teléfono y se deja una nota de posible duplicado en ambos contactos para que lo revises.
- Si el widget no pide datos, el contacto se crea como «Visitante web XXXX» y se completa después si el visitante los da.
- El teléfono se valida y se guarda con el prefijo del país de operación.
Asunto#
Opcional. ¿Cómo se elige el asunto?
| Modo | Qué ve el visitante |
|---|---|
| No pedir asunto | Nada |
| Elegir de la lista | Un desplegable con los asuntos que creaste |
| Escribirlo libremente | Una caja de texto |
| Elegir de la lista o escribir otro | La lista más la opción «Otro», que abre una caja de texto |
El interruptor El asunto es obligatorio exige elegirlo. Los asuntos de la lista se agregan, ordenan y eliminan (con confirmación) en la propia ventana, por widget. El asunto elegido se guarda en la conversación y aparece en el panel de información del contacto.
Dominios permitidos#
Lista opcional de dominios donde se puede usar el widget (uno por línea). Si la dejas vacía, funciona en cualquier sitio; si la llenas, el chat solo se abre desde esos dominios (y sus subdominios).
Paso a paso: crear o editar un widget#
- Para crear: Agregar canal → Chat web (LiveHelp). Para editar: Detalle de canal → Widget → Editar widget.
- Completa las secciones y revisa la vista previa.
- Pulsa Conectar (al crear) o Guardar cambios (al editar).
- Aparece «Widget creado» con el código. Pulsa Copiar código y pégalo antes de
</body>en tu sitio:
<script src="https://tu-dominio/livehelp/widget.php?c=ID" async></script>
El ancho, el alto y el color se leen al cargar la página, así que cambiarlos no obliga a cambiar el código instalado.
Apagar, encender y eliminar#
- Apagar: el widget deja de funcionar en tu sitio. Encender lo reactiva.
- Eliminar: pide confirmación. No se puede eliminar un widget con conversaciones; en ese caso usa Apagar.
Cómo se ve para el visitante#
- Una burbuja flotante en la esquina inferior derecha, con tu color.
- Con formulario: ve los campos que activaste y Iniciar conversación; los obligatorios llevan asterisco y se validan (correo y teléfono con formato válido).
- Después ve el chat con caja de texto, adjuntos (imágenes, video, documentos y zip) y botón de enviar.
- Nunca ve historial de otros: solo ve su propia conversación, aunque sus datos coincidan con un contacto existente.
- Al abrirse una conversación nueva se envía el mensaje de bienvenida.
- Un contacto bloqueado no abre conversación.
Restricciones propias de este canal#
- Un asesor no puede iniciar una conversación hacia el chat web: solo el visitante la inicia, y no se pueden enviar plantillas.
- El chat web no puede formar parte de las difusiones.
- No usa plantillas ni ventana de 24 horas.
- Hay límites de uso por visitante y por dirección IP contra abusos; si se superan, el chat avisa que intente de nuevo en un momento.
Reglas y comportamientos#
- Las encuestas de satisfacción llegan al visitante como botones dentro del chat.
- Al editar un widget se reescribe toda su configuración con lo que haya en la ventana; revisa antes de guardar.
- No existe pantalla de «Detalle de canal» para el widget: se administra desde esta tarjeta.
<!-- Fuente: tenant-app/public/configuracion/index.php (ventana livehelpConnectModal, funciones lh*), configuracion/livehelp_guardar.php, livehelp/config.php, livehelp/widget.php, shared/src/Core/LiveHelp.php, node/src/server.js y livehelpVisitante.js (widget_init) -->