Scripts personalizados y Agente de tienda
Añade JavaScript de tienda y elige qué Habilidades están disponibles en un proyecto de tienda.
Las capturas y grabaciones muestran la interfaz en inglés.
Los Scripts personalizados cambian el comportamiento de la tienda, mientras que el Agente de tienda cambia qué Habilidades puede usar Runner para el proyecto actual. Ambas son configuraciones específicas de la tienda y deben revisarse con cuidado extra.
Qué cubre esta guía
Podrás añadir y guardar un script, pausarlo sin eliminarlo, y añadir o deshabilitar una Habilidad solo para el proyecto actual.
Disponibilidad y requisitos previos
- Abre Configuración desde dentro del proyecto previsto.
- JavaScript personalizado puede cambiar el comportamiento de la tienda. Añade solo código que entiendas y en el que confíes.
- Las acciones de Habilidad dependen de las Habilidades de espacio de trabajo disponibles y de si una Habilidad del Sistema es configurable.
- La página completa del Agente y la puerta del plan aún controlan la disponibilidad más amplia de Habilidades.
Rutas de entrada
- Scripts: Configuración → Tienda: nombre de la tienda → Scripts Personalizados
- Habilidades del proyecto: Configuración → Tienda: nombre de la tienda → Agente
Controles de Scripts personalizados
| Entrada o botón | Por qué es útil | Qué sucede después |
|---|---|---|
| Añadir script | Crea una entrada de script de tienda. | Se abre una nueva fila de Script habilitada con Código JavaScript vacío. |
| Fila de script | Expande o contrae su editor. | Nombre del script y Código JavaScript se hacen visibles. |
| Icono de ojo / ojo oculto | Habilita o deshabilita un script. | La fila local cambia de estado; selecciona Guardar cambios para aplicarlo. |
| Icono de eliminar | Elimina un script de la lista pendiente. | La fila desaparece sin un segundo diálogo; Guardar cambios aplica la eliminación. |
| Guardar cambios | Aplica cada edición de script pendiente. | Runner guarda la lista completa de scripts y muestra un mensaje de éxito o error. |
Runner permite hasta diez entradas de script. El botón Guardar cambios permanece deshabilitado cuando nada ha cambiado.
El editor en blanco te permite revisar los campos del script antes de la instalación. No se guardó ningún script de seguimiento en este ejemplo.
Añadir o cambiar un script
- Abre Tienda → Scripts Personalizados.
- Selecciona Añadir script.
- Ingresa un Nombre del script claro y Código JavaScript de confianza.
- Deja el script habilitado solo si debe ejecutarse en la tienda.
- Revisa todas las otras filas porque Guardar cambios aplica la lista completa.
- Selecciona Guardar cambios y espera Guardado.
- Verifica la tienda de forma segura después de guardar.
Runner intenta evitar que un error de script bloquee la página, pero eso no hace que el código desconocido sea seguro. Un script aún puede afectar la privacidad, el rendimiento, el seguimiento y la experiencia del cliente.
Inspecciona un borrador de script primero
Para una primera vista, selecciona Añadir script, nómbralo Store analytics, y apaga su control de ojo. Deja el código vacío y no selecciones Guardar cambios. Esto te permite identificar el editor y el estado deshabilitado antes de añadir código de un proveedor de confianza. Cuando guardes un script real, vuelve a abrir la lista y verifica tanto su código como su estado habilitado.
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Para las Habilidades del proyecto, elige Agente bajo el encabezado de la tienda. Esta imagen muestra su entrada; no muestra una Habilidad siendo añadida o deshabilitada.
Controles del Agente de tienda
| Entrada o botón | Por qué es útil | Qué sucede después |
|---|---|---|
| Fila de Habilidad activa | Ve qué Habilidad está disponible en este proyecto. | La fila muestra nombre, descripción y tipo Sistema o Personalizado. |
| Desactivar | Elimina una Habilidad configurable de este proyecto solo. | La Habilidad sale de la lista activa de este proyecto; no se elimina globalmente. |
| Añadir habilidad | Añade una Habilidad de espacio de trabajo disponible a este proyecto. | Seleccionar una Habilidad listada la habilita para el proyecto actual. |
| Crear habilidad personalizada… | Crea una nueva capacidad personalizada. | Se abre el editor de Habilidades, luego la lista del proyecto se actualiza después del éxito. |
Configurar Habilidades del proyecto
- Abre Tienda → Agente.
- Revisa las Habilidades actualmente activas.
- Selecciona Añadir habilidad, luego elige una Habilidad disponible o Crear habilidad personalizada….
- Espera el mensaje de éxito y confirma que la Habilidad aparece.
- Usa Desactivar cuando una Habilidad configurable deba dejar de aplicarse a este proyecto.
- Abre Agente en la navegación del proyecto para detalles completos de Habilidad, pausa, edita, importa o elimina acciones.
Estados y límites
- Los cambios de script permanecen locales hasta que Guardar cambios tenga éxito.
- Eliminar una fila de script no tiene confirmación separada antes de Guardar cambios.
- Alcanzar diez scripts deshabilita Añadir script.
- El Agente de tienda puede mostrar carga, un error, No hay habilidades activadas o la lista activa.
- Las Habilidades del Sistema fijas no muestran Desactivar.
- Deshabilitar en Agente de tienda cambia el alcance de este proyecto; no elimina ni pausa globalmente la Habilidad.
Solución de problemas
- Si un script aún se ejecuta, confirma que su estado deshabilitado fue seguido por Guardar cambios.
- Si Guardar falla, la lista guardada anteriormente permanece sin cambios; corrige el código o intenta de nuevo después del error.
- Si Añadir habilidad no tiene la entrada esperada, verifica la página completa del Agente y el plan actual.
- Si Desactivar está ausente, la Habilidad del Sistema no es configurable para este proyecto.
- Si una nueva Habilidad aparece globalmente pero no aquí, añádela al proyecto desde Agente de tienda.