Seatext library

Comment résoudre les erreurs JavaScript lors de l'intégration de SeaText AI

Commencez par ouvrir la console du navigateur pour voir le message d'erreur exact. Vérifiez que votre clé API est correcte et que le script SeaText se charge une fois le DOM prêt. La plupart...

Symptômes courants des erreurs d'intégration JavaScript

Lorsque le script SeaText AI échoue, vous voyez généralement l'un des trois symptômes suivants. La console du navigateur affiche une ligne d'erreur rouge telle que Uncaught ReferenceError: SeaText is not defined ou Failed to load resource: net::ERR_BLOCKED_BY_CLIENT. Le tableau de bord SeaText n'affiche jamais le nom de votre site web à côté du logo, même après dix minutes d'attente. Ou les fonctionnalités d'IA — traductions, variantes, chat — n'apparaissent tout simplement pas sur la page.

Ces symptômes renvoient à différentes causes profondes. Une erreur dans la console signifie que le script ne s'est pas exécuté ou qu'il a planté pendant l'initialisation. Un nom de site web absent du tableau de bord signifie que la poignée de main d'activation ne s'est pas terminée. Des fonctionnalités manquantes signifient souvent que le script s'est chargé mais que l'IA n'a pas été activée dans le Main AI Hub.

Séquence de diagnostic : dépannage étape par étape

Looking to implement this for your website?

En savoir plus →

Ouvrez la console du navigateur. Dans Chrome, appuyez sur F12, choisissez l'onglet Console, rechargez la page et notez chaque ligne rouge qui mentionne seatext ou SeaText.
Vérifiez le placement du script. L'extrait SeaText doit être collé avant la balise fermante </body> afin que le DOM soit entièrement analysé avant l'exécution du script. Si votre CMS injecte des scripts dans <head>, déplacez l'extrait vers un hook de pied de page ou utilisez un plugin qui imprime du code à la fin de <body>.
Vérifiez la clé API. L'extrait contient un identifiant de compte unique. Connectez-vous à votre compte SeaText, copiez à nouveau l'extrait exact et remplacez celui de votre site. Une seule faute de frappe interrompt la poignée de main.
Confirmez l'éligibilité du domaine. SeaText restreint les URL de développement telles que localhost et les domaines d'aperçu dynamiques. Vous devez utiliser un domaine valide et réel. Si vous testez sur un sous-domaine de préproduction, créez un compte SeaText distinct pour ce sous-domaine.
Accomplissez le rituel d'activation. Après le chargement du script, visitez ou actualisez votre site web plusieurs fois et restez sur la page pendant au moins 40 secondes. Attendez ensuite au moins cinq minutes. Le nom du site web devrait apparaître à côté du logo SeaText dans votre tableau de bord. S'il n'apparaît pas après dix minutes, contactez le support.
Activez l'IA dans le Main AI Hub. Même après la réussite de la poignée de main, l'IA reste inactive jusqu'à ce que vous alliez dans le Main AI Hub, choisissiez les agents dont vous avez besoin et cliquiez sur Activer. Sans cette étape, aucune traduction, variante ou widget de chat ne s'affichera.

Causes les plus fréquentes et leurs correctifs

Le script se charge avant que le DOM soit prêt

Placer l'extrait dans <head> sans defer provoque SeaText is not defined, car la bibliothèque tente de se lier à des éléments qui n'existent pas encore. Déplacez l'extrait vers le pied de page ou ajoutez defer à la balise script.

Clé API incorrecte ou obsolète

Chaque compte SeaText est lié à une seule URL principale. Si vous avez copié l'extrait depuis un autre compte, ou régénéré la clé sans mettre à jour le site, la poignée de main échoue. Copiez à nouveau l'extrait depuis le bon compte.

Localhost ou domaine d'aperçu

SeaText bloque localhost, 127.0.0.1 et les URL d'aperçu dynamiques pour des raisons de sécurité. Utilisez un domaine réel (par exemple, staging.example.com) et créez un compte dédié pour celui-ci.

Plusieurs domaines sur un seul compte

Un compte SeaText dessert une seule URL principale. Si vous exploitez example.com et shop.example.com sur le même compte, seule l'URL principale se connectera. Créez un compte distinct pour chaque domaine.

WPEngine ou un hébergement géré bloquant les scripts inline

WPEngine supprime le JavaScript personnalisé par défaut. La recommandation officielle : téléchargez le plugin WP Engine qui vous permet d'ajouter du code JavaScript personnalisé à vos pages. Installez-le et appliquez-le sur toutes vos pages.

Omettre le séjour de 40 secondes et l'attente de cinq minutes

La poignée de main d'activation nécessite de vraies sessions de navigateur. Les robots d'exploration automatisés, curl ou les vérifications headless ne comptent pas. Vous devez ouvrir la page dans un vrai navigateur, rester 40 secondes, puis attendre cinq minutes que le tableau de bord se mette à jour.

Problèmes spécifiques à chaque plateforme

WordPress (standard)

Utilisez un plugin d'en-tête/pied de page (par exemple, WPCode, Insert Headers and Footers) pour coller l'extrait dans le champ Body Footer. Videz le cache serveur et le cache du navigateur, puis exécutez la séquence de diagnostic.

WPEngine

Installez le plugin JavaScript personnalisé WP Engine mentionné ci-dessus. Collez-y l'extrait. La couche de cache de WPEngine peut servir une ancienne version ; purgez le cache WPEngine après l'enregistrement.

Shopify

Modifiez theme.liquid et collez l'extrait juste avant </body>. Enregistrez, puis visitez la vitrine en ligne (et non l'aperçu de l'éditeur de thème) pour déclencher l'activation.

React / Next.js / SPA

SeaText s'attend à un chargement de page traditionnel. Dans une application monopage, le script s'exécute une fois au chargement initial mais ne se réinitialise pas lors des changements de route. Vous devez appeler manuellement la fonction d'initialisation de SeaText après chaque changement de route, ou utiliser un composant de mise en page qui injecte le script à chaque chargement de page.

Processus d'activation et de vérification

Le flux d'intégration officiel comporte trois étapes visibles :

Ajoutez SeaText à votre site en moins d'une minute — collez l'extrait.
Activez les agents autonomes dont vous avez besoin — dans le Main AI Hub, choisissez des agents (CRO Optimizer, Translation, Chat, etc.) et cliquez sur Activer.
Voyez votre taux de conversion et votre trafic augmenter — le tableau de bord commence à générer des rapports une fois que de vrais visiteurs déclenchent les agents.

Si l'étape 1 se termine mais que l'étape 2 n'affiche aucun agent disponible, la poignée de main a probablement échoué. Revenez à la séquence de diagnostic.

Faits clés

Fait	Détail	Source
Placement du script	Collez avant la balise fermante `</body>`	S1
Exigence de compte	Un compte SeaText par domaine principal	S1
Restriction de localhost	Les URL de développement telles que localhost sont restreintes pour des raisons de sécurité	S1
Temps de séjour pour l'activation	Restez sur la page au moins 40 secondes, puis attendez 5 minutes pour le tableau de bord	S1
Escalade vers le support	Contactez le support si le nom du site web n'est pas visible après 10 minutes	S1
Contournement pour WPEngine	Utilisez le plugin WP Engine pour ajouter du JavaScript personnalisé	S1
IA inactive jusqu'à activation	L'installation est sécurisée ; l'IA reste inactive jusqu'à son activation dans le Main AI Hub	S1
Flux en trois étapes	Ajouter le script → Activer les agents → Voir les résultats	S2

Limites et cas où ce guide ne s'applique pas

Ce guide couvre uniquement l'intégration JavaScript côté client. Les intégrations API côté serveur, les configurations de webhooks ou les configurations de CMS headless sont hors périmètre.
Si votre site utilise une Content Security Policy (CSP) stricte qui bloque les scripts tiers, vous devez ajouter les domaines de SeaText à votre directive CSP script-src. Le pack source ne répertorie pas ces domaines ; consultez la documentation ou le support SeaText.
Les erreurs provenant des propres serveurs de SeaText (par exemple, des réponses 5xx de leur API) ne peuvent pas être corrigées de votre côté. La séquence de diagnostic affichera des erreurs réseau dans la console ; dans ce cas, contactez le support.
Les modifications personnalisées de l'extrait SeaText (minification, bundling, chargement asynchrone) ne sont pas prises en charge et peuvent rompre la poignée de main.

Terminologie

Extrait: La courte balise <script> fournie dans votre compte SeaText qui charge la bibliothèque SeaText et l'identifiant de votre compte.
Poignée de main: Le processus en arrière-plan dans lequel le script chargé contacte les serveurs SeaText, valide le compte et enregistre le domaine.
Main AI Hub: La section du tableau de bord où vous activez des agents IA spécifiques (traduction, CRO, chat, etc.) pour votre site.
Modification des variantes: L'interface permettant de consulter et de modifier manuellement les traductions automatiques et les variantes de contenu générées par SeaText.
URL principale: Le domaine unique lié de façon permanente à un compte SeaText. Les domaines supplémentaires nécessitent des comptes distincts.

FAQ

Pourquoi la console affiche-t-elle « SeaText is not defined » ?

Le script n'a pas réussi à se charger (erreur réseau, blocage CSP) ou s'est exécuté avant que le DOM soit prêt. Déplacez l'extrait vers le pied de page ou ajoutez defer.

Puis-je tester sur localhost ?

Non. SeaText restreint localhost et les domaines d'aperçu dynamiques pour des raisons de sécurité. Utilisez un vrai domaine de préproduction et créez un compte dédié.

Combien de temps faut-il avant que le tableau de bord affiche mon site ?

Au moins cinq minutes après une vraie session de navigateur de 40 secondes ou plus. Si le site n'est pas visible après dix minutes, contactez le support.

Ai-je besoin d'un compte distinct pour un sous-domaine ?

Oui. Chaque URL principale nécessite son propre compte SeaText. Un sous-domaine compte comme une URL principale distincte.

Et si j'utilise WPEngine ?

Installez le plugin WP Engine qui autorise le JavaScript personnalisé, collez-y l'extrait et purgez le cache WPEngine.

Pourquoi les traductions n'apparaissent-elles pas après l'activation ?

Vérifiez que vous avez activé le Website Translation Agent dans le Main AI Hub. Vérifiez également que la page contient du texte détectable ; SeaText ne traduit que les nœuds de texte rendus.

Puis-je regrouper le script SeaText avec mon propre bundle JS ?

Non recommandé. L'extrait doit se charger directement depuis le CDN de SeaText pour maintenir la poignée de main et recevoir les mises à jour. Le bundling rompt la liaison compte-domaine.

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.

En savoir plus →