Instala el widget

El widget de RolChat es un único botón flotante que se adapta a los módulos que tienes activados: el chat, un formulario de solicitud de devolución de llamada, la reserva de reuniones, un formulario de leads y la búsqueda en la base de conocimiento viven dentro de él. Lo instalas una vez; lo que muestra se decide en el panel.

1. Copia el fragmento

En Configuración → Widget, elige el sitio y copia el fragmento de instalación. Tiene este aspecto:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

La clave del widget es pública y se puede incluir sin riesgo en una página. Identifica tu sitio y está firmada, así que nadie puede apuntar una copia del widget a tu cuenta. El panel añade más claves al objeto (saludo, título de la cabecera, tema, horario de atención, diseño por tamaño de pantalla) a medida que cambias la configuración del widget; vuelve a copiar el fragmento después de cambiarla, o deja el objeto mínimo y deja que el widget obtenga el resto.

stub.js ocupa unos pocos kilobytes y carga el resto solo cuando el visitante lo necesita: la interfaz del chat al abrirlo por primera vez, el seguimiento tras el consentimiento y el banner de consentimiento donde sea obligatorio.

2. Pégalo antes de </body>

Añade el fragmento en cada página donde quieras el widget, idealmente mediante la plantilla de tu sitio o tu gestor de etiquetas para que aparezca en todas a la vez. El script se carga de forma asíncrona y no bloquea el renderizado; el paquete de la primera carga es pequeño a propósito para no afectar a tus Core Web Vitals.

3. Comprueba que funciona

Abre tu sitio en una ventana privada. El botón aparece en la esquina que elegiste. En el panel, Visitantes muestra la nueva sesión anónima en tiempo real, y un mensaje enviado desde el widget aparece en la Bandeja de entrada como una conversación nueva.

Identifica a los usuarios con sesión iniciada

Si tus visitantes inician sesión en tu producto, indica a RolChat quiénes son para que las conversaciones se vinculen al contacto correcto:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Los atributos aceptados son email, phone, first_name, last_name, external_id y un objeto plano custom_fields; todo lo demás se ignora. RolChat busca el email en el CRM. Si existe un contacto, la sesión se vincula a él y el agente ve el perfil; si no, los datos se guardan y se crea un lead cuando el visitante escribe por primera vez.

Para una confianza mayor, tu backend puede firmar la identidad: envía junto con los atributos la firma que RolChat emite para el usuario, y la sesión solo se promueve cuando la firma se verifica. Llama a window.rolchat.reset() cuando el usuario cierre sesión; de lo contrario, la siguiente persona en ese navegador verá la conversación anterior.

La API de JavaScript

window.rolchat está disponible en cuanto se ejecuta el stub; las llamadas hechas antes de que se cargue el paquete se ponen en cola y se ejecutan en orden.

Método	Qué hace
show() / hide()	Muestra u oculta el lanzador
open() / close()	Abre o cierra el panel del chat
identify(traits)	Vincula la sesión a una persona (ver arriba)
reset()	Olvida la identidad e inicia una sesión anónima nueva
pushEvent(name, props)	Informa de un evento personalizado para mensajes activados y automatización
trackPageView(path?)	Informa de una vista de página en aplicaciones de una sola página
setLocale(code)	Cambia el idioma del widget
showConsentPreferences()	Abre el centro de preferencias de consentimiento
on(event, handler) / off(event, handler)	Suscripción a chat:opened, chat:closed, message:sent, message:received, session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Idioma y dirección

El widget habla el idioma que fijes con lang en window.rolchatConfig (por ejemplo "lang": "de"); sin él, el idioma del navegador del visitante, tomado en el orden de las preferencias del navegador entre los 40 idiomas que admite RolChat; si ninguno coincide, el inglés. El ajuste de idioma del propio sitio no se usa: para que el widget hable el idioma de tu sitio, define lang. El árabe y el hebreo se muestran de derecha a izquierda. El widget no traduce los mensajes de los agentes; en su lugar, el lado del agente puede usar la traducción en vivo con IA.

Cookies y consentimiento

El widget no hace seguimiento de los visitantes antes del consentimiento allí donde se requiere un banner de consentimiento. Si usas el módulo de Privacidad de RolChat, el banner y el widget comparten un mismo estado de consentimiento. Si usas otra herramienta de consentimiento, los eventos de analítica del widget esperan la señal que configures en Configuración → Privacidad → Insertar.

Dónde se configura el widget

Qué	Dónde
Colores, posición, saludo, puntos de entrada, fragmento de instalación	Configuración → Widget
Qué módulos aparecen dentro del widget	Configuración → Módulos (por sitio)
Horario de atención y mensaje de fuera de línea	Configuración → Sitios → Horario de atención
Mensajes activados que se muestran en páginas concretas	Marketing → Disparadores