El widget

El widget es la forma más rápida de poner el asistente en tu producto. Es un único script que monta un lanzador de chat, aislado de tu página para que nada choque.

Integración

Añade una etiqueta de script con tu clave publicable. También puedes instalarlo desde npm o autoalojar el script si lo prefieres.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
  data-position="bottom-right"
></script>

El script debe cargarse como type="module". Ese es el único requisito.

Cómo se carga

El script arranca un pequeño lanzador de inmediato y carga el chat en sí solo cuando un usuario lo abre, así que apenas cuesta nada por adelantado. El chat se ejecuta dentro de un Shadow DOM, de modo que tus estilos y los del widget nunca se afectan entre sí.

Seguro por defecto

Si la clave o un atributo es incorrecto, el widget nunca lanza un error en tu página: registra una advertencia y no muestra nada, y tu clave queda redactada en cualquier mensaje. Una integración rota no puede romper tu aplicación.

Qué puede y qué no puede tocar el widget

El widget está deliberadamente aislado de la página en la que reside. En términos prácticos:

• Se ejecuta dentro de un Shadow DOM, así que sus estilos y los de tu página nunca pueden afectarse entre sí.
• No lee el contenido de tu página, las cookies, el almacenamiento local ni otros scripts: solo trabaja con lo que le entregas explícitamente.
• Usa una clave publicable, que es segura para incluir en el código fuente de tu página: puede iniciar un chat para tu espacio de trabajo y nada más.
• Nunca puede hacer nada que el usuario con sesión iniciada no pudiera hacer por sí mismo: cada acción se ejecuta con su identidad y sus permisos.

Próximos pasos