Instalar el widget

Una etiqueta de script añadida a las páginas de su sitio. La clave de incrustación es su credencial de tenant.

Encuentre su fragmento de incrustación en Configuración → Chat → Fragmento de incrustación. Tiene este aspecto:

<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>

Péguelo justo antes de la etiqueta de cierre </body> en todas las páginas donde debe aparecer el widget. La mayoría de los sitios lo añaden a una plantilla global — el pie de página de WordPress, un bloque de tema de Shopify, el layout raíz de Next.js, etc.

Qué hacen los atributos

  • data-key — la clave de incrustación de su espacio de trabajo. Se genera automáticamente al crear el espacio de trabajo y puede regenerarse desde la configuración. Esta es la única pieza que identifica su espacio de trabajo — si está presente, el widget carga; si se elimina, el widget no carga.
  • data-reverb-* — configuración de WebSocket. Cuando está presente, el widget recibe nuevos mensajes de agentes al instante mediante WebSocket en lugar de hacer sondeos cada 3 segundos. Deje los marcadores de posición que el asistente del fragmento rellena; no necesita pensar en ellos.
  • async — carga sin bloqueo. Su página se renderiza sin esperar al script del widget.

Después de pegar

Abra su sitio en una nueva pestaña del navegador. La burbuja de chat aparece en la esquina que configuró (predeterminado: abajo a la derecha). Haga clic para abrir el panel; debería mostrar el mensaje de bienvenida de su espacio de trabajo.

Si la burbuja no aparece:

  • Revise la lista de Dominios permitidos en Configuración → Chat. Una lista vacía permite cualquier origen; una lista con valores rechaza todo lo demás.
  • Revise la consola del navegador en busca de errores. Un mensaje "bloqueado por CORS" generalmente significa que el src del fragmento es incorrecto o su CSP nos está bloqueando.
  • Confirme que el fragmento realmente llegó al HTML renderizado (Ver fuente → buscar "nura24").

Regenerar la clave

Configuración → Chat → Fragmento de incrustación → Regenerar. La clave antigua deja de funcionar de inmediato; actualice todas las páginas que la usen antes de regenerar, o el widget desaparecerá silenciosamente.