Dépannage
L’assistant se charge de la même façon sur toutes les plateformes. Presque tous les problèmes d’installation retombent donc sur un petit nombre de causes. Parcourez cette liste dans l’ordre ; les points 1 et 3 couvrent la grande majorité des cas.
Tester d’abord sur une page de preview (recommandé)
La façon la plus rapide d’éviter la plupart des problèmes ci-dessous consiste à confirmer que l’assistant se rend et répond avant de le mettre sur votre site de production :
- Dans les réglages de l’assistant, allowlistez le domaine preview/build de votre plateforme (
*.webflow.io,*.myshopify.com, etc.), votre hostname de staging oulocalhost. - Ajoutez le snippet à cette page puis ouvrez-la. Posez quelques questions d’exemple, confirmez que les réponses sont ancrées dans votre contenu, et vérifiez que le launcher se rend.
- Quand tout vous paraît correct, ajoutez le snippet sur l’hôte de production et allowlistez-le aussi.
Les conversations sur une page preview comptent dans votre plan comme n’importe quel autre trafic. Un sandbox développeur non facturé, pour tester gratuitement, avec un jeton preview, même un assistant pas encore en ligne, est une fonctionnalité preview : si votre étape Installation affiche une carte Testez votre Assistant, elle est activée pour votre espace de travail. Voir Tester dans le bac à sable.
Le launcher n’apparaît pas
1. Votre domaine n’est pas allowlisté (cas le plus fréquent)
Le loader récupère la config de l’assistant avant de rendre quoi que ce soit. Si le hostname de la page n’est pas présent dans Domaines d’installation, la requête est rejetée (403) et aucun launcher n’apparaît.
Vérifiez d’abord le tableau de bord, aucune console nécessaire. L’étape Installation de votre assistant affiche une carte État de l’installation qui liste chaque hostname où le snippet s’est chargé, quelle que soit la plateforme. Un hostname bloqué y apparaît avec un bouton Autoriser en un clic, ce clic ajoute l’hôte exact affiché (les wildcards comme *.myshopify.com du tableau ci-dessous restent un ajout manuel dans Domaines d’installation).
Correction : ajoutez le hostname exact où le snippet s’exécute dans Domaines d’installation. Ajoutez aussi la version www. si vous l’utilisez. Les wildcards comme *.example.com sont pris en charge.
Ajoutez aussi le domaine build/preview de votre plateforme :
| Plateforme | Ajouter aussi |
|---|---|
| Shopify | *.myshopify.com |
| BigCommerce | *.mybigcommerce.com |
| Squarespace | *.squarespace.com |
| Webflow | *.webflow.io |
| Framer | *.framer.app |
| Carrd | *.carrd.co |
| Bubble | *.bubbleapps.io |
| Ghost | *.ghost.io |
| HubSpot | *.hs-sites.com |
| WordPress.com | *.wordpress.com, *.wpcomstaging.com |
| Wix | votre domaine personnalisé connecté |
| Drupal / Joomla | vos hostnames de prod et de staging |
2. La plateforme a supprimé les attributs du script
Certains CMS ou éditeurs sanitizent le markup et suppriment les attributs inconnus. Si la balise <script> est présente mais que data-olotalk-assistant-id a disparu dans le source HTML, c’est probablement votre problème.
Correction : utilisez la forme sans attribut data-* :
<script>
window.OlotalkConfig = { assistantId: 'YOUR_ASSISTANT_ID' };
</script>
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
async
></script>
Ou injectez le snippet via une méthode qui préserve le HTML brut : plugin headers-and-footers, Full HTML dans Drupal, ou vue code d’un éditeur.
3. Votre snippet est piégé dans une iframe
Si vous voyez une petite boîte vide inline dans le contenu, ou si le chat n’apparaît que dans une section, votre snippet est probablement dans un bloc Embed HTML ou équivalent. Ces éléments rendent dans une iframe ; un launcher flottant ne peut pas s’en échapper.
Correction : déplacez le snippet vers la fonctionnalité site-wide custom code / footer de la plateforme.
4. Vous regardez l’éditeur, pas le site publié
Webflow, Framer, Wix, Squarespace, Carrd et BigCommerce n’exécutent le custom code que sur le site publié, pas dans l’éditeur ou la preview interne. Publiez, puis ouvrez l’URL live.
Le launcher apparaît mais ne répond pas
- Vous obtenez un fallback du style “I don’t have that information yet.” Votre contenu n’a pas été ingéré. Ajoutez une URL sous l’étape Source et lancez l’ingestion ; voir le Démarrage rapide.
- Rien ne se passe quand vous envoyez un message, ou la console affiche des erreurs. Vérifiez votre CSP ci-dessous ainsi que la requête de config.
- Le champ de saisie est grisé et rien ne part. Une bannière de consentement est activée à l’étape Policy de votre assistant. Comme cette bannière bloque réellement la conversation au lieu de se contenter d’informer, aucune session n’est créée et aucun message n’est envoyé tant que le visiteur ne l’a pas acceptée : un consentement qui laisserait la conversation se poursuivre n’en serait pas un. Vous pouvez la désactiver dans Policy → Suivi du consentement, ou la conserver en sachant que le premier clic servira à l’accepter.
- Il répond dans la mauvaise langue. La langue est choisie par visiteur et bornée par l’ensemble des langues prises en charge par votre assistant, voir Multilingue pour la chaîne de priorité exacte et la façon d’en épingler une.
Content Security Policy (CSP)
Si votre site applique une CSP stricte, le navigateur peut bloquer le loader ou ses appels API. Autorisez les hôtes Olotalk :
script-src 'self' https://cdn.jsdelivr.net;
style-src 'self' https://cdn.jsdelivr.net;
connect-src 'self' https://api.olotalk.com https://cdn.jsdelivr.net;
Adaptez les hôtes si vous auto-hébergez le bundle assistant. Voir Référence d’intégration → Sécurité pour la politique complète.
Si vous utilisez la forme sans attributs (un <script> inline qui définit window.OlotalkConfig), une script-src stricte sans 'unsafe-inline' bloquera aussi ce script inline. Ajoutez un nonce CSP ou préférez le snippet basé sur les attributs.
Débugger en moins d’une minute
- Ouvrez DevTools → Network puis rechargez la page.
- Repérez la requête vers
…/public/v1/assistants/<your-assistant-id>/config:- 403 → votre domaine n’est pas allowlisté
- 429 → vous êtes rate-limité ; attendez puis réessayez
- 404 sur
loader.iife.js→ l’URLsrcdu snippet est fausse - aucune requête → le script n’a jamais tourné : il a été supprimé, bloqué par la CSP, ou le site n’est pas publié
- Vérifiez la Console pour d’éventuels warnings
Olotalk. - Récupérez le header de réponse
x-request-idet transmettez-le au support si nécessaire.
Confidentialité : ce que l’embed stocke et envoie
L’inventaire complet, pour la personne qui maintient votre politique de confidentialité et votre bandeau de consentement :
- Dans le navigateur du visiteur : deux clés
localStorage,olotalk_visitor_id(un identifiant visiteur anonyme) etolotalk:lang:<assistantId>(un choix de langue accepté par le visiteur). Aucun cookie publicitaire, aucun pixel tiers. - Sur le réseau : le loader envoie un beacon de vue de page (URL de la page, referrer, balises UTM) à son chargement, et les conversations partent vers l’API d’Olotalk pour être répondues. Rien n’est écrit dans la base de données de votre propre site.
Savoir si tout cela doit figurer dans votre bandeau de cookies est une question juridique qui dépend de votre juridiction, ces docs peuvent vous remettre l’inventaire, pas la réponse. Voir la Politique de confidentialité d’Olotalk ; et si vous chargez le snippet via un tag manager, le guide Google Tag Manager couvre le déclenchement derrière le consentement.
Retirer, mettre en pause ou déplacer l’assistant
- Retirer : supprimez le snippet (ou désactivez le plugin). Rien d’autre ne vit sur votre site ; les deux clés
localStorageci-dessus sont des restes inertes sans le script. - Mettre en pause : mettez l’assistant hors ligne dans le dashboard, le snippet peut rester en place, l’assistant cesse simplement de se rendre (le loader explique pourquoi dans la console du navigateur).
- Déplacer vers un nouveau domaine : ajoutez le nouveau domaine dans les Domaines d’installation, collez-y le snippet, puis retirez l’ancien quand vous êtes prêt. L’assistant, son contenu et son historique de conversations restent intacts, la carte État de l’installation affichera le nouveau domaine dès son premier chargement.
- Assistant archivé ou supprimé : un embed resté en place ne rend rien et journalise « no longer available, remove this embed snippet ».
Toujours bloqué ?
Contactez le support avec votre assistant ID, la plateforme concernée et le x-request-id de la requête qui échoue. Avant cela, revérifiez surtout les points 1 (allowlist du domaine) et 3 (iframe).