Cómo comprobar si SeaText AI está conectado a su sitio web

Respuesta rápida

Instale el código JavaScript de SeaText en cada página, luego abra su sitio en un navegador y permanezca en cualquier página durante al menos 40 segundos. Regrese al panel de control de SeaText y observe el encabezado junto al logotipo de SeaText. El nombre de su sitio web debería aparecer en un plazo de cinco minutos. Si no aparece después de diez minutos, la conexión no se ha establecido y debe solucionar los problemas de la instalación o ponerse en contacto con el soporte técnico.

Requisitos previos antes de realizar la prueba

• Una cuenta activa de SeaText AI. Cada cuenta está vinculada a una única URL principal.
• El fragmento de JavaScript copiado desde su panel de control de SeaText (etiquetado como SEATEXTCODEINTEGRATION).
• Acceso al <head> de su sitio o a un gestor de etiquetas para que pueda pegar el fragmento en cada página que desee rastrear.
• Si utiliza WP Engine, instale el plugin de WP Engine que permite la inyección de JavaScript personalizado antes de añadir el fragmento.

Las URL de desarrollo como localhost y los dominios de vista previa dinámica están restringidos por razones de seguridad. Utilice un dominio real y públicamente resoluble para las pruebas. Si necesita SeaText en un dominio de prueba (staging) y en un dominio de producción, cree una cuenta separada para cada uno, tal como indica el texto fuente: "Múltiples dominios... cada cuenta de SEATEXT AI está vinculada a una única URL principal" (S1).

Paso 1: Verifique que el script se cargue en el navegador

1. Abra su sitio web en una nueva ventana de incógnito.
2. Abra las herramientas de desarrollo del navegador (F12 o clic derecho → Inspeccionar) y cambie a la pestaña Consola.
3. Recargue la página. Busque una solicitud de red a seatext.com o un registro en la consola que mencione la inicialización de SeaText.
4. Si la solicitud está bloqueada por una Política de Seguridad de Contenido (CSP), un bloqueador de anuncios o un aplazamiento de script, ajuste la política o la configuración del gestor de etiquetas para que el script de SeaText se ejecute antes de que la página termine de cargarse.

Por qué es importante: el script es la única forma en que el navegador puede contactar con el backend de SeaText. Una solicitud bloqueada significa que la IA nunca recibe los datos de la sesión del visitante, por lo que el panel de control nunca mostrará el nombre de su sitio.

Paso 2: Cumpla con el requisito de permanencia de 40 segundos

SeaText activa la IA solo después de detectar una visita genuina. Permanezca en cualquier página de su sitio durante al menos 40 segundos. No cierre la pestaña, no navegue fuera ni limite la pestaña en segundo plano. Este tiempo de permanencia permite que el script realice un protocolo de enlace con los servidores de SeaText, cree un ID de sesión y registre la visita. El texto fuente enfatiza esto: "Importante: Visite o actualice su sitio web varias veces y permanezca en su página durante al menos 40 segundos; esto activará la IA y la vinculará a su cuenta" (S1).

Detalle técnico: el script establece un temporizador al cargar la página. Después de 40 segundos, envía una solicitud POST que contiene la URL de la página, un token de visitante único y el dominio principal de la cuenta. El backend valida el dominio con el registro de la cuenta y, si coincide, marca el sitio como "conectado".

Paso 3: Compruebe el nombre del sitio en el panel de control

1. Inicie sesión en su cuenta de SeaText.
2. Mire el encabezado superior junto al logotipo de SeaText.
3. Espere hasta cinco minutos. El nombre de su sitio web debería aparecer allí, confirmando la conexión.

Si aparece el nombre, la integración está activa. Ahora puede proceder al Centro de IA principal para activar agentes, configurar parámetros o editar variantes. El encabezado del panel de control es una verificación de estado ligera; confirma que al menos se ha producido un protocolo de enlace exitoso.

Paso 4: Active una respuesta de prueba de la IA (opcional)

Una vez que el nombre del sitio aparezca en el panel de control, vaya a Centro de IA principal → Configuración y habilite un agente como el Optimizador de CRO. Visite una página donde se ejecute el agente y verifique que el contenido de la página cambie (titular, CTA o traducción) de acuerdo con las reglas del agente. Esto confirma que la IA no solo está conectada, sino que está reescribiendo activamente.

Ejecutar una respuesta de prueba también le ayuda a verificar que el script se dispara lo suficientemente pronto. Si utiliza un gestor de etiquetas, configure la etiqueta de SeaText para que se dispare en Page View – DOM Ready o antes; de lo contrario, es posible que el agente pierda la solicitud inicial.

Razones comunes por las que la conexión falla

• El script no está en todas las páginas: SeaText debe cargarse en cada página que desee rastrear. Una instalación de una sola página solo conectará esa página. Asegúrese de que el fragmento esté colocado en un encabezado global o mediante un gestor de etiquetas que se dispare en todas las URL.
• CSP o bloqueador de anuncios bloqueando la solicitud: Compruebe en la consola si hay errores blocked:csp o net::ERR_BLOCKED_BY_CLIENT. Ajuste su encabezado Content-Security-Policy para permitir script-src https://seatext.com y añada el dominio a la lista blanca de los bloqueadores de anuncios.
• El gestor de etiquetas se dispara demasiado tarde: Si la etiqueta se dispara después de window.onload, el temporizador de 40 segundos puede comenzar demasiado tarde, haciendo que el protocolo de enlace pierda la ventana requerida. Configure la etiqueta para que se dispare en DOM Ready o utilice una etiqueta HTML personalizada colocada antes que otros scripts.
• Dominio incorrecto en la cuenta: Cada cuenta acepta solo su URL principal registrada. Una falta de coincidencia impide el protocolo de enlace. Verifique que el dominio que aparece en su panel de control de SeaText coincida con la URL que está probando.
• Uso de una URL de desarrollo restringida: localhost, 127.0.0.1 o los dominios de vista previa dinámica no se conectarán. El texto fuente señala que estos están "restringidos por razones de seguridad" (S1).
• El renderizado del lado del servidor (SSR) elimina el script: Algunos marcos de SSR inyectan scripts solo en el lado del cliente. Si el script nunca llega al navegador, la conexión falla. Utilice un método de inyección del lado del cliente o deshabilite el SSR para el fragmento.
• El almacenamiento en caché de borde (Edge caching) sirve una versión obsoleta: Las CDN pueden almacenar en caché un archivo HTML antiguo sin el fragmento. Purgue la caché después de añadir el script.

Recomendaciones de mejores prácticas: pruebe siempre en una ventana de incógnito limpia, deshabilite cualquier bloqueador de anuncios y verifique la solicitud de red en la pestaña Red de las herramientas de desarrollo.

Lista de verificación de verificación

Cuándo contactar al soporte técnico

Si el nombre del sitio no aparece junto al logotipo de SeaText en un plazo de diez minutos después de haber cumplido con la permanencia de 40 segundos en un dominio válido con el script cargándose correctamente, póngase en contacto con el soporte de SeaText. El retraso suele indicar un problema de instalación específico de la plataforma (por ejemplo, el renderizado del lado del servidor que elimina el script, el almacenamiento en caché de borde o un encabezado CSP que no puede modificar). Proporcione al equipo de soporte los registros de la consola, los detalles de la solicitud de red y la URL exacta que probó.

Limitaciones de la prueba de conexión

• El encabezado del panel de control solo confirma que el script ha contactado con el servidor una vez. No garantiza que cada variante de página o agente funcione correctamente.
• Múltiples dominios requieren cuentas separadas; un solo panel de control no mostrará múltiples sitios. Esto se indica en la fuente: "Cada cuenta de SEATEXT AI está vinculada a una única URL principal" (S1).
• Los dominios de desarrollo dinámicos (por ejemplo, las URL de vista previa de Vercel) pueden no conectarse de forma fiable porque SeaText no puede asociar el tráfico de forma estable con su cuenta.
• La prueba no verifica agentes de traducción, agentes de protección contra bots u otros módulos especializados. Estos requieren sus propias comprobaciones funcionales.
• El estado de la conexión puede verse retrasado por la latencia de la red o la propagación de la CDN, especialmente en sitios distribuidos globalmente.

Preguntas frecuentes

¿Puedo probar en localhost?

No. Las URL de desarrollo como localhost están restringidas por razones de seguridad. Utilice un dominio real o un dominio de prueba público.

¿Necesito reinstalar el script después de cambiar la URL principal en mi cuenta?

Sí. Cada cuenta está vinculada a una única URL principal. Si cambia el dominio, debe actualizar la fuente del script o crear una nueva cuenta para el nuevo dominio.

¿Cuánto tiempo tarda la conexión inicial?

Hasta cinco minutos después de una permanencia de 40 segundos. Si tarda más de diez minutos, trátelo como un fallo y solucione el problema.

¿La conexión persistirá en los subdominios?

Solo si el mismo script está instalado en cada subdominio y la URL principal en la cuenta coincide con el dominio raíz. Los subdominios en cuentas diferentes necesitan instalaciones separadas.

¿Puedo usar un gestor de etiquetas en lugar de editar el tema?

Sí, siempre que la etiqueta se dispare pronto (DOM Ready) y no esté bloqueada por CSP. Verifique en la consola que el script se carga sin errores.

¿Qué pasa si uso WP Engine?

Instale el plugin de WP Engine que permite la inyección de JavaScript personalizado, luego añada el fragmento de SeaText a través de ese plugin para que se cargue en cada página.

¿La prueba confirma que las traducciones funcionan?

No. La prueba de conexión solo demuestra que el script se comunica con el backend. Habilite el Agente de traducción de sitios web y visite una página en un idioma de destino para verificar las traducciones.