Lista de verificación de preparación de Squarespace para variantes de traducción AI de SeaText

Respuesta rápida

Puedes ejecutar variantes de traducción AI de SeaText en Squarespace cuando se cumplen cuatro condiciones: tu plan es Business o superior, puedes acceder a Configuración → Herramientas de desarrollador → Inyección de código, tu sitio está en vivo en un dominio real (sin localhost ni URL de vista previa dinámicas) y tienes contenido de página que realmente contiene texto traducible. Si falta alguno de esos, el script no se puede agregar o permanecerá inactivo.

Esta lista de verificación detalla cada condición. Aprenderás cómo verificar cada una, qué hacer si fallas en una verificación y cómo evitar errores comunes que retrasan la activación.

Requisitos previos: nivel de plan y permisos

Squarespace restringe la inyección de código a los planes Business, Commerce Basic y Commerce Advanced. Los planes Personal y de prueba no exponen la sección de Herramientas de desarrollador, por lo que el fragmento de SeaText no tiene dónde ir. Verifica tu plan en Configuración → Facturación → Suscripción antes de comenzar. También necesitas permisos de administrador o propietario en el sitio; los roles de colaborador no pueden abrir Herramientas de desarrollador.

Por qué esto importa: Sin el plan Business o superior, no puedes agregar ningún JavaScript personalizado. SeaText depende de ese fragmento para comunicarse con tus páginas. Actualizar es la única solución. Si estás en una prueba, la sección de Herramientas de desarrollador está oculta hasta que elijas un plan de pago.

Cómo verificar: Inicia sesión en tu panel de Squarespace. Haz clic en el nombre de tu sitio, luego ve a Configuración → Facturación → Suscripción. El nombre del plan aparece allí. Si dice Personal o Prueba, necesitas actualizar.

Verificación de permisos: Ve a Configuración → Permisos. Tu rol debe ser Administrador o Propietario. Si eres colaborador, puedes solicitar acceso al propietario del sitio.

Acceso técnico: disponibilidad de inyección de código

Abre Configuración, desplázate hasta el final y haz clic en Herramientas de desarrollador. Si ves "Inyección de código", estás autorizado para pegar el JavaScript de SeaText en el campo Encabezado. Si la sección está ausente, tu plan no lo admite: actualiza o usa una plataforma diferente. El fragmento debe ir en el Encabezado, no en el Pie de página, y el sitio debe guardarse y publicarse después de pegarlo.

Por qué importa la inyección en el encabezado: SeaText necesita cargarse temprano en el ciclo de vida de la página para detectar nodos de texto. El encabezado es el lugar estándar para scripts de seguimiento y traducción. Ponerlo en el pie de página puede retrasar la ejecución y puede hacer que el script pierda elementos que se renderizan después de que el DOM esté listo.

Error común: Algunos usuarios pegan el código en el Pie de página por error. Verifica dos veces que estés en el campo Encabezado. Además, asegúrate de hacer clic en Guardar y luego Publicar el sitio. Los cambios en la inyección de código no se activan hasta que publiques.

Preparación del contenido: texto que se puede traducir

SeaText traduce nodos de texto visibles: titulares, cuerpo del texto, etiquetas de botones, descripciones de productos, meta descripciones y atributos alt. Las páginas que son completamente imágenes, aplicaciones de terceros incrustadas o texto SVG codificado no producirán variantes traducibles. Audita algunas páginas clave (inicio, producto, contacto) y confirma que contienen texto HTML en vivo. Si usas un constructor de páginas que renderiza todo como lienzo o WebGL, la traducción no funcionará.

Qué auditar: Abre tu sitio en un navegador, haz clic derecho y selecciona Ver código fuente de la página. Busca etiquetas <p>, <h1>, <h2>, <span> y <button> que contengan texto visible. Si la mayor parte de tu contenido está dentro de etiquetas <img> o se entrega a través de iframes, SeaText no puede leerlo.

Escenario práctico: Una tienda en línea con títulos y descripciones de productos en HTML funcionará bien. Un sitio de portafolio que muestra imágenes sin subtítulos de texto tendrá poco que traducir. Puedes agregar bloques de texto en Squarespace para hacer que las páginas sean traducibles.

Requisitos de dominio: URL de producción válida

SeaText vincula cada cuenta a una única URL principal. Las direcciones de desarrollo como localhost, 127.0.0.1 o los subdominios de prueba integrados de Squarespace .squarespace.com están bloqueados por seguridad. Necesitas un dominio real y públicamente resoluble (por ejemplo, ejemplo.com o tienda.ejemplo.com) con HTTPS activo. Si ejecutas un entorno de preparación en un subdominio separado, crea una segunda cuenta de SeaText para ese subdominio.

Por qué la restricción: SeaText debe asociar de manera confiable el tráfico con tu cuenta. Las URL de desarrollo dinámicas cambian a menudo, lo que hace imposible rastrear sesiones. Un dominio personalizado es estable y verificable.

Cómo verificar: En tu navegador, ve a tu dominio y mira la barra de direcciones. Debe comenzar con https:// y no contener localhost ni .squarespace.com. Si estás usando un sitio de prueba, conecta un dominio personalizado en Configuración → Dominios.

Pasos de verificación de instalación

1. Pega el fragmento de JavaScript de SeaText en Configuración → Herramientas de desarrollador → Inyección de código → Encabezado y haz clic en Guardar.
2. Publica el sitio si aún no está en vivo.
3. Visita la página de inicio (o cualquier página con el fragmento) y permanece durante al menos 40 segundos. Esto activa la IA y vincula el dominio a tu cuenta de SeaText.
4. Espera cinco minutos, luego abre tu panel de SeaText. El nombre de tu sitio debería aparecer junto al logotipo de SeaText en la parte superior.
5. Si el nombre no aparece después de 10 minutos, contacta al soporte de SeaText: la instalación puede tener un problema específico de la plataforma.

¿Por qué 40 segundos? El script necesita tiempo para cargar y enviar una señal de sesión. No es suficiente con actualizar rápidamente. Quédate en la página y deja que el script termine su apretón de manos.

Qué hacer a continuación: Después de que el panel muestre tu sitio, ve al Centro de IA principal y activa el Agente de traducción de sitios web. Elige las páginas que deseas traducir y configura los parámetros. El primer conjunto de variantes generalmente aparece en minutos.

Bloqueadores comunes y cómo resolverlos

• Inyección de código faltante: Actualiza al plan Business o superior.
• Script guardado pero el nombre del sitio nunca aparece: Limpia la caché del navegador, asegúrate de que los bloqueadores de anuncios/scripts estén desactivados para tu dominio, luego vuelve a visitar durante otros 40 segundos.
• Subdominio de prueba utilizado: Conecta un dominio personalizado en el panel de Dominios de Squarespace, luego reinstala el fragmento.
• Varios dominios bajo una cuenta: Crea una cuenta de SeaText separada para cada URL principal.
• Contenido dentro de iframes o widgets externos: SeaText no puede alcanzar iframes de origen cruzado; mueve el texto traducible a bloques nativos de Squarespace.

Bloqueadores de scripts: Las extensiones del navegador como uBlock Origin o herramientas de privacidad pueden detener la carga del fragmento. Prueba en una ventana privada con extensiones desactivadas.

Problemas de caché: Después de guardar el fragmento, actualiza forzosamente tu navegador (Ctrl+F5) para asegurarte de que estás viendo la versión actualizada de tu página.

Varios sitios web: Si tienes más de un sitio de Squarespace, cada uno requiere su propia cuenta y fragmento de SeaText.

Limitaciones y cuándo esta lista de verificación no aplica

Esta lista de verificación cubre sitios web estándar de Squarespace. No cubre sitios de Squarespace Commerce que usan extensiones de pago personalizadas cargadas a través de iframes, ni se aplica a las funciones nativas de escritura con IA de Squarespace: esas son separadas de SeaText. Si ya ejecutas otro complemento de traducción (por ejemplo, Linguise o Weglot) mediante inyección de código, prueba si hay conflictos de scripts antes de activar SeaText. El agente de traducción de 125 idiomas y las pruebas de variantes solo comienzan después de que el panel muestre tu sitio como conectado.

Aplicaciones de una sola página: Los sitios de Squarespace son en su mayoría renderizados en el servidor. Si usas una SPA personalizada (React o similar) dentro de Squarespace, es posible que necesites implementar un manejo especial. La documentación de SeaText menciona soporte para SPA, pero requiere seguir su guía avanzada.

Conclusión: La lista de verificación es un filtro. Si pasas cada punto, la instalación debería ser fluida. Si fallas en uno, sabes exactamente dónde corregir.

Datos clave

Preguntas frecuentes

¿Puedo usar SeaText en un plan Personal si agrego el script a través de un complemento de terceros?

No. Squarespace no expone el punto de inyección del Encabezado en planes Personal, y los complementos de terceros no pueden eludir esa restricción.

¿El subdominio de prueba .squarespace.com funciona para probar?

No. SeaText bloquea subdominios de prueba y desarrollo por seguridad. Conecta un dominio personalizado primero.

¿Qué sucede si ya tengo dos idiomas construidos como páginas separadas?

SeaText aún puede crear variantes para cada página. No reemplaza tus traducciones manuales, sino que agrega variantes generadas por IA para pruebas. Puedes mantener ambos enfoques funcionando.

¿Cuánto tiempo antes de ver las primeras variantes traducidas?

Después de que el panel muestre tu sitio como conectado, activa el Agente de traducción de sitios web en el Centro de IA principal. Las variantes iniciales generalmente aparecen en minutos.

¿SeaText ralentizará mi sitio de Squarespace?

El script se carga de forma asíncrona y permanece inactivo hasta que se activa. No se ha informado un impacto medible en los Core Web Vitals en la documentación fuente.

¿Puedo restringir la traducción a páginas específicas?

Sí. En el Centro de IA principal eliges qué páginas tienen activo el Agente de traducción.

¿Qué pasa si necesito traducir un subdominio de preparación y el dominio en vivo?

Crea dos cuentas de SeaText: una por URL principal, e instala el fragmento respectivo en cada entorno.

¿Necesito eliminar otras herramientas de traducción antes de instalar SeaText?

Puedes ejecutar SeaText junto con otros traductores, pero prueba si hay conflictos de scripts. Algunas herramientas pueden alterar el DOM de maneras que impiden que SeaText detecte texto.

¿Puedo usar SeaText en un sitio de Squarespace que usa un dominio personalizado de un registrador de terceros?

Sí. Siempre que el dominio esté correctamente conectado y resuelva a tu sitio, SeaText lo aceptará.

¿Qué pasa si mi contenido es principalmente imágenes con texto incrustado?

SeaText no puede traducir texto dentro de imágenes. Necesitas convertir ese contenido a bloques de texto HTML para que la traducción funcione.