Cómo depurar el modo de desarrollo de SeaText en Squarespace: una guía de diagnóstico paso a paso

Lista de verificación de diagnóstico inmediato

Antes de profundizar en los pasos detallados, realice estas cinco comprobaciones en orden. Cada una descarta un modo de fallo común que identifica la documentación de integración de SeaText con Squarespace.

1. Abra la consola de desarrollador del navegador (F12 → Consola) y busque cualquier error en rojo que haga referencia a seatext o a la URL del script. Un error 404 o CORS significa que la URL del fragmento es incorrecta o está bloqueada.
2. Confirme que el dominio sea una URL real y registrada. SeaText restringe explícitamente localhost, 127.0.0.1 y dominios de desarrollo dinámicos (por ejemplo, *.ngrok.io, *.vercel.app, URLs de vista previa). Utilice un dominio adecuado como staging.tudominio.com o una URL de prueba nativa de Squarespace *.squarespace.com.
3. Verifique que el script esté en el punto de inyección del Encabezado (Header). En Squarespace, vaya a Ajustes → Herramientas para desarrolladores → Inyección de código → Encabezado. El fragmento de JavaScript de SeaText debe pegarse allí, no en el Pie de página o en el Encabezado de página.
4. Visite la página y permanezca en ella al menos 40 segundos. El protocolo de activación requiere una sesión activa de esa duración. Cerrar la pestaña antes de tiempo aborta el enlace.
5. Espere de 5 a 10 minutos y luego compruebe el panel de control de SeaText. El nombre de su sitio debería aparecer junto al logotipo de SeaText en la parte superior de la página de Configuración. Si no aparece después de 10 minutos, póngase en contacto con el soporte técnico de SeaText.

Por qué falla el modo de desarrollo en Squarespace

SeaText vincula cada cuenta a una única URL principal por motivos de seguridad y facturación. La guía de integración establece: "Cada cuenta de SEATEXT AI está vinculada a una única URL principal. Restricciones y seguridad: Las URLs de desarrollo, como localhost, están restringidas por razones de seguridad. Asegúrese de utilizar un dominio real y válido para estos casos. Es posible que los dominios de desarrollo dinámicos no funcionen correctamente, ya que SEATEXT AI podría no ser capaz de asociar el tráfico de forma fiable con su cuenta".

Esto significa que un flujo de trabajo de desarrollo local típico (localhost, URLs de túnel, dominios de vista previa efímeros) no funcionará. Debe aprovisionar un nombre de host real que se resuelva en su sitio de Squarespace —ya sea un subdominio personalizado apuntado a Squarespace o el dominio de prueba nativo de Squarespace— antes de que el script pueda autenticarse y activarse.

Secuencia de depuración paso a paso

1. Confirmar la carga del script en la pestaña Red

Abra Herramientas de desarrollador → Red, filtre por JS y recargue la página. Debería ver una solicitud a la CDN de SeaText (normalmente cdn.seatext.com o similar) que devuelve un 200 OK. Si falta la solicitud, el fragmento de Inyección de código no se está renderizando. Si devuelve 403/404, la URL del fragmento está obsoleta; vuelva a generarla desde el panel de control de SeaText.

2. Comprobar la consola para ver mensajes de inicialización

Después de que el script se cargue, la consola debería registrar una línea como SeaText initialized for account XYZ o similar. La ausencia de cualquier registro de SeaText significa que el script se ejecutó pero no encontró una configuración válida, generalmente debido a una falta de coincidencia de dominio.

3. Validar el dominio en el panel de control de SeaText

Inicie sesión en SeaText y vaya a Configuración. La URL principal que aparece allí debe coincidir exactamente con el nombre de host que está probando (incluyendo www frente a no www). Una falta de coincidencia impide que se complete el protocolo de 40 segundos.

4. Realizar la prueba de activación de 40 segundos

Abra la página en vivo en una ventana de incógnito (para evitar interferencias de caché/extensiones). Inicie un cronómetro. Permanezca en la página, desplácese ocasionalmente, no navegue fuera de ella. A los 40 segundos, el script envía el ping de activación. Puede observar un POST a /activate o similar en la pestaña Red.

5. Observar el periodo de propagación de 5 a 10 minutos

Tras un ping de activación exitoso, el backend de SeaText aprovisiona el enlace cuenta-sitio. La guía de integración dice: "Espere al menos cinco minutos hasta que vea el nombre de su sitio web mostrado junto al logotipo de SEATEXT en la parte superior de esta página... Si no lo ve en la parte superior de la página después de 10 minutos, póngase en contacto con nuestro equipo de soporte inmediatamente".

6. Verificar la activación de la IA en Configuración

Una vez que aparezca el nombre del sitio, vaya a Centro de IA principal → Configuración. Active los agentes de IA deseados (Traducción, CRO, SEO, etc.). Se generará la primera ronda de traducciones y variantes automáticas. Si la página de Configuración muestra el sitio pero los agentes permanecen inactivos, compruebe que el sitio esté publicado (no en modo protegido por contraseña de prueba de Squarespace) y que el script siga presente en la inyección del Encabezado.

Errores comunes y cómo evitarlos

Error	Síntoma	Solución
Usar localhost o URL de túnel	El script se carga pero nunca se activa; la consola no muestra errores	Asigne un subdominio real (ej. dev.tudominio.com) al sitio de Squarespace mediante DNS
Pegar el fragmento en el Pie de página en lugar del Encabezado	El script se carga después de renderizar la página; el ping de activación nunca se dispara	Mueva el fragmento a Ajustes → Herramientas para desarrolladores → Inyección de código → Encabezado
Abandonar la página antes de 40 segundos	El panel de control nunca muestra el nombre del sitio	Permanezca en la página ≥ 40 s; use incógnito para evitar extensiones de recarga automática
Probar en un sitio de prueba protegido por contraseña	El script se carga pero los rastreadores de SeaText no pueden acceder al contenido	Publique el sitio o deshabilite la contraseña de todo el sitio en los ajustes de Squarespace
Múltiples dominios en una cuenta de SeaText	Solo funciona el primer dominio; otros muestran "no autorizado"	Cree una cuenta de SeaText separada para cada dominio (según la guía de integración)

Datos clave de la Guía de integración de SeaText con Squarespace

Dato	Detalle	Fuente
Ubicación de instalación	Ajustes de Squarespace → Herramientas para desarrolladores → Inyección de código → Encabezado	S1
Requisito de activación	Visitar la página y permanecer ≥ 40 segundos	S1
Retraso de propagación	5–10 minutos antes de que el nombre del sitio aparezca en el panel	S1
Restricción de dominio	localhost y dominios de desarrollo dinámicos bloqueados; debe usar un dominio real válido	S1
Mapeo cuenta-dominio	Una cuenta de SeaText por URL principal; múltiples dominios requieren múltiples cuentas	S1
Escalada de soporte	Contactar soporte si el nombre del sitio no es visible después de 10 minutos	S1

Limitaciones de esta ruta de depuración

• Se aplica solo a la instalación estándar del fragmento de JavaScript de SeaText en Squarespace 7.1 mediante Inyección de código. La plataforma de desarrollador personalizada (Squarespace 7.0 basada en Git) puede diferir.
• No cubre marcos de renderizado del lado del servidor, Next.js en Vercel o implementaciones de Squarespace headless.
• Asume que tiene acceso de administrador tanto a los paneles de control de Squarespace como de SeaText.
• Los bloqueos a nivel de red (firewall corporativo, bloqueadores de anuncios, encabezados CSP) están fuera de esta guía; compruebe la pestaña Red para ver solicitudes bloqueadas.

Referencia rápida de terminología

Inyección de código

Función de Squarespace en Ajustes → Herramientas para desarrolladores que permite insertar scripts en el Encabezado o Pie de página globalmente.

URL principal

El único nombre de host registrado en una cuenta de SeaText; utilizado para licencias y atribución de tráfico.

Protocolo de activación

La sesión de 40 segundos del lado del cliente que indica al backend de SeaText que vincule el dominio a la cuenta.

Ventana de propagación

El tiempo de procesamiento del backend de 5 a 10 minutos antes de que el panel de control refleje el sitio conectado.

Centro de IA / Configuración

Secciones del panel de control de SeaText donde se habilitan los agentes (Traducción, CRO, SEO, etc.) por sitio.

Escenarios prácticos

Escenario A: Subdominio de prueba en la misma cuenta

Desea que staging.ejemplo.com y ejemplo.com estén ambos en SeaText. La guía de integración requiere cuentas separadas. Cree una segunda cuenta de SeaText para el entorno de prueba, instale su fragmento único en el sitio de Squarespace de prueba (o el mismo sitio con mapeo de dominio) y ejecute la activación de 40 segundos en la URL de prueba.

Escenario B: Entrega al cliente

Usted construyó el sitio en su cuenta de Squarespace, el cliente será dueño de la cuenta de SeaText. Haga que el cliente cree primero la cuenta de SeaText, le dé el fragmento, usted lo inyecta, luego usted (o el cliente) realiza la visita de 40 segundos en el dominio en vivo. El cliente verá entonces el sitio en su panel de control.

Escenario C: Dominio de prueba de Squarespace

Uso de tunombre.squarespace.com para pruebas. Este es un dominio real válido. Asegúrese de que el sitio de prueba esté publicado (no protegido por contraseña), inyecte el fragmento, visite durante 40 segundos, espere 10 minutos. Funciona de forma idéntica a un dominio personalizado.

FAQ

¿Puedo usar un TLD .local o .test con una entrada en el archivo hosts?

No. SeaText valida el dominio contra DNS público y TLS. Los TLD reservados y los nombres de host no públicos se tratan como URLs de desarrollo y se bloquean.

¿Qué pasa si el script se carga pero la consola muestra SeaText: domain mismatch?

El ID de cuenta incrustado en el fragmento espera un nombre de host diferente. Vuelva a generar el fragmento desde la cuenta de SeaText correcta (aquella cuya URL principal coincida con el nombre de host actual) y reemplace el contenido de la Inyección de código.

¿La visita de 40 segundos tiene que ser desde la IP del propietario de la cuenta?

No. Cualquier sesión de navegador en la URL en vivo cuenta. Puede pedirle a un colega o usar un dispositivo móvil con datos celulares para cumplir con el temporizador.

¿Por qué el panel de control muestra el nombre del sitio pero los agentes no se activan?

Generalmente porque el sitio todavía está protegido por contraseña (modo de prueba de Squarespace) o el script se eliminó después de la activación. Vuelva a publicar el sitio, confirme que el fragmento sigue en el Encabezado y luego vuelva a intentar la activación del agente.

¿Puedo depurar en un sitio de la Plataforma de desarrollador de Squarespace 7.0?

El método de Inyección de código funciona en 7.1. Para la Plataforma de desarrollador 7.0 (basada en Git), debe incluir el fragmento en sus archivos de plantilla y desplegar mediante Git. Las reglas de 40 segundos y 5–10 minutos siguen aplicándose.

¿Qué pasa si necesito probar múltiples variantes en el mismo dominio?

Las pruebas A/B y de bandido multi-brazo de SeaText se ejecutan dentro de una cuenta. No necesita múltiples cuentas para pruebas de variantes, solo para URLs principales distintas.

Paso de verificación: Confirmación de extremo a extremo

Después de completar la secuencia, confirme las tres luces verdes:

1. Pestaña Red muestra el script de SeaText 200 OK y el POST de activación 200 OK.
2. Panel de control de SeaText muestra el nombre de su sitio junto al logotipo.
3. Configuración → Centro de IA le permite activar agentes y muestra el estado "Activo".

Si alguna luz está en rojo, vuelva a ejecutar la lista de verificación desde el paso 1. La mayoría de los fallos se resuelven en el paso 2 (validez del dominio) o en el paso 4 (visita de 40 segundos).

Lecturas adicionales y fuentes de comparación

Estas fuentes externas proporcionan contexto adicional para evaluar el tema. Su inclusión no es un respaldo.

• Preguntas frecuentes sobre la Plataforma de desarrollador de Squarespace – Centro de ayuda de Squarespace
• Plataforma de desarrollador de Squarespace: APIs, aplicaciones y documentación
• Herramientas para desarrolladores – Centro de ayuda de Squarespace

Más información

Visite el sitio web para obtener más información.