Referencia del widget embed

La mayoría de las personas solo necesita el fragmento copiado desde Configuración → Chat → Fragmento de inserción. Este artículo documenta todos los atributos para quienes necesitan personalizar.

El fragmento predeterminado

<script
  src="https://cdn.nura24.com/widget.js"
  data-key="ek_acme_xyz123"
  data-reverb-key="..."
  data-reverb-host="reverb.nura24.com"
  data-reverb-port="443"
  data-reverb-scheme="https"
  async></script>

Atributos obligatorios

data-key

La clave de inserción de su espacio de trabajo. Sin ella, el script del widget se interrumpe al cargarse — sin interfaz, sin chat. La clave tiene el formato ek_<subdominio>_<aleatorio>.

Se puede regenerar desde la configuración. Al regenerarla, la clave anterior deja de funcionar de inmediato — actualice todas las inserciones antes de regenerar.

src

La URL del JavaScript del widget. Siempre apunta a nuestra CDN; no lo aloje usted mismo (publicamos actualizaciones y correcciones de errores a través de ella).

Atributos de WebSocket (opcionales pero recomendados)

Estos cuatro van juntos. Con ellos, el widget recibe nuevos mensajes vía WebSocket de forma instantánea. Sin ellos, recurre al sondeo cada 3 segundos.

data-reverb-key

La clave de aplicación de Reverb / Pusher para nuestra capa WebSocket. Es información pública — es seguro incluirla en el HTML del lado del cliente.

data-reverb-host

Nombre de host del servidor WebSocket. Normalmente reverb.nura24.com.

data-reverb-port

Puerto — 443 para producción (TLS), 80 para WebSocket sin cifrar en entornos de desarrollo.

data-reverb-scheme

https o http. En producción debe ser https.

Otros atributos

data-api

Reemplaza el endpoint de la API de chat. Por defecto usa el origen del script + /api/chat. Útil si aloja o usa proxy propio.

data-pusher-src

URL para cargar el SDK de Pusher. Por defecto es https://cdn.jsdelivr.net/npm/pusher-js@8/dist/web/pusher.min.js. Solo reemplácelo si necesita empaquetar Pusher en otro lugar por razones de CSP.

async

Atributo HTML estándar. Inclúyalo siempre — el widget no necesita bloquear la renderización de su página.

Qué colocar FUERA de la etiqueta script

Nada. No intente llamar a nuestra API de JavaScript desde su página. El widget es autónomo; abrir, cerrar o establecer la identidad del visitante desde el exterior no está soportado (está planificado, pero aún no implementado).

Cargar en todas las páginas o solo en algunas

Puede colocar el fragmento en su plantilla global (la plantilla de encabezado o pie de página que incluye cada página) o solo en páginas específicas. El widget recuerda la sesión del visitante en localStorage, por lo que la misma conversación persiste entre páginas.

Problemas con CSP

Su Política de Seguridad de Contenido (CSP) debe permitir:

• cdn.nura24.com (fuente de scripts).
• Su host de Reverb en ws:// o wss:// (fuente de conexión).
• cdn.jsdelivr.net (fuente del SDK de Pusher — o dondequiera que haya apuntado data-pusher-src).

Ejemplos específicos de CSP están en Configuración del widget embed.