Ir al contenido

Widget web

El widget es una burbuja de chat que aparece en una esquina del sitio del cliente y abre el chat del agente. Se inserta con una sola línea de código.

  1. En el Estudio del agente, vista Canales, hacé clic en «Conectar canal» → «Widget web».

  2. Completá:

    Campo Notas
    Nombre Para reconocerlo en la consola: «Widget del sitio web».
    Ambiente «Producción» para el sitio real; «Borrador (prueba)» para un sitio de pruebas.
    Título y Subtítulo Arriba del chat. Por ejemplo «Seguros del Litoral» y «Respondemos al instante».
    Color (opcional) El color del botón y de la burbuja del usuario. Si no lo cambiás, usa el del agente.
    Posición «Abajo a la derecha» (predeterminada) o «Abajo a la izquierda».
  3. Hacé clic en «Crear canal».

La tarjeta del canal muestra el código y el enlace «Ver vista previa» para probarlo antes de insertarlo.

Copiá el código de la tarjeta y pegalo antes de </body> en todas las páginas donde quieras el chat:

<script src="https://app.sherlock.posselab.net/widget.js" data-sherlock="wdg_xxxxxxxxxxxxxxxxxxxxxxxx" async></script>

El valor de data-sherlock identifica el canal. No hace falta configurar nada más en el sitio: el título, el color, la posición, la bienvenida y las preguntas sugeridas se leen de Sherlock cada vez que carga, así que los cambios en la consola se ven sin tocar el código.

  • Un botón redondo fijo en la esquina elegida abre y cierra el panel del chat. En pantallas chicas el panel ocupa casi toda la pantalla.
  • El chat corre en un iframe aislado: no hereda estilos del sitio ni accede a sus datos, y el sitio no accede a la conversación.
  • El chat se carga recién cuando la persona toca el botón, así que no hace más lento el sitio.
  • La conversación se conserva si la persona navega a otra página o recarga.
  • Muestra el mensaje de bienvenida, las preguntas sugeridas, las fuentes citadas y los botones «Útil» / «No útil».
  • Si la conversación se deriva a una persona, muestra el aviso de derivación y las respuestas del operador aparecen en el mismo chat en unos segundos.
  • Si el canal está pausado o se eliminó, el botón no aparece: el sitio no muestra un chat roto.
Del canal (se configura en la tarjeta del widget) Del agente (se configura en el Estudio)
Título, subtítulo, color, posición Mensaje de bienvenida y preguntas sugeridas
Ambiente (Producción o Borrador) Ícono del agente
Todo el comportamiento: instrucciones, conocimiento, guardrails

En un widget de producción, la bienvenida y las preguntas sugeridas son las de la versión publicada: si las cambiás en el borrador, se ven después de publicar.

  • Para dejar de mostrarlo sin tocar el sitio: apagá el interruptor del canal.
  • Si el código se copió en un sitio que no corresponde: «Regenerar credencial» genera un data-sherlock nuevo y el anterior deja de funcionar. Actualizá el código en el sitio.