betool betool

Documentación

Widget de chat web

Widget de chat integrable en cualquier sitio web con un único script JS.

Widget de chat web

El widget de chat es un script JS que integras en tu sitio web (marketing, soporte, aplicación). Abre una burbuja de conversación impulsada por uno de tus pipelines de betool.

Funcionalidades

  • Una sola etiqueta de script para pegar en tu <head>. Sin dependencia npm.
  • Token público — revocable en cualquier momento desde el panel de administración. Sin secreto del lado del cliente.
  • Conversaciones persistentes — los usuarios retoman donde lo dejaron entre visitas.
  • Multi-pipeline — un mismo sitio puede servir varios widgets (preventa, soporte, documentación).

Configuración

  1. Administración → Widgets de chat → Nuevo widget.
  2. Dale un nombre y elige el pipeline de destino.
  3. Copia el fragmento generado:
<script
  src="https://platform.betool.ai/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

El widget aparece en la esquina inferior derecha por defecto.

Personalización

Desde el panel de administración del widget:

  • Apariencia — color de acento, posición, etiquetas.
  • Comportamiento — apertura automática tras X segundos, mensaje de bienvenida.
  • Alcance — restringe los dominios permitidos (CORS).

Seguridad

El token es público por diseño: delimita un único widget. Si alguien lo usa desde un dominio no autorizado, la petición se rechaza del lado del servidor. Para revocar un widget comprometido: Administración → Widgets de chat → Revocar.

Limitaciones

  • Todavía sin co-navegación (el agente no puede ver la página del usuario).
  • El widget no gestiona adjuntos grandes (>10 MB). Para eso, usa un pipeline de email.