Para qué sirve#
LiveHelp es el chat para tu sitio web: un botón flotante que tus visitantes usan para escribirte. Sus mensajes llegan al Chat de Connecto como cualquier otro canal (aparecen como «Chat web»), con la ventaja de que no tiene ventana de 24 horas ni requiere plantillas.
Quién lo configura: administradores, en Configuración > Canales (ver Configuración de canales y sesiones).
Quién atiende: cualquier asesor, desde el Chat, igual que con WhatsApp u otras redes.
Instalar el widget en tu sitio#
- En Configuración > Canales, crea un widget de chat web (LiveHelp) con los datos de la tabla de abajo. Al guardar, Connecto te entrega la dirección del script del widget.
- Copia esa dirección y pégala en las páginas donde quieras el chat, justo antes de cerrar
</body>:
<script src="https://TU-EMPRESA.TU-DOMINIO/livehelp/widget.php?c=NUMERO_DEL_CANAL" async></script>El dominio es el mismo con el que entras a Connecto y c= es el número del canal que se creó. Si falta ?c=, el widget no se muestra.
- Abre tu sitio: verás el botón redondo abajo a la derecha. No hace falta ninguna otra instalación; el widget funciona en cualquier sitio, sin iniciar sesión.
Datos del widget#
| Campo | Qué hace | Por defecto / límites |
|---|---|---|
| Nombre | Título que se ve en el encabezado del chat. Obligatorio («El nombre del widget es obligatorio.»). | Si se omite, «Chat». |
| Sitio web | Dirección de tu sitio; se guarda con el widget y no cambia su comportamiento. | Vacío |
| Ancho | Ancho del panel en píxeles. | 380 (mínimo 260, máximo 600) |
| Alto | Alto del panel en píxeles. | 560 (mínimo 360, máximo 800) |
| Color | Color del botón, del encabezado y de tus burbujas, en formato #RRGGBB. | #10B981 (verde); si el valor no es válido se usa este |
| Pedir datos al visitante | Si se activa, el visitante llena un formulario y la conversación se crea al enviarlo. Si no, se crea con su primer mensaje. | Apagado |
| Datos del formulario | Nombre, Correo y Teléfono (WhatsApp): de cada uno eliges si se muestra y si es obligatorio. Se pueden añadir campos extra. | Los tres visibles |
| Asunto | No pedirlo, lista que creas por widget, texto libre, o lista con «Otro». Puede ser obligatorio. | No pedir |
| Dominios permitidos | Si los indicas, el chat solo se abre desde esos sitios. | Vacío (cualquiera) |
Un widget inactivo o inexistente no se muestra («Widget no encontrado»). Editar el widget actualiza sus datos sin cambiar la dirección del script.
Qué ve el visitante#
- El botón. Un círculo del color elegido, con un icono de chat, fijo abajo a la derecha de tu sitio.
- El panel. Al hacer clic se abre con el nombre del widget en el encabezado y una × para cerrarlo. La conexión con el chat se abre solo cuando el visitante abre el panel.
- Formulario previo (si lo activaste). La primera vez se pide llenar los campos (y el asunto, si lo configuraste) y pulsar Iniciar conversación; en ese momento se crea la conversación. Si falta un campo obligatorio o el correo/teléfono no son válidos, se le indica. Una vez enviado no se vuelve a pedir en ese navegador.
- El chat. Los mensajes del visitante van a la derecha, con el color del widget; los tuyos a la izquierda, en blanco. Abajo hay un clip para adjuntar, el cuadro «Escribe un mensaje…» y el botón de enviar. Enter envía; Shift+Enter hace un salto de línea.
- Si la conversación es nueva, recibe el mensaje de bienvenida (si está encendido). Si ya había una propia de ese visitante, se muestra su historial. El chat web nunca muestra historial de otras conversaciones, aunque el correo o teléfono coincidan con un contacto existente.
También puede:
- Reaccionar a los mensajes con emojis (la barra aparece al pasar el mouse o al tocar el mensaje; un clic repetido quita la reacción). No puede reaccionar a los mensajes automáticos. Tú ves su reacción en el Chat, y él ve las tuyas.
- Ver citas: si respondes a un mensaje suyo, el widget muestra la cita.
- Responder una encuesta con botones (la de satisfacción u otra) cuando resuelves la conversación. Una vez elegida, el botón queda marcado y no se puede cambiar.
- Ver cuándo lees sus mensajes: mientras el panel está abierto, tus mensajes pasan a «entregado» y luego a «leído».
Adjuntos que envía el visitante#
El clip («Adjuntar archivo») acepta:
| Tipo | Formatos | Máximo |
|---|---|---|
| Imagen | JPG, JPEG, PNG, WEBP | 10 MB |
| Video | MP4, MOV | 30 MB |
| Documento | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, CSV | 30 MB |
| Archivo | ZIP | 30 MB |
Mensajes que puede ver: «Espera a que el chat esté conectado.», «Formato no permitido. Puedes enviar imágenes, videos, PDF, Office, TXT, CSV o ZIP.», «El archivo pesa demasiado (máximo N MB para este tipo).», «Demasiados archivos seguidos. Espera un momento e intenta de nuevo.» (el límite es de 10 adjuntos por minuto en la misma conversación), «Error de red al enviar el archivo.» y «No se pudo enviar el archivo.»
El visitante no puede enviar audios, ubicación ni tarjetas de contacto.
Qué ves tú como asesor#
- La conversación entra a EN ESPERA con el icono de chat de color verde y la etiqueta «Chat web» (en los separadores de historial: «Conversación iniciada por: Chat web»). Un asesor la toma como cualquier otra.
- Contacto: si el correo o el teléfono del formulario ya son de un contacto, se usa ese y solo se le completan los datos que le faltaban; si no, se crea uno nuevo. Si el teléfono es de un contacto y el correo de otro, queda una nota de posible duplicado en ambos. Sin formulario, el contacto nace como «Visitante web XXXX».
- El asunto elegido aparece en el panel de información de la conversación.
- Restricciones del canal: no puedes iniciar una conversación hacia el chat web (solo el visitante la inicia) y no puede incluirse en difusiones.
- Puedes enviarle texto, imágenes, videos, documentos, archivos, ubicación, contactos y mensajes de voz. Ver Enviar mensajes y adjuntos. El visitante ve tus mensajes al instante.
- No hay ventana de 24 horas: puedes escribirle en cualquier momento mientras tenga el panel abierto o vuelva; si cierra la página, verá tus mensajes al volver a abrir el panel.
- Si lo bloqueas, el widget deja de abrir conversación y no recibe respuesta.
Cómo se reconoce al visitante#
El navegador del visitante guarda un identificador anónimo y el número de su conversación. Gracias a eso, si vuelve al sitio desde el mismo navegador retoma la misma conversación y su historial. Si borra los datos del navegador o entra desde otro, se le trata como un visitante nuevo.
<!-- Fuente: tenant-app/public/livehelp/widget.php, tenant-app/public/livehelp/config.php, tenant-app/public/livehelp/upload.php, tenant-app/public/configuracion/livehelp_guardar.php, node/src/server.js (widget_init), node/src/autoMessages.js, shared/src/Core/ChatMedia.php -->