Visión general
Los Custom Scripts permiten inyectar JavaScript/CSS en superficies específicas de la plataforma — el dashboard, el portal del Centro de Ayuda y el widget de chat. Son útiles para pequeñas personalizaciones de comportamiento y estilo sin cambiar el código base.
Requisitos previos
- Permiso de administrador para gestionar Custom Scripts.
- Conocimientos de JavaScript/CSS.
Paso a paso
- Abre el módulo de Custom Scripts.
- Crea un script y elige la superficie (dashboard, portal o widget).
- Define el tipo (JS o CSS) y cuándo debe ejecutarse.
- Usa el contexto ctx que provee el runtime para interactuar con la superficie de forma segura.
- Implementa el teardown para limpiar lo que el script creó, cuando aplique.
Configuración y opciones
- Superficie: dashboard / portal / widget.
- Tipo: JS o CSS.
- Ejecución: reglas de cuándo se ejecuta el script.
Casos de uso
- Añadir un botón o aviso en una pantalla específica.
- Ajustar estilos puntuales de una superficie.
- Registrar eventos de uso para análisis interno.
Consejos, límites y buenas prácticas
- Escribe scripts idempotentes y con teardown para evitar duplicación.
- Evita dependencias pesadas; prefiere código ligero.
- Prueba en un entorno controlado antes de publicar.
Solución de problemas
- El script no se ejecuta: confirma la superficie y las reglas de ejecución.
- Comportamiento duplicado: revisa el teardown y la idempotencia.