Instalación del Widget en tu Sitio Web
Antes de instalar el widget, asegúrate de:
📋 Requisitos Previos
Antes de instalar el widget, asegúrate de:
- ✅ Tener acceso al código HTML de tu sitio
- ✅ Tener el Asistente IA habilitado en tu panel
- ✅ Conocer tu dominio de Sistrack (ej:
tuempresa.sistrack.com)
🚀 Instalación Rápida
Paso 1: Obtener el Código
El código de instalación es:
<script src="https://TUDOMINIO.sistrack.com/ai-assistant/widget.js" async></script>
Reemplaza TUDOMINIO con tu subdominio de Sistrack.
Paso 2: Agregar a tu Sitio
Copia el código y pégalo antes de la etiqueta </body> en tu sitio web.
<!DOCTYPE html>
<html>
<head>
<title>Mi Sitio</title>
</head>
<body>
<!-- Tu contenido aquí -->
<!-- Widget del Asistente IA (agregar aquí) -->
<script src="https://tuempresa.sistrack.com/ai-assistant/widget.js" async></script>
</body>
</html>
Paso 3: Verificar
- Visita tu sitio web
- Busca el botón de chat en la esquina inferior
- Haz clic y envía un mensaje de prueba
📦 Instalación por Plataforma
WordPress
Opción A: Plugin de código personalizado
- Instala el plugin “Insert Headers and Footers”
- Ve a Configuración → Insert Headers and Footers
- En la sección Scripts in Footer, pega:
<script src="https://tuempresa.sistrack.com/ai-assistant/widget.js" async></script> - Guarda los cambios
Opción B: Editar tema directamente
- Ve a Apariencia → Editor de temas
- Selecciona
footer.php - Agrega el código antes de
</body> - Guarda
⚠️ Nota: Si usas un tema hijo, edita el
footer.phpdel tema hijo.
Shopify
- Ve a Tienda Online → Temas
- Haz clic en Acciones → Editar código
- Busca
theme.liquid - Encuentra la etiqueta
</body> - Agrega el código justo antes
- Guarda
WooCommerce
Igual que WordPress (ver arriba).
Wix
- Ve a Configuración → Avanzado → Código personalizado
- Haz clic en + Agregar código personalizado
- Pega el código
- En “Ubicación”, selecciona Body - end
- En “Páginas”, selecciona Todas las páginas
- Guarda
Squarespace
- Ve a Configuración → Avanzado → Inyección de código
- En la sección Footer, pega el código
- Guarda
HTML Estático
Agrega directamente en cada página antes de </body>:
<script src="https://tuempresa.sistrack.com/ai-assistant/widget.js" async></script>
⚙️ Opciones Avanzadas
Cargar en Páginas Específicas
Si solo quieres el widget en ciertas páginas:
<script>
// Solo cargar en páginas de productos o contacto
if (window.location.pathname.includes('/productos') ||
window.location.pathname.includes('/contacto')) {
var script = document.createElement('script');
script.src = 'https://tuempresa.sistrack.com/ai-assistant/widget.js';
script.async = true;
document.body.appendChild(script);
}
</script>
Retrasar la Carga
Para mejorar el rendimiento, carga después de que el sitio esté listo:
<script>
window.addEventListener('load', function() {
setTimeout(function() {
var script = document.createElement('script');
script.src = 'https://tuempresa.sistrack.com/ai-assistant/widget.js';
script.async = true;
document.body.appendChild(script);
}, 2000); // Espera 2 segundos después de cargar
});
</script>
🔍 Verificación de Instalación
Lista de Verificación
| Paso | ¿Completado? |
|---|---|
| Código agregado al sitio | ☐ |
| Widget visible en la esquina | ☐ |
| Al hacer clic se abre el chat | ☐ |
| Puedo enviar un mensaje | ☐ |
| Recibo respuesta del asistente | ☐ |
Herramientas de Verificación
Consola del Navegador:
- Abre tu sitio
- Presiona
F12oCtrl+Shift+I - Ve a la pestaña Console
- Busca mensajes de “AI Assistant”
Si ves errores, revisa:
- El dominio en el script es correcto
- No hay bloqueadores activos
- El asistente está habilitado
🚨 Solución de Problemas
El widget no aparece
Causas posibles:
| Causa | Solución |
|---|---|
| Código mal ubicado | Verifica que esté antes de </body> |
| Dominio incorrecto | Revisa la URL del script |
| Asistente deshabilitado | Actívalo en el panel |
| Bloqueador de anuncios | Desactiva temporalmente para probar |
| Error de JavaScript | Revisa la consola del navegador |
Widget aparece pero no funciona
Causas posibles:
| Causa | Solución |
|---|---|
| Sin conexión a API | Verifica tu conexión a internet |
| Límite alcanzado | Revisa el uso mensual |
| Error de configuración | Contacta a soporte |
Widget se ve mal
Causas posibles:
| Causa | Solución |
|---|---|
| CSS conflictivo | Usa inspector para identificar |
| Posición incorrecta | Cambia en configuración |
| Responsive issues | Prueba en diferentes tamaños |
📱 Compatibilidad
Navegadores Soportados
| Navegador | Versión Mínima |
|---|---|
| Chrome | 80+ |
| Firefox | 75+ |
| Safari | 13+ |
| Edge | 80+ |
| Opera | 67+ |
Dispositivos
- ✅ Desktop (Windows, Mac, Linux)
- ✅ Tablet (iOS, Android)
- ✅ Móvil (iOS, Android)
🔒 Seguridad
- ✅ El widget solo se comunica con tu dominio de Sistrack
- ✅ Todas las comunicaciones son por HTTPS
- ✅ No se almacenan datos sensibles en el navegador
- ✅ Cumple con GDPR y normativas de privacidad
📞 Soporte
Si tienes problemas con la instalación:
- Revisa esta guía completa
- Consulta la documentación técnica
- Contacta a soporte con:
- URL de tu sitio
- Captura de pantalla del error
- Navegador y versión usada
¿Te quedó alguna duda?
Nuestro equipo de soporte responde en menos de 24h por email o WhatsApp.