Cómo instalar SeaText AI en una tienda de desarrollo de Shopify

Para instalar SeaText AI en una tienda de desarrollo de Shopify, agregas el fragmento de JavaScript de SeaText a tu tema. La ruta paso a paso es: crear una cuenta de SeaText AI, copiar el fragmento de la página de integración de SeaText para Shopify, pegarlo en theme.liquid en tu administrador de Shopify y guardar. Luego verifica que el fragmento realmente se cargue antes de activar cualquier agente.

El giro importante de la tienda de desarrollo es la coincidencia de dominio. SeaText vincula cada cuenta a una URL principal. Si usas un dominio de desarrollo y un dominio de producción, necesitas cuentas separadas. localhost está restringido, y los dominios de desarrollo dinámicos pueden no funcionar de manera confiable.

Lo que necesitas antes de instalar

Prepara estas cuatro cosas, y la parte de copiar y pegar toma menos de un minuto si ya tienes acceso de administrador:

• Una cuenta de SeaText. La página de integración dice: “Antes de poder instalar el script, necesitas una cuenta de SEATEXT AI.” Si no tienes una, créala desde la misma página.
• Un dominio real y válido. Usa un dominio que SeaText pueda asociar de manera confiable con tu cuenta, no localhost.
• Acceso de administrador de Shopify con permiso para editar el código del tema.
• El fragmento de Javascript copiado de la página de integración de SeaText.

Para una tienda de desarrollo, decide qué dominio será su URL principal. Si ese dominio cambiará más adelante, planea crear otra cuenta de SeaText para el dominio de producción final.

Paso a paso: instalar el fragmento de SeaText AI en Shopify

1. Inicia sesión en tu cuenta de SeaText y abre la página de integración de Shopify.
2. Copia el código Javascript de la sección SEATEXT AI.
3. Inicia sesión en tu administrador de Shopify.
4. Ve a Online Store > Themes.
5. Junto a tu tema activo, haz clic en Actions > Edit code.
6. En la barra lateral izquierda, abre la carpeta Layout y haz clic en theme.liquid.
7. Pega el fragmento de SeaText en el archivo.
8. Haz clic en Save.

Esa es la instalación principal. La documentación de SeaText también describe una etiqueta opcional para la descripción del producto si quieres que SeaText optimice las descripciones de productos:

1. En la misma pantalla de Edit Code, encuentra el archivo de plantilla de producto, generalmente product.liquid o product-template.liquid.
2. Localiza el código que genera la descripción del producto.
3. Envuelve esa salida con el atributo data- descrito en la guía de integración de SeaText.
4. Guarda y prueba una página de producto.

No omitas la verificación en la siguiente sección. Es fácil pegar un fragmento en el archivo equivocado y pensar que la instalación funcionó.

Cómo verificar la instalación

Después de guardar, abre tu tienda de desarrollo en un navegador. Luego:

1. Haz clic derecho en la página y elige View Page Source, o abre las herramientas de desarrollador de tu navegador.
2. Busca el nombre del fragmento de SeaText o el código que pegaste.
3. Si agregaste la etiqueta para la descripción del producto, busca el atributo data- en el HTML de la página.
4. Confirma que la página se carga sin errores de JavaScript.

Si el fragmento no aparece, vuelve a Edit Code y verifica que guardaste theme.liquid en el tema activo. Si la página redirige o muestra un 404, revisa la configuración del dominio de la tienda de desarrollo.

Qué funciona y qué no en las tiendas de desarrollo

La guía de integración de SeaText es explícita sobre el comportamiento del dominio. Usa esto como tu modelo mental:

• Cuenta separada por dominio. “Si necesitas usar SEATEXT AI en múltiples dominios (por ejemplo, un dominio de desarrollo y un dominio de producción), debes crear cuentas separadas para cada dominio.”
• Una URL principal por cuenta. “Cada cuenta de SEATEXT AI está vinculada a una única URL principal.”
• Sin localhost. “Las URL de desarrollo, como localhost, están restringidas por razones de seguridad.”
• Solo dominios estables y reales. “Los dominios de desarrollo dinámicos pueden no funcionar correctamente, ya que SEATEXT AI podría no ser capaz de asociar el tráfico con tu cuenta de manera confiable.”

¿Qué significa eso para ti? Si tu “tienda de desarrollo” es una URL de vista previa de Shopify como my-store.myshopify.com, ese es un nombre de host real, así que puede funcionar. Pero si la URL cambia con cada vista previa o implementación, no te sorprendas cuando los datos no aparezcan. Usa un subdominio fijo como staging.yourdomain.com cuando sea posible.

El otro punto clave: la instalación es segura. El fragmento por sí solo no cambia tu tienda. La activación ocurre más tarde dentro de SeaText, así que puedes poner el fragmento en una tienda de desarrollo, probar la ubicación y solo activar los agentes cuando estés listo.

Datos clave

Terminología

• Cuenta de SeaText AI — una cuenta vinculada a una URL principal. Necesitas una por dominio.
• Theme.liquid — el archivo de diseño principal de Shopify que controla el HTML externo de cada página.
• Fragmento — el pequeño código JavaScript que pegas en tu tema.
• URL principal — el dominio conectado a una cuenta específica de SeaText.
• Dominio de desarrollo dinámico — un dominio o subdominio que cambia entre vistas previas o implementaciones; SeaText puede no asociar el tráfico de manera confiable.
• Inerte — no activo hasta que actives la función. SeaText permanece inerte después de la instalación hasta la activación.

Preguntas frecuentes

¿Por qué no puedo usar localhost?

La guía de integración dice que las URL de desarrollo como localhost están restringidas por razones de seguridad. Usa un dominio válido y real.

¿Necesito una cuenta de SeaText separada para mi tienda de desarrollo y mi tienda en vivo?

Sí, si los dominios son diferentes. Cada cuenta de SeaText está vinculada a una única URL principal. La guía recomienda específicamente cuentas separadas para un dominio de desarrollo y un dominio de producción.

¿El fragmento cambiará mi tienda de desarrollo antes de que lo active?

No. SeaText dice que la IA permanece inerte hasta que se activa. El fragmento solo permanece en el tema hasta que actives algo.

¿Qué debo revisar si SeaText no muestra tráfico desde mi tienda de desarrollo?

Primero, confirma que el fragmento está en theme.liquid y aparece en el código fuente de la página renderizada. Luego, revisa el dominio en el que lo instalaste. Si ese dominio es dinámico o no es la URL principal vinculada a tu cuenta, SeaText puede no asociar el tráfico con él.

¿Puedo usar una tienda de desarrollo gratuita de Shopify con SeaText?

Puedes instalar el fragmento en cualquier tienda de Shopify donde puedas editar el código del tema, siempre que la tienda tenga un dominio válido. La restricción es sobre localhost y dominios dinámicos, no sobre el tipo de tienda.

¿Cuánto cuesta SeaText?

Los documentos de origen no enumeran precios. La página de integración de SeaText tiene un enlace “Click here for pricing”, y la página de inicio tiene una sección de Pricing. Consulta los precios actuales allí.

Próximos pasos después de la instalación

Una vez verificado el fragmento, ve a tu panel de SeaText y mira la lista de agentes. Comienza con los agentes que coincidan con tu objetivo actual. En una tienda de desarrollo, eso podría ser el CRO Optimizer o el Website Translation Agent para que puedas probar el comportamiento antes de pasar a producción.

Si vas a pasar a producción más adelante, crea una cuenta de SeaText separada para el dominio de producción y repite el mismo proceso. No reutilices la cuenta de la tienda de desarrollo si la URL principal no coincidirá.