Seatext library

Comment déboguer le mode développement de SeaText sur Squarespace : un guide de diagnostic étape par étape

Le mode développement de SeaText sur Squarespace échoue lorsque le script ne peut pas se connecter à un domaine de production valide, lorsque la fenêtre d'activation de 40 secondes est manquée, ou lorsque le...

Liste de contrôle diagnostique immédiate

Avant de vous plonger dans les étapes détaillées, effectuez ces cinq vérifications dans l'ordre. Chacune élimine un mode de défaillance courant identifié par la documentation d'intégration SeaText Squarespace.

Ouvrez la console de développement du navigateur (F12 → Console) et recherchez toute erreur rouge faisant référence à seatext ou à l'URL du script. Une erreur 404 ou CORS signifie que l'URL du snippet est incorrecte ou bloquée.
Confirmez que le domaine est une URL réelle et enregistrée. SeaText restreint explicitement localhost, 127.0.0.1 et les domaines de développement dynamiques (par exemple, *.ngrok.io, les URL de prévisualisation *.vercel.app). Utilisez un domaine approprié comme staging.yourdomain.com ou une URL d'essai Squarespace intégrée *.squarespace.com.
Vérifiez que le script se trouve dans le point d'injection Header. Dans Squarespace, allez dans Paramètres → Outils de développement → Injection de code → Header. Le snippet JavaScript SeaText doit y être collé, pas dans Footer ou Page Header.
Visitez la page et restez au moins 40 secondes. La poignée de main d'activation nécessite une session active de cette durée. Fermer l'onglet trop tôt interrompt la liaison.
Attendez 5 à 10 minutes, puis vérifiez le tableau de bord SeaText. Le nom de votre site doit apparaître à côté du logo SeaText en haut de la page Configuration. S'il n'apparaît pas après 10 minutes, contactez le support SeaText.

Pourquoi le mode développement échoue sur Squarespace

SeaText associe chaque compte à une seule URL principale pour des raisons de sécurité et de facturation. Le guide d'intégration indique : « Chaque compte SEATEXT AI est lié à une seule URL principale. Restrictions et sécurité : les URL de développement, telles que localhost, sont restreintes pour des raisons de sécurité. Assurez-vous d'utiliser un domaine valide et réel dans ces cas. Les domaines de développement dynamiques peuvent ne pas fonctionner correctement, car SEATEXT AI pourrait ne pas être en mesure d'associer de manière fiable le trafic à votre compte. »

Looking to implement this for your website?

En savoir plus →

Cela signifie qu'un flux de travail de développement local typique (localhost, URL de tunnel, domaines de prévisualisation éphémères) ne fonctionnera pas. Vous devez provisionner un nom d'hôte réel qui résout vers votre site Squarespace — soit un sous-domaine personnalisé pointé vers Squarespace, soit le domaine d'essai natif Squarespace — avant que le script puisse s'authentifier et s'activer.

Séquence de débogage étape par étape

1. Confirmer le chargement du script dans l'onglet Réseau

Ouvrez DevTools → Réseau, filtrez par JS, rechargez la page. Vous devriez voir une requête vers le CDN SeaText (généralement cdn.seatext.com ou similaire) renvoyant 200 OK. Si la requête est absente, le snippet d'injection de code ne s'affiche pas. Si elle renvoie 403/404, l'URL du snippet est obsolète — régénérez-la depuis le tableau de bord SeaText.

2. Vérifier les messages d'initialisation dans la console

Après le chargement du script, la console doit enregistrer une ligne comme SeaText initialized for account XYZ ou similaire. L'absence de tout journal SeaText signifie que le script s'est exécuté mais n'a pas trouvé de configuration valide — généralement une incompatibilité de domaine.

3. Valider le domaine dans le tableau de bord SeaText

Connectez-vous à SeaText, allez dans Configuration. L'URL principale qui y est listée doit correspondre exactement au nom d'hôte que vous testez (y compris www vs non-www). Une incompatibilité empêche la poignée de main de 40 secondes de se terminer.

4. Exécuter le test d'activation de 40 secondes

Ouvrez la page en direct dans une fenêtre de navigation privée (pour éviter les interférences de cache/extensions). Lancez un minuteur. Restez sur la page, faites défiler occasionnellement, ne naviguez pas ailleurs. À 40 secondes, le script envoie le ping d'activation. Vous pouvez surveiller un POST vers /activate ou similaire dans l'onglet Réseau.

5. Observer la fenêtre de propagation de 5 à 10 minutes

Après un ping d'activation réussi, le backend SeaText provisionne le lien compte-site. Le guide d'intégration indique : « Attendez au moins cinq minutes jusqu'à ce que vous voyiez le nom de votre site Web affiché à côté du logo SEATEXT en haut de cette page… Si vous ne le voyez pas en haut de la page après 10 minutes, veuillez contacter notre équipe de support immédiatement. »

6. Vérifier l'activation de l'IA dans Configuration

Une fois le nom du site apparu, allez dans Main AI Hub → Configuration. Activez les agents IA souhaités (Traduction, CRO, SEO, etc.). La première série de traductions et variantes automatiques sera générée. Si la page Configuration affiche le site mais que les agents restent inactifs, vérifiez que le site est publié (pas en mode protégé par mot de passe d'essai Squarespace) et que le script est toujours présent dans l'injection Header.

Erreurs courantes et comment les éviter

Erreur	Symptôme	Correction
Utiliser `localhost` ou une URL de tunnel	Le script se charge mais ne s'active jamais ; la console n'affiche aucune erreur	Mapper un sous-domaine réel (par exemple, `dev.yourdomain.com`) vers le site Squarespace via DNS
Coller le snippet dans Footer au lieu de Header	Le script se charge après le rendu de la page ; le ping d'activation ne se déclenche jamais	Déplacer le snippet vers Paramètres → Outils de développement → Injection de code → Header
Quitter la page avant 40 secondes	Le tableau de bord n'affiche jamais le nom du site	Restez sur la page ≥ 40 s ; utilisez la navigation privée pour éviter les extensions de rechargement automatique
Tester sur un site d'essai protégé par mot de passe	Le script se charge mais les crawlers SeaText ne peuvent pas accéder au contenu	Publiez le site ou désactivez le mot de passe global dans les paramètres Squarespace
Plusieurs domaines sur un seul compte SeaText	Seul le premier domaine fonctionne ; les autres affichent « unauthorized »	Créez un compte SeaText séparé pour chaque domaine (selon le guide d'intégration)

Faits clés du guide d'intégration SeaText Squarespace

Fait	Détail	Source
Emplacement d'installation	Squarespace Paramètres → Outils de développement → Injection de code → Header	S1
Exigence d'activation	Visitez la page et restez ≥ 40 secondes	S1
Délai de propagation	5 à 10 minutes avant que le nom du site n'apparaisse dans le tableau de bord	S1
Restriction de domaine	localhost et les domaines de développement dynamiques sont bloqués ; vous devez utiliser un domaine réel valide	S1
Mappage compte-domaine	Un compte SeaText par URL principale ; plusieurs domaines nécessitent plusieurs comptes	S1
Escalade au support	Contactez le support si le nom du site n'est pas visible après 10 minutes	S1

Limites de ce parcours de débogage

S'applique uniquement à l'installation standard du snippet JavaScript SeaText sur Squarespace 7.1 via l'injection de code. La plateforme de développement personnalisée (Squarespace 7.0 basée sur Git) peut différer.
Ne couvre pas les frameworks de rendu côté serveur, Next.js sur Vercel, ou les implémentations Squarespace headless.
Suppose que vous avez un accès administrateur aux tableaux de bord Squarespace et SeaText.
Les blocages au niveau du réseau (pare-feu d'entreprise, bloqueurs de publicités, en-têtes CSP) sont en dehors de ce guide ; vérifiez l'onglet Réseau pour les requêtes bloquées.

Référence rapide de terminologie

Injection de code: Fonctionnalité Squarespace sous Paramètres → Outils de développement qui permet d'insérer des scripts dans Header ou Footer globalement.
URL principale
Poignée de main d'activation: La session côté client de 40 secondes qui signale au backend SeaText de lier le domaine au compte.
Fenêtre de propagation: Le temps de traitement backend de 5 à 10 minutes avant que le tableau de bord ne reflète le site connecté.
AI Hub / Configuration: Sections du tableau de bord SeaText où les agents (Traduction, CRO, SEO, etc.) sont activés par site.

Scénarios pratiques

Scénario A : Sous-domaine de staging sur le même compte

Vous voulez staging.example.com et example.com tous deux sur SeaText. Le guide d'intégration exige des comptes séparés. Créez un second compte SeaText pour le staging, installez son snippet unique sur le site Squarespace de staging (ou le même site avec mappage de domaine), et exécutez l'activation de 40 secondes sur l'URL de staging.

Scénario B : Transfert au client

Vous avez construit le site sur votre compte Squarespace, le client possédera le compte SeaText. Demandez au client de créer d'abord le compte SeaText, de vous donner le snippet, vous l'injectez, puis vous (ou le client) effectuez la visite de 40 secondes sur le domaine en direct. Le client voit alors le site dans son tableau de bord.

Scénario C : Domaine d'essai Squarespace

Utilisation de yourname.squarespace.com pour les tests. C'est un domaine réel valide. Assurez-vous que le site d'essai est publié (pas protégé par mot de passe), injectez le snippet, visitez pendant 40 secondes, attendez 10 minutes. Fonctionne de manière identique à un domaine personnalisé.

FAQ

Puis-je utiliser un TLD `.local` ou `.test` avec une entrée dans le fichier hosts ?

Non. SeaText valide le domaine par rapport au DNS public et au TLS. Les TLD réservés et les noms d'hôtes non publics sont traités comme des URL de développement et bloqués.

Que faire si le script se charge mais que la console affiche `SeaText: domain mismatch` ?

L'ID de compte intégré au snippet attend un nom d'hôte différent. Régénérez le snippet depuis le bon compte SeaText (celui dont l'URL principale correspond au nom d'hôte actuel) et remplacez le contenu de l'injection de code.

La visite de 40 secondes doit-elle provenir de l'IP du propriétaire du compte ?

Non. Toute session de navigateur sur l'URL en direct compte. Vous pouvez demander à un collègue ou utiliser un appareil mobile sur données cellulaires pour satisfaire le minuteur.

Pourquoi le tableau de bord affiche-t-il le nom du site mais les agents ne s'activent pas ?

Généralement parce que le site est encore protégé par mot de passe (mode d'essai Squarespace) ou que le script a été supprimé après l'activation. Republiez le site, confirmez que le snippet est toujours dans Header, puis réessayez l'activation des agents.

Puis-je déboguer sur un site Squarespace 7.0 Developer Platform ?

La méthode d'injection de code fonctionne sur 7.1. Pour 7.0 Developer Platform (basée sur Git), vous devez inclure le snippet dans vos fichiers de modèle et déployer via Git. Les règles de 40 secondes et de 5 à 10 minutes s'appliquent toujours.

Que faire si je dois tester plusieurs variantes sur le même domaine ?

Les tests A/B et multi-bras de SeaText s'exécutent dans un seul compte. Vous n'avez pas besoin de plusieurs comptes pour tester des variantes — uniquement pour des URL principales distinctes.

Étape de vérification : confirmation de bout en bout

Après avoir terminé la séquence, confirmez les trois feux verts :

L'onglet Réseau affiche le script SeaText 200 OK et le POST d'activation 200 OK.
Le tableau de bord SeaText affiche le nom de votre site à côté du logo.
Configuration → AI Hub vous permet d'activer/désactiver les agents et affiche le statut « Active ».

Si un feu est rouge, réexécutez la liste de contrôle à partir de l'étape 1. La plupart des échecs se résolvent à l'étape 2 (validité du domaine) ou à l'étape 4 (visite de 40 secondes).

Lectures complémentaires et sources de comparaison

Ces sources externes fournissent un contexte supplémentaire pour évaluer le sujet. Leur inclusion ne constitue pas une approbation.

En savoir plus

Visitez le site Web pour plus d'informations.

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.